gtpo1mh5Operations

Job Control Language

The job control language (JCL) required for DOF includes the following statements:

//STEPNAME  EXEC  PGM=PPCP,REGION=512K
//STEPLIB   DD    DSN=ACP.LINK.RELvv,DISP=SHR
//PRDD      DD    SYSOUT=A
//SYSOUT    DD    SYSOUT=A
//DDSCTH    DD    DSN=&&SCRTH,DISP=(NEW,DELETE),UNIT=(SYSDA,,DEFER),
//                SPACE=(TRK,(50,200))
//SYS000    DD    DSN=RTn.TAPE,DISP=OLD,UNIT=TAPE,
//                VOL=SER=xxxxxx,DCB=OPTCD=B
Processing Multivolume Tapes

If you are processing only one tape, skip this box. If you are processing more than one tape, code the following JCL statements:

//SYS000    DD    DSN=RTn.TAPE,UNIT=TAPE,LABEL=(,SL),DISP=(SHR,PASS),
//                VOL=SER=(xxxxxx,yyyyyy),DCB=OPTCD=B
//SORTIN    DD    DSN=&&SRTIN,DISP=(NEW,DELETE),
//                DCB=(RECFM=VB,LRECL=3700,BLKSIZE=3704),
//                UNIT=(SYSDA,,DEFER),SPACE=(TRK,(50,200))
//SORTOUT   DD    DSN=&&SRTOUT,DISP=(NEW,DELETE),
//                DCB=(RECFM=VB,LRECL=3700,BLKSIZE=3704),
//                UNIT=(SYSDA,,DEFER),SPACE=(TRK,(50,200))
//SORTLIB   DD    DSN=SYS1.SORTLIB,DISP=SHR
//SORTWK01  DD    UNIT=(SYSDA,,DEFER),SPACE=(TRK,(150),,CONTIG)
//SORTWK02  DD    UNIT=(SYSDA,,DEFER),SPACE=(TRK,(150),,CONTIG)
//SORTWK03  DD    UNIT=(SYSDA,,DEFER),SPACE=(TRK,(150),,CONTIG)
//SYSUDUMP  DD    SYSOUT=A
/*
//

EXEC Statement

The size of the REGION parameter in the EXEC statement is based on the largest message that will be processed. The largest message size is derived from the SIP SYGLB/SYSET value for &SAM3270. The minimum tested values are 512K when the SM (sort/merge) option is specified for DOF and 250K when the SM option is not specified. These values are used with the assumption that the largest message is approximately 3600 bytes plus control characters. See Third Message for DOF Options (TV Mode) for more information about the SM option.

You can decrease the size of the REGION parameter when DOF is generated with less than full capability.

You can also use the EXEC statement to specify parameters for the DOF options instead of typing them in response to console messages. See Specifying DOF Options in the JCL EXEC Statement for more information.

STEPLIB Data Definition

The STEPLIB data definition refers to the load module library, and vv identifies the version number of the TPF release. It may be necessary to concatenate a load module library from an earlier release to access the global label table for the global area labels.

SYS000 Data Definition

The SYS000 data definition refers to the input RTA/RTL tape generated by any TPF release since ACP5. The n is an A or an L to define whether an RTA or an RTL tape is being used.

You must change xxxxxx in the VOL=SER= parameter to represent the volume serial number (VSN) of the tape being that is processed. If the data for a single system error dump is contained on more than one volume, you have two choices for coding the JCL:

  1. Concatenate the data sets using multiple data definitions (DD) statements. Code the VOL=SER= parameter on the first DD statement as VOL=SER=xxxxxx, where xxxxxx represents the VSN of the tape that contains the first data set. Code the VOL=SER= parameter on the second data definition statement as VOL=SER=yyyyyy, where yyyyyy represents the VSN of the tape that contains the second data set. Code the DISP= parameter as (SHR,PASS), where SHR indicates that the data existed before this job step and can be shared. PASS indicates that the data set will be passed to a subsequent job step in the same job.
  2. Code the VOL=SER= parameter as VOL=SER=(xxxxxx,yyyyyy), where xxxxxx and yyyyyy represent the VSNs of the tapes that contain the data. These VSNs must be listed in the order in which they were created. Code DCB=OPTCD=B to disregard the end-of-file condition. OPTCD=B prevents a premature end-of-file indication for multivolume input data sets.

SORT Data Definitions

Data definitions that start with SORT are used with the SM (sort/merge) option. These data definitions are ignored if you do not specify the SM option or if the TPF system does not support PTV.

If you specify the NOPR option, you may want to modify the SORTOUT data definition to a KEPT data set, either tape or DASD.

See Third Message for DOF Options (TV Mode) for more information about the SM option and the NOPR option.

You must also code the DCB parameter for the SORTIN and SORTOUT data definitions. The values you assign to the LRECL and BLKSIZE parameters vary according to the largest message plus any control characters. When you assemble the BMP0 segment, an MNOTE statement is generated after calculating the LRECL and BLKSIZE parameters. The values previously shown represent a maximum TPF message size of 3600 bytes plus any control characters. This value is calculated from the SIP SYGLB/SYSET value for &SAM3270.