Previous Topic: Additional Monitoring and Debugging ToolsNext Topic: Logging (LXX) Considerations and Differences

Additional Monitoring and Debugging Tools › Auxiliary Trace Facility

Auxiliary Trace Facility

Auxiliary Trace Facility

The CA Datacom 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 is collected in the CA Datacom/DB Trace Table. The DBOC/DBIC TASK transaction only displays the task or tasks that are active at the moment you request the report.

The Trace Facility provides history data for the last specified number of events. The number of events for which the data is maintained in the CA Datacom/DB Trace Table can be modified in the TRACE= parameter of the DBCVTPR macro.

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

  1. Display the current system generation options for the trace parameters using either a DBIC or DBOC transaction to check the AUXTRACE= and the TRACE= parameters of the DBCVTPR macro. See INQ=GENOPTS: Displaying System Generation Options, and see the DBCVTPR in the CA Datacom CICS Services System Reference Guide.
  2. See the sample installation JCL in the CA Datacom CICS Services Installation Guide. If the CA Datacom/DB Trace Facility was not set up at CA Datacom CICS Services installation, see the information about allocating DBOC Log Areas and Auxiliary Trace Data Sets in the CA Datacom CICS Services Installation Guide.
  3. Display a list of the current trace criteria using either a DBIC or DBOC transaction. See TRACE: Displaying Trace Criteria List.
  4. Establish or revise the trace criteria. See Adding/Deleting Trace Criteria.
  5. Establish the trace list relationships with AND/OR Boolean qualifiers. See Establishing Trace Criteria Relationship.
  6. If the Trace Facility is not automatically started at CA Datacom CICS Services startup, turn it on. See Initiating/Terminating the Trace Facility (TRACEON/TRACEOFF).
  7. Display the Trace Table using either a DBIC or a DBOC transaction. See INQ=TRACE: Displaying the Trace Table.
  8. Turn the Trace Facility off. See Initiating/Terminating the Trace Facility (TRACEON/TRACEOFF).
  9. Print the Trace Table. See the information about using the AUXTRACE Utility in the System Reference Guide.