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.
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 IBM® IMS Connect Extensions for z/OS® User's Guide.
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.