Stopping IMS Connect send client sockets on IMS-to-IMS TCP/IP connections
You can stop IMS Connect send client socket connections on an IMS-to-IMS TCP/IP connection in a local IMS Connect by issuing an IMS Connect command, such as the WTOR format command STOPSCLN.
Usually, the STOPSCLN command and the equivalent IMS type-2 and z/OS® MODIFY commands are used only to stop send client socket connections that are used for IMS Open Transaction Manager Access (OTMA).
Recommendation: Do not stop IMS Connect send client socket connections if
they are used for Multiple Systems Coupling (MSC). If you need to
clean up sockets that are used for MSC, use the STOPLINK command or
the equivalent IMS type-2 and z/OS MODIFY command.
In IMS Connect, the send client socket connection is represented by a client ID that is automatically generated by IMS Connect when the socket connection is established.
When you stop a send client socket
that is connected but idle, as indicated by a CONN status in IMS Connect, the following actions
occur:
- IMS Connect disconnects the send client socket and cleans up the associated control blocks.
- IMS Connect notifies the remote IMS Connect and the remote IMS Connect disconnects the related socket and cleans up its control blocks.
When you stop a send client that is waiting for an acknowledgement
from the remote IMS Connect,
as indicated by a RECV status in IMS Connect,
the following actions occur:
- IMS Connect disconnects the send client socket and cleans up the associated control blocks.
- IMS Connect issues a negative acknowledgement (NAK) to OTMA that direct OTMA to reroute unacknowledged message to the IMS Connect dead letter queue HWS$DLQ.
- IMS Connect issues message HWST3570E to the console.
- When the remote IMS Connect attempts to return the acknowledgement, the remote IMS Connect receives a socket error and disconnects the related socket and cleans up its control blocks.
To stop an IMS Connect send client socket of an IMS-to-IMS TCP/IP connection:
Procedure
Issue any one of the following IMS Connect
commands in the local IMS Connect
instance:
- In the IMS type-2 format, UPDATE IMSCON TYPE(SENDCLNT) NAME(sendclient_name) RMTIMSCON(rmtimscon_name) STOP(COMM)
- In the WTOR format, STOPSCLN
- In the z/OS MODIFY format, DELETE RMTIMSCON NAME (rmtimscon) SENDCLNT(clientid)