The IBM-Supplied cataloged procedure

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.