Previous Topic: Required RECYCLE JCL Data Definition (DD) StatementsNext Topic: Command Input


Optional RECYCLE JCL Data Definition (DD) Statements

The following are optional RECYCLE JCL Data Definition (DD) statements:

DEBUGDD

The DEBUGDD DD statement defines the CA Vtape RECYCLE Utility request log data set. RECYCLE volume requests and informational messages are written to the DEBUGDD DD statement. The DEBUGDD DD statement defines a physical sequential data set, a member of a partitioned data set, or a GDG data set.

The DEBUGDD DD statement DCB attributes are defined by the RECYCLE Utility program. The RECYCLE Utility program defines the DEBUGDD DCB attributes as follows:

DCB=(LRECL=137,DSORG=PS,RECFM=VBA, BLKSIZE=4114)
PEXCLUDE

The DD that defines an 80-character sequential data set or partitioned data set (PDS) member containing the Exclude Physical Volume List (EPVL). The EPVL is a list of physical tape VOLSERs that should not be processed by RECYCLE during simulate or live processing.

The EPVL consists of one physical tape VOLSER per record. The VOLSER can start anywhere between columns 1 and 65 of the record. Nonblank characters coded prior to the VOLSER will turn the record into a comment and the record will be ignored. Comments can be coded in a record after the VOLSER if they are separated from the VOLSER by one blank character.

The PEXCLUDE DD statement, when defined, requires the following DCB attributes:

//PEXCLUDE DD    DSN=@PRFIX.@SYSID.@SVTN.PEXCLUDE,
                 UNIT=SYSDA,DISP=(NEW,CATLG,DELETE),
                 SPACE=(CYL,(1,3)),
                 DCB=(LRECL=80,BLKSIZE=n*LRECL,RECFM=FB)
PINCLUDE

The DD that defines an 80-character sequential data set or partitioned data set (PDS) member containing the Include Physical Volume List (IPVL). The IPVL is a list of physical tape VOLSERs to be processed by RECYCLE during simulate or live processing. Only the VOLSERs assigned to the group number being processed by the RECYCLE command will be included. If RECYCLE GROUP(02),… is coded and the IVPL contains ten VOLSERs, but only one of those VOLSERs is for group 02, only that VOLSER will be selected for processing. The other VOLSERs will be ignored.

The PERCENT and MAXVOLS selection criteria are ignored when a PINCLUDE DD is coded in the RECYCLE JCL.

The IPVL consists of one physical tape VOLSER per record. The VOLSER can start anywhere between columns 1 and 65 of the record. Nonblank characters coded prior to the VOLSER will turn the record into a comment and the record will be ignored. Comments can be coded in a record after the VOLSER if they are separated from the VOLSER by one blank character.

The SVTR190A file (pull list) can be copied to the PINCLUDE file. RECYCLE will recognize the pull list format and read it without the need for any modifications.

The PINCLUDE DD statement, when defined, requires the following DCB attributes:

//PINCLUDE DD    DSN=@PRFIX.@SYSID.@SVTN.PINCLUDE,
                 UNIT=SYSDA,DISP=(NEW,CATLG,DELETE),
                 SPACE=(CYL,(1,3)),
                 DCB=(LRECL=80,BLKSIZE=n*LRECL,RECFM=FB)
SNAPDUMP

The SNAPDUMP DD statement defines the CA Vtape RECYCLE Utility memory image diagnostic file. RECYCLE volume requests and informational messages are written to the SNAPDUMP DD statement. The SNAPDUMP DD statement defines a physical sequential data set, a member of a partitioned data set, or a GDG data set.

Data set attributes are as follows:
DCB=(LRECL=125,DSORG=PS,RECFM=VBA). Do not define DCB attributes when specifying the SNAPDUMP DD statement. DCB attributes are defined by the RECYCLE Utility program.

SVTR190A

Output File For Physical Input Volume Pull List Records. This DD statement specifies an output sequential data set that defines a list of physical input volume serial numbers selected for RECYCLE.

The SVTR190A output records are produced when running RECYCLE in LIVE or SIMULATE mode. Each record defines one physical volume. The records are written in RECYCLE input mount processing order. Only the first occurrence of a duplicate input volume is written to the Volume Pull List file.

Customers may use the Volume Pull List file contents to automate media management and ensure that volumes representing the Volume Pull List are available for processing before executing RECYCLE in LIVE mode.

This DD statement, when defined, requires the following JCL parameters (the BLKSIZE DCB attribute may be changed to reflect a multiple of LRECL=80).

//SVTR190A DD    DSN=@PREFIX.@SYSID.@SVTN.SVTR190A,
                 UNIT=SYSDA,DISP=(NEW,CATLG,DELETE),
                 SPACE=(CYL,(1,3)),
                 DCB=(LRECL=80,BLKSIZE=6160,RECFM=FB)

SVTR190A Record Description:
       R190ARID    DS   CL4      Record ID (190A)
                   DS   CL1      Pad
       R190AVID    DS   CL6      Recycle Physical Input Volser
                   DS   CL1      Pad
       R190ASVV    DS   CL5      #Physical Files(s) Selected (Decimal)
                   DS   CL1      Pad
       R190AAVV    DS   CL5      #Active Physical Files(s) (Decimal)
                   DS   CL1      Pad
       R190ATYP    DS   CL1      Type [P]rimary, [D]uplex
                   DS   CL1      Pad
       R190AGRP    DS   CL2      Group#
                   DS   CL1      Pad
       R190ASID    DS   CL4      System ID
                   DS   CL1      Pad
       R190ASVT    DS   CL4      SVTS Subsystem Number (SVT1-8)
                   DS   CL1      Pad
       R190ADAT    DS   CL8      Process Date: YYYYMMDD
                   DS   CL1      Pad
       R190ATIM    DS   CL8      Process Time: HH:MM:SS
                   DS   CL9      Reserved (Unused)
SVTR190B

Output File For Physical Input Volume Status Records.

This DD statement specifies an output sequential data set or member of a partitioned data set. Each record defines one physical volume. The contents of the SVTR190B file represent a Volume Status List that documents which physical tapes were processed.

Volume Status records are written to the SVTR190B file during RECYCLE LIVE mode. The data set contents are written in ascending volume serial number order.

This DD statement, when defined, requires the following JCL parameters.

//SVTR190B DD    DSN=@PRFIX.@SYSID.@SVTN.SVTR190B,
                 UNIT=SYSDA,DISP=(NEW,CATLG,DELETE),
                 SPACE=(CYL,(1,3)),
                 DCB=(LRECL=80,BLKSIZE=6160,RECFM=FB)
SVTR190B Record Description:
       R190BRID    DS   CL4     Record ID (190B)
                   DS   CL1     Pad
       R190BVID    DS   CL6     Recycle Physical Input Volser
                   DS   CL1     Pad
       R190BPPF    DS   CL5     #Physical Files(s) Selected (Decimal)
                   DS   CL1     Pad
       R190BPPF    DS   CL5     #Physical Files(s) Processed (Decimal)
                   DS   CL1     Pad
       R190BRPF    DS   CL5     #Remaining Physical Files(s) (Decimal)
                   DS   CL1     Pad
       R190BTYP    DS   CL1     Type [P]rimary, [D]uplex
                   DS   CL1     Pad
       R190BGRP    DS   CL2     Group
                   DS   CL1     Pad
       R190BSID    DS   CL4     System ID
                   DS   CL1     Pad
       R190BSVT    DS   CL4     SVTS Subsystem Number (SVT1-8)
                   DS   CL1     Pad
       R190BDAT    DS   CL8     Process Date: YYYYMMDD
                   DS   CL1     Pad
       R190BTIM    DS   CL      Process Time: HH:MM:SS
                   DS   CL9     Reserved (Unused)