DD statements for DFHJUP or your own batch job

STEPLIB DD

defines a partitioned data set (DSORG=PO) containing the EXIT routine modules. If you are not using EXIT routines, or if the modules are in a library in the link list, this statement is not required.

SYSPRINT DD

defines the output data set that will contain the formatted print records and control messages. This is usually defined as SYSOUT=A.

The DCB parameters specified for this data set are RECFM=FBA and LRECL=133. The block size may be provided on the SYSPRINT DD statement and must be a multiple of 133. The default is 133.

SYSIN DD

defines the input control data set. This file must be in 80-byte record format.

Input or data DD for log stream processing

defines the input log streams to be examined to produce the output data. The default ddname is SYSUT1.

The MVS™ image in which DFHJUP runs must be a member of the same sysplex as the MVS image in which the log stream was created. It is not necessary for the CICS® region(s) that created the log stream, or any CICS region, to be running in the same MVS image as DFHJUP.

DASD-only log streams have the added restriction that they cannot be shared between MVS images; they can only be accessed from one MVS image at a time (although multiple connections are permitted from that MVS image). This means that if a DASD-only log stream is being accessed from a particular MVS image in the sysplex (for example, by a CICS region), DFHJUP must also run in that MVS image. If the DASD-only log stream is not currently being accessed, DFHJUP can run in any of the MVS images in the sysplex.

The SUBSYS=(LOGR,DFHLGCNV,...) keyword identifies the DD statement as referring to a CICS log stream. You must specify SUBSYS keyword in any program that you use to examine and manipulate data in log streams; DFHJUP is the supplied program but you can use your own program to perform equivalent functions. See SUBSYS=(LOGR,DFHLGCNV,...) keyword for information about the SUBSYS keyword.

The DCB parameter BLKSIZE=32760 must be specified on the input data DD statement if you are processing journal records on a log stream.

Input or data DD for SMF data set processing

defines the input data sets to be examined to produce the output data.

These data sets must be standard labeled files, either DASD or tape. They must be a physical sequential data sets (DSORG=PS). If a file with RECFM=U is used, the DCB BLKSIZE parameter must be specified.

Note: For CICS SMF data sets, CICS builds journal records into variable length blocks before writing them, in a similar format to RECFM=VB, but with a label record in the first position of each block. To prevent accidental reblocking, journal data sets are often defined with RECFM=U; so to ensure that journal records are deblocked by DFHJUP, the DCB parameter RECFM=VB must be specified on the input data DD statement.

The default ddname is SYSUT1.

An example of a DD statement, using a variable block type of journal, is as follows:

//SYSUT1    DD DSNAME=CICSLOG,DISP=(OLD,KEEP),
//             DCB=RECFM=VB

The second example shows the use of the BLKSIZE parameter:

//SYSUT1    DD DSNAME=CICSLOG,DISP=(OLD,KEEP),
//             DCB=RECFM=VB,BLKSIZE=32760

Output or data DD

defines the optional output data set(s) to contain the selected records.

DFHJUP sets the RECFM of this data set equal to the RECFM specified for the input data set. This is also done for LRECL and BLKSIZE if not specified.

The default ddname used is SYSUT4.