OTMA diagnostic aids

OTMA diagnostic aids include OTMA trace, module-to-code cross references, verb-to-code cross references, DFS1296E message information, log records, and SNAPs and dumps.

OTMA trace
The OTMA trace records the flow of control through IMS OTMA. Turn on the OTMA trace only if the IBM® support representative requests it.
OTMA trace entries for parallel RESUME TPIPE request processing (X'5A20')
OTMA trace entries for parallel RESUME TPIPE request processing have the trace ID X'5A20' in byte 0 and 1 of word 0.
OTMA trace entry for user exits
Trace IDs and their words are listed for the user exits.
OTMA trace entry for synchronous callout
OTMA trace entries for synchronous callout have the trace ID X'5A04'.
OTMA trace entry for synchronous program switch
OTMA trace entries for synchronous program switch have the trace ID X'5A0B'.
OTMA module-to-code cross-reference table
The OTMA module-to-code cross-reference table consists of module numbers, module name, and a description. You can use this information to associate code xx in message DFS1269E and the module number in trace records X'5A'xx, X'5B'xx and X'5C'xx with a module.
OTMA verb-to-code cross-reference table
The OTMA verb-to-code cross-reference table consists of verb numbers, verb name, and a description. You can use this information to associate the z/OS® cross-system coupling facility call number in trace record X'5B' xx with a z/OS XCF verb.
DFS1269E message information
OTMA issues message DFS1269E when a severe internal error occurs. If you receive this message, contact the IBM Support Center with the module number and reason code supplied in the message, and, if requested, output from the OTMA trace.
OTMA log records
To activate OTMA logging, use one of the /TRA SET ON commands.
SNAPs and dumps
For errors that do not result in an abend, IMS writes log record X'67D0', or produces an SDUMP, depending on the error. The minimum data dumped for OTMA problems are the control blocks that are associated with the task in error and the appropriate trace tables.

Parent topic: Data communication service aids