Cleaning up MSC logical link resources in IMS Connect

If an MSC logical link has terminated in IMS, but the IMS Connect resources associated with the logical link did not clean up automatically, you can clean up the resources by using an IMS Connect command, such as the WTOR format command STOPLINK.

Recommendation: Under normal circumstances, use the IMS command /PSTOP to terminate MSC logical links. Stop MSC links in IMS Connect only when the IMS Connect resources associated with an MSC logical link that has already terminated have failed to clean up correctly.

A logical link on one MSC physical link can have the same name as a logical link on another physical link. To ensure that a logical link with a duplicate name is not stopped on another physical link, include the ID of the physical link that the logical link is assigned to on the command when you stop a logical link. The ID of the physical link can be found on the on the LCLPLKID parameter of the MSC configuration statement.

When you clean up MSC logical links in a local IMS Connect instance by using a command like STOPLINK, IMS Connect takes the following actions:
  • Stops any communication on the MSC logical link
  • Notifies the local IMS that communication has stopped on the logical link
  • Deletes the control blocks associated with the logical link and frees the associated storage
  • Issues message HWSF3310I
To stop an MSC logical link and clean up its associated resources in a local instance of IMS Connect issue any one of the following IMS Connect commands in the local IMS Connect instance:
  • In the IMS type-2 format, UPDATE IMSCON TYPE(LINK) NAME(linkname) MSC(lclplk_id) STOP(COMM)
  • In the WTOR format, STOPLINK linkname lclPlkid
  • In the z/OS® MODIFY format, DELETE LINK NAME (linkname) LCLPLKID(lclPlkid)
IMS Connect issues message HWS3310I after the link is stopped.