ISCO gate, ACQUIRE_CONNECTION function
Acquire a connection to the partner CICS system named in the IPCONN parameter. The IPCONN must be INS, REL before this function is called. It opens a web session, sends a capability exchange to the partner, and waits for a response before setting the IPCONN connection status to ACQUIRED. A web session is provided to the IS domain, by the WB domain, when a socket is opened or closed for an IPIC connection.
Input Parameters
- IPCONN
- Optional Parameter
- The name of the IPCONN definition; that is, the name by which CICS knows the remote system.
- TCPIPSERVICE
- Optional Parameter
- The name of the PROTOCOL(IPIC) TCPIPSERVICE definition that defines the attributes of the inbound processing for this connection.
Output Parameters
- REASON
- The values for the parameter are:
- INVALID_FORMAT
- INVALID_FUNCTION
- INVALID_IPCONN_STATE
- IPCONN_NOT_FOUND
- ISCER_BAD_RESPONSE
- ISCER_ERROR
- ISCER_HTTP_ERROR
- ISCER_TIMED_OUT
- NO_IPCONN
- SESSION_OPEN_FAILED
- SHUTDOWN
- TCPIP_CLOSED
- TCPIPSERVICE_NOT_FOUND
- TCPIPSERVICE_NOT_OPEN
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- Values for the parameter are:
- OK
- EXCEPTION
- DISASTER
- INVALID
- KERNERROR
- PURGED