OTMA transaction pipe cleanup enhancement

In IMS 15, the OTMA transaction pipe (tpipe) cleanup enhancement improves the ability of an IMS system to delete idle OTMA tpipes.

This enhancement is added to IMS 15 by APAR PI88409 (PTFs UI54736 and UI54735).

In previous releases, an OTMA tpipe was deleted after it had been idle across three consecutive system checkpoints only if all other tpipes associated with the same OTMA target member (tmember) were idle. Therefore, IMS storage space was being used unnecessarily for OTMA tpipes that had been idle for a long time, leading to storage exhaustion. Also, the OTMA tpipes that had already been idle for three consecutive system checkpoints could not be reused for subsequent transaction requests.

With the OTMA tpipe cleanup enhancement, an OTMA tpipe is deleted after it has been idle across three consecutive system checkpoints, even if other tpipes associated with the same tmember are being used. Consequently, idle OTMA tpipes are made available more quickly to process subsequent transactions on the IMS message queue, and IMS storage space is less likely to become flooded.

Changes to administering IMS

IMS automated operator interface (AOI) exits can use message DFS5386I, which is new with this enhancement, to identify whether an OTMA tmember has disconnected from OTMA.

Changes to troubleshooting for IMS

For a list of the messages and codes that are new or changed for this enhancement, see the IMS messages and codes row in the table in OTMA transaction pipe cleanup enhancement.

For a complete list of all of the new, changed, and deleted messages, and abend codes in IMS 15, see Message and code changes in IMS 15.

Changes to commands

The /DISPLAY TMEMBER command is enhanced to add the following status terms. One of the status terms can be displayed if the TPIPE keyword is specified on the command:

MCP: In a shared-queues environment, the tpipe has output messages on the global queue.
SYW: The tpipe is being scanned by IMS.

If a tpipe is in either of the preceding states, the tpipe cannot be deleted.

For a list of the commands that are new or changed for this enhancement see the IMS commands row in the table in OTMA transaction pipe cleanup enhancement.

Documentation changes

The following table lists the publications that contain new or changed topics for the OTMA transaction pipe cleanup enhancement. Publications that are not impacted by this enhancement are not included in the table.

Table 1. Links to topics that have new or changed content for this enhancement
Publication	Links to topics
Release planning	General planning information for IMS 15 Command changes in IMS 15 New messages and codes for IMS 15 IMS 15 enhancements IMS 15 Transaction Manager continuous delivery functions Command changes in IMS 15 OTMA transaction pipe cleanup enhancement (new) (this topic)
Communications and connections	Introduction to OTMA Using transaction pipes with OTMA Enabling and using OTMA Managing system resources and OTMA Monitoring tpipe usage Removing idle tpipes
IMS messages and codes	New messages and codes for IMS 15 DFS messages DFS5386I (new)
IMS commands	IMS commands /DISPLAY TMEMBER command