Using conditional trace

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 Events recorded by IMS Connect Extensions .

To specify filtering options and start the trace:

  1. Right-click on the IMS Connect system and select Start Conditional Trace from the context menu.
  2. Select from the following conditional tracing options:
    Figure 1. Conditional trace options in IMS Connect Extensions Operations Console for z/OS® Explorer
    IMS Connect Extensions conditional tracing options include Reactivate Tracing after System Restart, trace level, and filtering criteria
    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.
  3. Click Start Trace.

To stop conditional tracing:

  1. Right-click on the IMS Connect system and select Stop Conditional Trace from the context menu.