Examples of sample prompting sequences

This example shows how to store prompting keywords in a SYS1.PARMLIB member.

If you start GTF with options requiring prompting keywords stored in SYS1.PARMLIB, these prompting keywords must also appear in the parmlib member. If prompting keywords are used in the parmlib member without the replies included, GTF will not obtain the replies from the console. GTF will use the options without the prompting (for example, SVCP becomes SVC). A SYSLIB DD statement in your cataloged procedure causes GTF to read the prompting keywords from the specified parmlib member. The second and subsequent logical records in the member should contain only the prompting keywords.

GTF uses either the END keyword, or end-of-file on the member as the indicator that there is no more prompting input from parmlib. If the number of events for one keyword require more than one record, respecify the keyword in a subsequent prompting record with the additional events, as follows:

Record #1 TRACE=IOP,SVCP,SSCH
 
Record #2 IO=(D34,D0C),SVC=(1,2,3)
 
Record #3 SVC=(4,5,6,7,8,9,10),END

Do not respecify the keyword through the system console at this point, because GTF will then override all of the options and keywords in the parmlib member.

When GTF finishes reading the options and prompting keywords in the parmlib member, it displays the options through message AHL103I:

AHL103I TRACE OPTIONS SELECTED--IOP,SVCP,SSCH
AHL103I IO=(D34,D0C),SVC=(1,2,3,4,5,6,7,8,9,10)

This message may be a multiple-line message, depending on the number of options you select. If the set of devices specified for IO= and SSCH= are identical, message AHL103I will show them as if specified by use of IO=SSCH.

After GTF displays all of the options specified, you then have the opportunity to accept the parmlib options, or completely change the options by respecifying them through the console by replying to the following message:

AHL125A RESPECIFY TRACE OPTIONS OR REPLY U.

In Figure 1, you started GTF in external mode to the data set defined in the cataloged procedure. You selected two trace options in reply 00:

SYSP requests that GTF trace specific system event types.
USRP requests that GTF trace specific user entries that the GTRACE macro generates.

Message AHL101A instructed you to specify values for the SVC, IO, SSCH, PI, and USR keywords. In reply 01 to message AHL101A, you selected:

Five SVCs
Two devices for non-program-controlled I/O interruptions
One device for SSCH operations
Three user event identifiers.

GTF does not record any other SVC, IO, and SSCH events. Because you did not specify any program interruption codes for PI=, GTF would trace all program interruptions.

Figure 1. Example: Specifying prompting trace options SYSP and USRP

START MYPROC.EXAMPLE7,,,(MODE=EXT)

00 AHL100A SPECIFY TRACE OPTIONS

REPLY 00,TRACE=SYSP,USRP

01 AHL101A SPECIFY TRACE EVENT KEYWORDS--IO=,SSCH=,SVC=,PI=,USR=

01 AHL101A SPECIFY TRACE EVENT KEYWORDS--IO=SSCH=

REPLY 01,SVC=(1,2,3,4,10),IO=(191,192),USR=(10,07A,AB)

02 AHL102A CONTINUE TRACE DEFINITION OR REPLY END

REPLY 02,SSCH=282,END

AHL103I TRACE OPTIONS SELECTED--SYSP,PI,IO=(191,192),SSCH=(282)

AHL103I SVC=(1,2,3,4,10),USR=(010,07A,0AB)

03 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U

REPLY 03,U

In Figure 2 you started GTF in external mode, using the trace options defined in the data set specified in the cataloged procedure. You are prompted for the information as follows:

Message AHL100A prompts for trace options.
In reply 00, you selected six trace options: SSCHP, IOP, PCI, CCWP, SVC, and JOBNAMEP.
Message AHL101A prompts to specify values for the IO, SSCH, CCW and JOBNAME prompting keywords.
In reply 01, you select one device for tracing both IO and SSCH events and limit GTF tracing to one job.
In reply 02, you specify five options for CCW tracing.

The final result of these specifications is that GTF traces CCWs for both start subchannel operations and I/O interruptions at device 580 for the job BACKWARD, and all SVCs in BACKWARD's address space. GTF would allocate 200 entries in the PCI table, and trace up to 100 CCWs or DCWs, up to 40 bytes of data for each CCW or DCW, and the IOSB, IOBE, and EWA.

Figure 2. Example: Specifying prompting trace options

START USRPROC,,,(MOD=EXT)

00 AHL100A SPECIFY TRACE OPTIONS

REPLY 00, TRACE=SSCHP,IOP,PCI,CCWP,SVC,JOBNAMEP

01 AHL101A SPECIFY TRACE EVENT KEYWORDS
        --IO=,SSCH=,CCW=,JOBNAME=,IO=SSCH=

REPLY 01,JOBNAME=(BACKWARD),IO=SSCH=580

02 AHL102A CONTINUE TRACE DEFINITION OR REPLY END

REPLY 02,CCW=(CCWN=100,DATA=40,PCITAB=2,IOSB,SI),END

AHL103I TRACE OPTIONS SELECTED--PCI,SVC,IO=SSCH=(580)

AHL103I CCW=(SI,IOSB,CCWN=100,DATA=40,PCITAB=2)

AHL103I JOBNAME=(BACKWARD)

03 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U

REPLY 03,U