Using IPCS to print trace records written to GTF

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

  1. 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 DFHTU730 selective trace control statements on the CICS(text) parameter.
    The CICS-supplied formatting routines are called DFHTG730 and DFHTR730, supplied in CICSTS56.CICS.SDFHLINK. DFHTG730 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.
  2. 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 6 , you could specify DFHTG730, its alias AMDUSREF, and DFHTR730.