Only the options provided in the IBM® default
member, GTFPARM, are described here. For a complete list and description
of GTF options, see
z/OS MVS Diagnosis: Tools and Service Aids.
- DSP
- This parameter
requests recording for all dispatchable units of work (SRB, LSR, TCB,
and SVC prologue dispatch events). The option is not included in the
specification of SYS or SYSM. It must be specified in addition to
other parameters. The parameter produces comprehensive format except
when SYSM is also specified. With SYSM, data is in minimal format.
- END
- This parameter
indicates the end of the prompting records. In the parmlib member,
an end of file serves the same purpose. Never include the END parameter
in the first record (the record that contains the TRACE parameters)
because GTF regards such an occurrence as an error.
- PCI
- This parameter
requests that program-controlled I/O interruptions (PCIs) be recorded
in the same format as other requested I/O trace records. If specific
device numbers are specified through prompting records, program controlled
I/O interruptions are recorded for the specified devices. I/O tracing
must be requested because PCI must be specified with a GTF parameter
that causes IO, such as SYS or SYSM.
- SRM
- This parameter
requests a trace entry each time that the system resource manager
(SRM) is invoked. The option is not included in the specification
of SYS or SYSM. It must be specified in addition to other parameters.
Data is in comprehensive format except when SYSM is also specified.
Comprehensive format includes the jobname.
- SYSM
- This parameter
requests recording of minimal trace data for all external interruptions
(EXT), program interruptions (PI), recovery routines (RR), and supervisor
call interruptions (SVC). SYSM causes recording of all I/O interruption
(IO), start subchannel and resume subchannel operations (SSCH), clear
subchannel operations (CSCH), halt subchannel operations (HSCH), modify
subchannel operations (MSCH), and cancel subchannel operations (XSCH).
When you specify DSP, RNIO, or SRM, in addition to SYSM, GTF produces
minimal trace data for those events.
Note: Specification of SYS,
SYSM, or SYSP causes GTF to ignore the following trace options if
you specify them in any form: CSCH, HSCH, MSCH, SSCH, XSCH, IO, SVC,
PI, EXT, RR.
- TRC
- This parameter
requests that traced events include those related to GTF processing
itself. If this parameter is not specified, GTF-related events are
excluded from the trace output.
- USR
- This parameter
requests that user data passed to GTF through the GTRACE macro be
recorded with the system data.