Use the Start Conditional Trace and Stop Conditional
Trace context menu options in the Status Monitor of the Operations Console to start and stop tracing of an IMS™ Connect system based on filtering criteria.
About this task
Tracing records are written to the Active Journal data set and then, if archiving is enabled,
archived to the Archive Journals. For a list of the IMS Connect
trace records, see
"Event records recorded by IMS Connect
Extensions" in the IMS Connect Extensions for z/OS® User's Guide.
Procedure
To specify filtering options and start the trace:
- Right-click on the IMS Connect system and select Start Conditional Trace
from the context menu.
- Select from the following conditional tracing options:
Figure 1. Conditional trace options in IMS Connect
Extensions
Operations Console for z/OS Explorer
- Reactivate Tracing after System Restart
- Select this option to make tracing persist across system restarts.
Note: You can only
make a trace persistent at the same time as you activate it.
- Level
- Set the level of tracing for IMS Connect
Extensions:
- 1
- IRM, CSM, RSM, OTMA, XML, and DRDA® structures.
- 2
- IRM, CSM, RSM, OTMA, XML, DRDA structures, and client
application data.
- Port
- Apply tracing only to a specific port. Only activities directed at that port are traced. Use an
asterisk (*) to trace on all ports, or LOCAL for a local port.
- Filter Criterion (for OTMA workloads)
- IMS Connect
Extensions will only record messages that match the
specified tracing filter. Specify an optional filter (one only) using the following fields:
- Client name
- The name of the client.
- Transaction
- The transaction.
- Message exit
- The message exit.
- User ID
- The user ID.
- LTERM
- The logical terminal.
- IP address
- The host IP address. If you enter a DNS name it will be sent to the server to
be resolved to the IP address.
- Click Start Trace.
To stop conditional tracing:
- Right-click on the IMS Connect system and select Stop Conditional Trace
from the context menu.