Help

 

DFHTRP

DFHTRP is a trace control program designed as a debugging aid.

The trace program maintains an in-storage trace table whose entries identify different types of system activity. You can also maintain time-stamped trace entries on an auxiliary data set.

The CICS auxiliary trace lets you write trace records on a sequential device for later analysis.

Hints

CEMT SET TRACE ON and TRACE OFF are CICS transactions that control the entire CICS trace facility. The system or internal trace must be on before any trace entries are recorded. If the auxiliary trace facility is active, all trace entries written to the trace table will also be written to the auxiliary trace data sets. Auxiliary trace data collection will increase the region's processor usage by as much as 20 percent.

For CICS/ESA, the SIT auxiliary trace parameter is AUXTRSW=NO/ALL/NEXT. This controls the auxiliary trace data set autoswitch facility. Because CICS/ESA domains force the collection of trace upon failure detection, you can save processor overhead by turning internal trace off and auxiliary trace collection on with AUXTRSW=ALL. The INTTR=ON/OFF parameter turns internal CICS trace on or off.

You can use the following CEMT commands to inquire upon, start, or stop an auxiliary internal, or generalized CICS trace.

CEMT INQ AUXTRACE

determines if an auxiliary trace is in progress

determines if an auxiliary trace data set is open or closed

identifies which auxiliary trace data set is currently active

CEMT SET AUXTRACE (START/STOP)

  • temporarily starts or stops an auxiliary trace

CEMT INQ INTTRACE

  • determines if an internal trace is in progress

CEMT SET INTTRACE (START/STOP)

  • starts or stops an internal trace

CEMT INQ GTFTRACE

  • determines if a generalized tracing facility (GTF) is in progress

CEMT SET GTFTRACE (START/STOP)

  • starts or stops a GTF trace

Reference Sources

CICS Transaction Server for z/OS Diagnosis Reference

CICS Transaction Server for z/OS Application Programmer's Reference

CICS Transaction Server for z/OS CICS-Supplied Transactions

Datapro Directory of Software, McGraw-Hill, Inc., Volume 1, October 1991

CICS Tuning and Performance, Xephon Report, I. Gelb, August 1991