Stopping a connection to a remote IMS Connect instance for IMS-to-IMS TCP/IP communications

You can stop an IMS-to-IMS TCP/IP connection to a remote IMS Connect instance by issuing an IMS Connect command from the local IMS Connect.

Depending on whether the connection is used for Multiple Systems Coupling (MSC) or Open Transaction Manager (OTMA), the implications of stopping an IMS-to-IMS TCP/IP connection to a remote IMS Connect instance are different.

To stop an IMS-to-IMS TCP/IP connection to a remote IMS Connect instance:

Procedure

Issue any one of the following IMS Connect commands to the local IMS Connect instance:
  • In the IMS type-2 format, UPDATE IMSCON TYPE(RMTIMSCON) NAME(rmtimscon_name) STOP(COMM)
  • In the WTOR format, STOPRMT
  • In the z/OS® MODIFY format, UPDATE RMTIMSCON STOP(COMM)
IMS Connect issues message HWST3505I after the connection is terminated.
If you are stopping a connection to a remote IMS Connect instance that is used for MSC, the following actions occur when the connection is stopped:
  • The local IMS Connect issues an informational message to the console and notifies MSC that the connection was stopped.
  • IMS stops the MSC logical links that use the IMS-to-IMS TCP/IP connection.
  • The local IMS Connect disconnects the TCP/IP sockets associated with the IMS-to-IMS TCP/IP connection.
  • If the local IMS Connect receives any messages from MSC for the stopped connection, IMS Connect rejects the message and returns an error message to MSC.
If you are stopping a connection to a remote IMS Connect instance that is used for OTMA, the following actions occur when the connection is stopped:
  • The local IMS Connect disconnects the TCP/IP sockets associated with the IMS-to-IMS TCP/IP connection.
  • If an acknowledgement (ACK) response is pending on any socket that uses the connection, the local IMS Connect returns a negative acknowledgement (NAK) to OTMA in the local IMS system. IMS Connect issues message HWST3570E.
  • If the local IMS Connect receives any OTMA messages from the local IMS system for the stopped connection, IMS Connect returns a NAK to OTMA with sense code 002A/0008 and issues message HWST3575W. OTMA leaves the message at the front of the output queue.