When GTF trace is on, and the CICS® main
trace flag is also on, CICS writes trace entries to a GTF data set.
About this task
CICS writes these records by issuing the GTRACE macro with
the following parameters specified:
- FID=X‘EF’
- The format identifier (FID) of the CICS GTF trace entry
- ID=X‘F6C’
- The subsystem event trace identifier for CICS GTF trace entries.
Procedure
- You can print CICS trace entries written to GTF by invoking
IPCS with the GTFTRACE subcommand and specifying
one of the following options:
- Specify the USR parameter with the event
trace identifier of the records you want IPCS to select for formatting.
- Specify DFHTU700 selective
trace control statements on the CICS(text) parameter.
The CICS-supplied formatting routines are called DFHTG700 and DFHTR700,
supplied in CICSTS53.CICS.SDFHLINK. DFHTG700 has
the alias of AMDUSREF. The last two characters of the AMDUSREF alias
(EF
) correspond to the format identifier (FID), and enable
IPCS to invoke the CICS formatting routine automatically when you
use the GTFTRACE subcommand.
- If several CICS regions at different CICS releases are
writing to the same GTF data set, you can print the GTF trace entries
using the same GTFTRACE command.
To do so, you must make
available the formatting routine for each CICS release.
For
example, for Version 5 Release 3,
you could specify DFHTG700,
its alias AMDUSREF, and DFHTR700.