DBOC: Controlling Local Resources with Operational Commands › TRACE= Using the Trace Facility

TRACE= Using the Trace Facility

The CA Datacom/DB Trace Facility enables you to monitor all or selected events in your CICS CA Datacom environment. The same type of information you can view by issuing a DBOC/DBIC TASK transaction (see TASK: Displaying Active Tasks) is collected on the CA Datacom/DB Trace Table. The difference is that the former displays only the tasks active at the moment you request the report. The Trace Facility provides history data for the last 100 events. (The number of events for which data is maintained in the CA Datacom/DB Trace Table, can be modified in the TRACE= parameter of the DBCVTPR macro. For more information, see the System Reference Guide.)

The procedure for using the Trace Facility includes the following steps:

1. Display list of current trace criteria.

   Use either a DBIC or a DBOC transaction as described in TRACE: Displaying Trace Criteria List.

2. Establish or revise the trace criteria as described in Adding/Deleting Trace Criteria.
3. Establish the trace list relationships with Boolean qualifiers AND or OR as described in Establishing Trace Criteria Relationship.
4. If the CA Datacom/DB Trace Facility is not automatically started at CA Datacom CICS Services startup, turn it on as described in Initiating/Terminating the Trace Facility (TRACEON/TRACEOFF).
5. Display the Trace Table.

   Use either a DBIC or a DBOC transaction as described in INQ=TRACE: Displaying the Trace Table.

6. Turn the Trace Facility off as described on Initiating/Terminating the Trace Facility (TRACEON/TRACEOFF).