The GTFTRACE subcommand of IPCS and associated parameters
To use IPCS to format and print CICS® trace entries, you must specify the GTFTRACE subcommand.
The following are the main IPCS GTFTRACE parameters that you need to process CICS trace entries:
- GTFTRACE
- Use this IPCS subcommand to format CICS trace records contained in a GTF trace data set.
- JOBNAME({name1[,name2,.,namen]})
- Code this to specify one or more jobnames for which you want DFHTR710 to format trace entries.
- CICS(CICS trace selection parameters)
- Code this parameter to specify any selection and formatting control
statements required by the CICS formatting
routine, DFHTR710.
You can code any of the DFHTU710 parameters
except EXCEPTION, PAGESIZE and TIMERG, which are not allowed. You
can change the default pagesize by using the IPCS subcommand PROFILE
PAGESIZE(value); for an example, see Figure 1. For further information
about the PROFILE PAGESIZE subcommand, see the z/OS MVS™ IPCS
Commands. (You can use the GTFTRACE START and STOP parameters
in place of TIMERG; see below.) Note: The whole string of CICS trace selection parameters must be enclosed in parentheses. If your CICS trace selection parameter is more than can be contained on one line, terminate the line with a right parenthesis followed by a comma, and specify the remainder on the next line. You must repeat the CICS keyword on the continuation line(s).
- START(ddd,hh.mm.ss) and STOP(ddd,hh.mm.ss)
- Code the START and STOP parameters to specify trace entries for a particular time range. If you omit the STOP parameter, IPCS continues processing until it reaches the end of the data set.
- USR(event-id-value-list|ALL)
- Code this parameter to specify formatting of subsystem event trace
records created by the GTRACE macro. The trace ID for CICS GTF trace entries is ‘CICS', which
translates to X'F6C'. For information about the IDs of other
subsystem trace records (for example, VSAM, z/OS® Communications Server), see the z/OS MVS IPCS
Commands . (You can code X'F6C' directly for the CICS trace event ID; USR(CICS) is an alias for USR(F6C).)
Specify ALL to request formatting of all subsystem trace entries.
There are many other parameters that you can specify on the GTFTRACE subcommand of IPCS. For information about the GTFTRACE command, see the z/OS MVS IPCS Commands .