gtpc1m6pTransmission Control Protocol/Internet Protocol

Sample JCL for the CLAW Data Trace Postprocessor

The CLAW data trace postprocessor (CLTD) program reads an RTA/RTL log tape created by the CLAW online trace function. The CLAW online trace function is activated by the ZCLAW TRACE command. The CLTD program is designed to run in an offline environment.

Use the CLTD program to generate a report of logged message entries to an output device such as a printer. Figure 32 contains sample JCL that you can use to run the CLAW data trace postprocessor.

Figure 32. Sample JCL for the CLAW Data Trace Postprocessor

//FORMAT   JOB (GM1CO,5991C),B117,MSGLEVEL=(1,1),CLASS=A
/*ROUTE PRINT SYSTEM(USERID)
/*ROUTE PUNCH SYSTEM(USERID)
//***************************************************
//***                                             ***
//***                                             ***
//***                                             ***
//***************************************************
//A         EXEC  PGM=CLTD40
//STEPLIB   DD DSN=ACP0000.DEVP.TEST.LK,DISP=SHR
//LOGTAPE   DD DISP=OLD,UNIT=VTAPE,VOL=SER=A00147,
//            DSN=RTA.TAPE
//REPORT    DD SYSOUT=A
//TERM#OUT  DD SYSOUT=A
//TERM#IN   DD *
PRINT BLK=1000,MSG=43,DATE=11FEB,TIME=19.27.58,DUR=00.06
//TERM#IN   DD  *
DEFAULT

Input parameters to the CLTD program must be in 80-column format starting with column 1. You can enter the following parameters as the JCL input data set:

PRINT
The PRINT parameter must be displayed in column 1 using a space to separate it from its keyword = argument options list. Each parameter must be separated by a comma. The PRINT parameter is required if you want to specify the following options:

BLK=nnnn
Block record criteria, where nnnn is a number from 0001 to 9999. Each block element must be right-justified with zero padding. The program processes only the first nnnn CLAW 4-K trace blocks. The default block record criteria is 1000.

MSG=nn
Message entry criteria, where nn is a number from 01 to 63. Each message element must be right-justified with zero padding. As many as nn messages in each 4-K trace block is processed.

DATE=ddmmm
Date criteria, where dd is day 01 to 31 of a month and mmm is the month in 3-character format (for example, JAN, FEB, MAR, APR, MAY, JUN JUL, AUG, SEP, OCT, NOV, DEC). The CLTD program processes only those CLAW trace blocks that match the date requested. If the date is not provided, all blocks are processed in the BLK and MSG parameters.

TIME=hh.mm.ss
Start time criteria, where hh.mm.ss is hours, minutes, and seconds in continental time format (for example, 15.00.00). Each time element must be right-justified with zero padding. The CLTD program processes only those CLAW trace blocks traced at or after the requested time. The DATE parameter is a prerequisite. If the TIME parameter is not provided, all blocks in the specified date are processed in the BLK and MSG parameters.

DUR=mm.ss
Duration criteria, where mm is minute 00 to 59 and ss is second 00 to 59. Each time element must be right-justified with zero padding. If requested, the DATE and TIME parameters are required. You can specify an ending time to be used once the program starts processing the CLAW trace blocks that meet the start time criteria. Processing ends once a CLAW trace block whose 4-K block time stamp exceeds the duration period. A duration of minutes that carries to the next day will be set to the maximum of 59 minutes of the 23rd hour of the requested day. If the DUR parameter is not specified and the TIME parameter is specified, all blocks whose date and time stamps meet the criteria are processed.

DEFAULT
Use the DEFAULT parameter if you do not want to specify the PRINT parameter with options.