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


dfhs3_ISCOacquire_connection.html | Timestamp icon Last updated: Monday, 5 June 2017