Analyzing performance in OTMA message routing

You can use the OTMA type-2 command, QUERY OTMATI, to analyze performance in OTMA message routing.

You can issue the QUERY OTMATI command in active and alternate systems in an Extended Recovery Facility (XRF) environment.

If you issue the command QUERY OTMATI without any parameters, IMS displays:

• The workloads on each of the IMS instances in the IMSplex with the target member (tmember) name and the transaction pipe (tpipe) name
• The total number of active messages in the queue as a subset of the total workload
• The length of time that the transaction instance block (TIB) has existed and the correlation ID of the input message

You can use this information to determine if there are problems processing OTMA input messages.

If you include the SHOW parameter with the QUERY OTMATI command, the total number of active messages in the queue is not displayed. Instead, each individual active message is displayed, as filtered by the other specific parameters. For example, to show how many transaction codes have an age of five seconds or more, issue the following command:

QUERY OTMATI MSGAG(5) SHOW(TRAN)

This command displays the individual TIBs, and shows how many transaction codes have an age of five seconds or more. From this information, you can determine any potential problems in the message queue that can be corrected or avoided, such as storage filling with control blocks, or you can balance the workload of the outbound transactions in the IMSplex without restarting IMS.