ISCO gate, RELEASE_CONNECTION function

Rejects new work for the named IPCONN.

Input Parameters

DRAIN
Optional Parameter
Values for the parameter are:
YES
When YES, CICS performs the following actions:
  • Notifies the partner to do likewise.
  • Waits for work in progress, and queued work, to complete but will not allow new work to the partner to be initiated. Work for which an allocate_send has completed or is queued is allowed to complete but new allocate requests are rejected.
NO

When NO, queued work is cancelled and the partner is only notified when it attempts to send new work to this IPCONN.

When all work associated with the server is complete, the server web session is closed. A web session is provided to the IS domain, by the WB domain, when a socket is opened or closed for an IPIC connection.

The client is normally closed by the partner by passing a session_closed notification.

Once both client and server are released, the IPCONN is released.

For JCA, where there is no server session with which to notify the partner of the need to drain, incoming new work is rejected and, once the last work in progress (as indicated by the presence of an active receive session) is complete, the client session is closed.

IPCONN
Optional Parameter
The name of the IPCONN definition; that is, the name by which CICS knows the remote system.

If neither IPCONN nor TCPIPSERVICE is specified, all IPCONNs are released.

TCPIPSERVICE
Optional Parameter
The name of the PROTOCOL(IPIC) TCPIPSERVICE definition that defines the attributes of the inbound processing for this connection.

If specified, any IPCONNs referencing the given TCPIPSERVICE are released.

If neither IPCONN nor TCPIPSERVICE is specified, all IPCONNs are released.

Output Parameters

REASON
The values for the parameter are:
  • INVALID_FORMAT
  • INVALID_FUNCTION
  • INVALID_IPCONN_STATE
  • IPCONN_NOT_FOUND
  • NO_IPCONN
  • TCPIPSERVICE_NOT_FOUND
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_ISCOrelease_connection.html | Timestamp icon Last updated: Monday, 5 June 2017