IBM® supplies the GTF cataloged
procedure, which resides in SYS1.PROCLIB. The cataloged procedure
defines GTF operation, output location, recovery facilities, trace
output data sets, and the parmlib member that contains GTF options
and defaults. Figure 1 illustrates the
content of the IBM supplied
cataloged procedure.
Figure 1. IBM-Supplied
GTF Cataloged Procedure//GTFNEW PROC MEMBER=GTFPARM
//IEFPROC EXEC PGM=AHLGTF,PARM='MODE=EXT,DEBUG=NO,TIME=YES',
// TIME=1440,REGION=2880K
//IEFRDER DD DSNAME=SYS1.TRACE,UNIT=SYSDA,SPACE=(TRK,20),
// DISP=(NEW,KEEP)
//SYSLIB DD DSN=SYS1.PARMLIB(&MEMBER),DISP=SHR
The statements in this cataloged procedure are:
- PROC
- Defines the GTF cataloged procedure.
- EXEC
- PGM=AHLGTF
- Calls for the system to run program AHLGTF.
- PARM='MODE=EXT,DEBUG=NO,TIME=YES',
- The parameters selected specify that GTF direct trace data to
a data set on tape or DASD, attempt recovery if it encounters an error,
and give every trace record a time stamp. See the explanation for
the EXEC statement under Setting up a cataloged procedure for detailed
information.
- TIME=1440
- The amount of time, in seconds, that GTF will remain active.
- REGION=2880K
- Specifies the maximum size of the storage that GTF requires.
- IEFRDER DD
- Defines the trace output data set, according to the following
defaults:
- The trace output data set has the name SYS1.TRACE
- The data set resides on a DASD that is large enough for the data
set to contain 20 physical blocks. After completely filling the 20
physical blocks, GTF will overlay previously written records with
new trace records, starting at the beginning of the output data set.
Restrictions to interactions with installation SMS routines: - A DSNTYPE=LARGE data set can only be used if the trace is both
written and processed on an V1R7 system or a later release.
- A VSAM linear data set with either an extended format or conventional
format with a control interval size (CISIZE) of 32K can be substituted.
- Neither extended sequential nor VSAM data sets, other than linear
data sets with the required CISIZE, should be used.
- SYSLIB DD
- Defines the IBM-supplied GTFPARM parmlib member that contains
GTF trace options and their default values. Multiple instances of
GTF can be active at the same time. Each instance of GTF requires
a unique trace dataset. The default trace dataset in the cataloged
procedure can be overridden by specifying a different data set on
the START command, or by setting up a cataloged procedure for each
instance of GTF to be activated.