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

Additional Monitoring and Debugging Tools › 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 in the User Guide, and the DBCVTPR in the System Reference Guide.
  2. See the sample installation JCL in the Installation Guide for z/OS. 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 Installation Guide for z/OS.
  3. Display a list of the current trace criteria using either a DBIC or DBOC transaction. See TRACE: Displaying Trace Criteria List in the User Guide.
  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.
  7. Display the Trace Table using either a DBIC or a DBOC transaction.
  8. Turn the Trace Facility off.
  9. Print the Trace Table. See the information about using the AUXTRACE Utility in the System Reference Guide.