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 .



dfha68o.html | Timestamp icon Last updated: Monday, 5 June 2017