OpenTP1 Version 7 Programming Reference C Language
dc_rap_connect - Establish a connection with a RAP-processing listener
Format
ANSI C, C++
#include <dcrap.h> int dc_rap_connect(char *target_host, DCLONG target_port, DCRAP_SV_ID *sv_id, DCLONG rflags) |
K&R C
#include <dcrap.h> int dc_rap_connect(target_host, target_port, sv_id, rflags) char *target_host; DCLONG target_port; DCRAP_SV_ID *sv_id; DCLONG rflags; |
Description
The function dc_rap_connect establishes a connection between a RAP-processing listener and a RAP-processing client.
The RAP-processing listener with which a connection is to be established is the RAP-processing listener that was activated at target_port on target_host.
Arguments whose values are set in the UAP
target_host ((1 to 255 alphanumeric characters, periods, or hyphens))
Specify the host name of the OpenTP1 node on which the RAP-processing listener was activated.
target_port <unsigned integer> ((1 to 65535))
Specify the port number of the well-known port being used by the RAP-processing listener.
rflags
Specify DCNOFLAGS.
Arguments whose values are returned from OpenTP1
sv_id
A service ID is returned when the function dc_rap_connect terminates normally or DCRAPER_ALREADY_CONNECT is returned.
Return values
Return value | Return value (numeric) | Explanation |
---|---|---|
DC_OK | 0 | Normal termination. A connection was established with the RAP-processing listener. |
DCRAPER_PARAM | -5501 | The value specified for the argument is invalid. |
DCRAPER_PROTO | -5502 | The protocol is invalid. A possible cause is as follows:
|
DCRAPER_NOMEMORY | -5503 | The memory became insufficient. |
DCRAPER_MAX_CONNECTION | -5517 | The specified value exceeds the maximum number of dc_rap_connect functions which can be called from a single process. |
DCRAPER_NETDOWN | -5505 | A network error occurred during communication with the RAP-processing listener. |
DCRAPER_TIMEDOUT | -5506 | A timeout occurred during communication with the RAP-processing listener. |
DCRAPER_NOSOCKET | -5507 | The number of sockets became insufficient. |
DCRAPER_NOHOSTNAME | -5508 | The host name cannot be resolved. |
DCRAPER_SHUTDOWN | -5521 | The RAP-processing listener is being terminated. |
DCRAPER_NOCONTINUE | -5522 | An error which prevents continuation of processing occurred. Possible causes of the error are as follows:
|
DCRAPER_SYSCALL | -5523 | An unexpected error occurred during system call. |
DCRAPER_UNKNOWN_NODE | -5531 | An attempt was made to establish a connection with a RAP-processing listener which is on an unconnected network. |
DCRAPER_NOMEMORY_SV | -5520 | The memory became insufficient on the RAP-processing listener or RAP-processing server. |
DCRAPER_TIMEOUT_SV | -5532 | A connection could not be established within the message exchange monitoring time specified in the rap_watch_time operand of the RAP-processing listener service definition. |
DCRAPER_PANIC_SV | -5533 | A system error occurred in the RAP-processing listener. |
DCRAPER_MAX_CONNECTION_SV | -5534 | The specified value exceeds the maximum number of requests which can be accepted for connection with a RAP-processing client that is managed by a RAP-processing listener. |
DCRAPER_NOSERVICE | -5528 | The RAP-processing listener is being started or terminated. |
DCRAPER_ALREADY_CONNECT | -5529 | A connection has already been established with the RAP-processing listener. |
Note
If the function dc_rap_connect returns with an error (returns with a value other than DCRAPER_ALREADY_CONNECT), connection was not established with the RAP-processing listener.
The error code acquired by the UAP trace is as follows:
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.