OpenTP1 Version 7 Programming Reference COBOL Language
CBLDCRAP('CONNECTX') - Establish connection with a RAP-processing listener
Format
PROCEDURE DIVISION specification
CALL 'CBLDCRAP' USING unique-name-1 unique-name-2 |
DATA DIVISION specification
01 unique-name-1. 02 data-name-A PIC X(8) VALUE 'CONNECTX'. 02 data-name-B PIC X(5). 02 FILLER PIC X(3). 02 data-name-C PIC S9(9) COMP VALUE 1. 02 data-name-D PIC S9(9) COMP. 01 unique-name-2. 02 data-name-E PIC S9(9) COMP. 02 data-name-F PIC X(n). 02 FILLER PIC X(1) VALUE LOW-VALUE. |
Description
CBLDCRAP('CONNECTX') establishes a connection between a RAP-processing listener and a RAP-processing client. The host name area is a variable-length area. It can accommodate a host name longer than 65 characters.
Data areas whose values are set in the UAP
data-name-A
Specify VALUE 'CONNECTX' for the request code indicating the request for establishment of a connection with a RAP-processing listener.
data-name-C
Specify 1.
data-name-E
Specify the port number of the well-known port being used by the RAP-processing listener.
data-name-F
Specify the host name of the OpenTP1 node on which the RAP-processing listener was activated. The specified host name must consist of 1 to 255 characters.
Data areas whose values are returned from OpenTP1
data-name-B
A status code of 5 digits is returned.
data-name-D
This area receives the service ID.
A service ID is returned when a connection with the RAP-processing listener was established successfully. Use the same service ID in CBLDCRAP('DISCNCT ') when releasing the connection.
Status codes
Status code | Explanation |
---|---|
00000 | Normal termination. A connection was established with the RAP-processing listener. |
05501 | The value specified for a data area is invalid or a required data area is not specified. Review the following values:
|
05502 | The protocol is invalid. Possible causes are as follows:
|
05503 | The memory became insufficient. |
05505 | A network error occurred during communication with the RAP-processing listener. |
05506 | A timeout occurred during communication with the RAP-processing listener. |
05507 | The number of sockets became insufficient. |
05508 | The host name cannot be resolved. Verify data-name-F or the DNS server. |
05517 | The maximum number of CBLDCRAP('CONNECTX') calls from a single process was exceeded. |
05520 | The memory became insufficient on the RAP-processing listener or RAP-processing server. |
05521 | The RAP-processing listener is being terminated. Alternatively, verify data-name-E. |
05522 | An error which prevents continuation of processing occurred. Possible causes of the error are as follows:
|
05523 | An unexpected error occurred during system call. |
05528 | The RAP-processing listener is being started or terminated. |
05529 | A connection has already been established with the RAP-processing listener. |
05531 | An attempt was made to establish a connection with a RAP-processing listener which is on an unconnected network. |
05532 | 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. |
05533 | A system error occurred in the RAP-processing listener. |
05534 | 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. |
Note
If CBLDCRAP('CONNECTX') returns with an error and the status code is a value other than 05529, 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.