gtpc1m6p | Transmission Control Protocol/Internet Protocol |
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.