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