G550-0428-04

Formatting and printing trace data

Formatting and printing trace data

PSF no longer formats trace data while PSF is running; therefore, data must be formatted when PSF has stopped. Figure 59 shows a sample JCL to start the PSF trace post formatter.

 

//APSWTRCF JOB 'ACCOUNT #','NAME',MSGLEVEL=(1,1)

//****************************************************************

//* PSF TRACE FORMATTER INVOCATION JCL

//****************************************************************

//STEP01   EXEC PGM=APSTRFMT,REGION=100K

//*                           /* REGION = (3 * BLKSIZE) + 20K

//*                           /* BLKSIZE = TRACEIN BLOCKSIZE

//SYSUDUMP DD SYSOUT=*                                     

//*TRACEIN  DD PATH='tracein'    <- SET TO PSF GENERATED zFS

//*                                      FILE NAME.

//TRACEIN  DD UNIT=unit,        <- UNIT MIGHT BE TAPE OR DASD.

//            DSN=tracein,      <- SET TO PSF GENERATED TRACE

//*                                      DATA SET NAME.

//            DISP=SHR,

//            VOL=SER=volser    <- SERIAL NUMBER OF

//*                                      VOLUME.

//TRACEOUT DD UNIT=unit,        <- UNIT MIGHT BE TAPE OR DASD.

//            DSN=traceout,     <- SET TO DATA SET NAME WHERE

//*                                FORMATTED RECORDS ARE

//*                                PLACED.

//            DISP=disp,        <- DISPOSITION OF TRACE OUT.

//            VOL=SER=volser    <- SERIAL NUMBER OF VOLUME.

//SYSPRINT DD SYSOUT=*

//SYSIN    DD *

       TYPE=SHORT

/*

//

The TRACEIN DD card identifies the trace data generated by PSF. Therefore, the attributes of that data set should be reflected in the DD card.

The TRACEOUT DD card identifies the data set into which the formatted trace job is stored. The parameters specified on the DD statement are device-dependent. The data control block (DCB) parameters you should specify are:

Record length:

This must be 117, which is the default.

Block size:

This must be a multiple of 117. If it is not specified or it is not a multiple of 117, it defaults to 1287.

Record format:

This must be FBA, U, or FB. The default is FBA.

Organization:

Sequential (PS).

You can specify three TYPE options on the SYSIN DD card:

SHORT

Excludes some PSF data, specifically PPCC trace entries. For some entries, only the first 32 bytes of data are traced. In a truncated entry, a '<' is placed in the space between the address and the start of the data in the trace output data set. This is the default.

TITLES

Only headers are printed for the trace entry being formatted.

LONG

All data is included in the trace output data set.