FDRTSEL JCL Requirements
FDRTSEL requires the following JCL to execute:
EXEC statement
Specifies the program name (FDRTSEL) and region requirement. The recommended region size is 4M or larger.
STEPLIB DD statement
If required, specifies the load library where FDRTSEL resides. It must be an APF authorized library.
ARCHIVE DD statement
Specifies the ABR Archive Control File to be used to identify archive backups to be copied when SELECT ARCHIVE is used. This ARCHIVE file will also be updated to reflect the results of the copy. If omitted, the DYNARC option is assumed.
SYSIN DD statement
Specifies the control statement data set. Usually an input stream or DD * data set.
SYSPRINT DD statement
Specifies the output message data set. Normally a SYSOUT data set.
SYSUDUMP DD statement
Specifies the abend dump data set. Although not required, we recommend you to always include this DD statement, so that we can help you diagnose error conditions. Usually specifies a SYSOUT data set.
TAPEIN DD statement
Must not be present. It is dynamically allocated by FDRTSEL.
TAPEOUT DD Statement
Specifies the destination for the primary or only output copy to be created by FDRTSEL. The ddname “TAPEOUT” may be overridden by the TAPEOUT= parameter on the COPY statement.
Simulation
If CONTROL SIM is specified, you may omit TAPEOUT or specify it as:
Tape output
If outputting to tape or cartridge, specify:
UNIT=
Specify a generic (for example, 3590) or esoteric (for example, CART) name to allocate the type of tape drive desired. If you have sufficient tape drives available, specifying a unit count of 2 (for example, UNIT=(3590,2)) may reduce elapsed time.
DISP=(NEW,KEEP)
Do not specify CATLG since FDRTSEL handles cataloging of output files internally.
VOL=
You may need to specify a volume count (for example, VOL=(,,,255)) to prevent FDRTSEL from abending if more than five tape volumes are required. If no volume serials are specified, FDRTSEL calls for scratch tapes; this is recommended; however, you may specify up to 255 tape volume serials.
LABEL=
RETPD=
EXPDT=
You may want to specify RETPD= or EXPTD= to provide the expiration date of the backups. See the “EXP=” in Section 60.12 for details on handling of expirations.
If multiple backups are copied, FDRTSEL creates multiple files on the tape (or tape aggregate if more than one tape volume is used). For example,
//TAPEOUT DD DSN=ABR1,UNIT=3590,DISP=(NEW,KEEP), // VOL=(,,,255),LABEL=EXPDT=99000
LAST TAPE (LASTAPE) Option
The LAST TAPE (LASTAPE) option of FDRTSEL allows you to add backup files to a tape created by a previous FDRTSEL step (even if that step is in another job and even if it was run on a previous day). This option is controlled entirely through JCL. To request LASTAPE, the TAPEOUT DD statement is similar to that described above except that you specify:
DSN=
Any name that includes an index level of “LASTAPE”. You may have multiple LASTAPE files for various purposes. This name is cataloged to record the tape volume serial and file number where FDRTSEL is to start its output.
DISP=(MOD,KEEP)
This tells FDRTSEL to locate the LASTAPE file in the catalog, verify that the file exists on the output tape, and begin outputting to the tape at that point. If the name is not cataloged, FDRTSEL calls for a scratch tape and begin at file 1. Also, if NEW is specified instead of MOD, FDRTSEL ignores the LASTAPE file and uses scratch tapes (but it still records the LASTAPE for future use).
VOL=
Volume serials should not be specified, but the volume count can be given.
Example:
//TAPEOUT DD DSN=TECH.LASTAPE.COPY1,DISP=(MOD,KEEP), // UNIT=3590,VOL=(,,,255),EXPDT=99000
DASD output
You may request that FDRTSEL copy the backups to DASD. This is usually used with ARCHIVE backups, not full-volume or incremental backups. DASD output can only be requested if the input backup files are also on DASD. In this case the TAPEOUT DD statement is used only to specify one or more DASD volumes on which the backups are placed; FDRTSEL internally allocates the required backup files on those output DASD.
To request DASD output, specify the UNIT= device type, DISP=OLD, and VOL=SER= one or more DASD volume serials, for example,
Alternately, you may catalog a dummy data set to a set of output volumes and refer to that name in the JCL (remember that the name itself is not used, only the VOLSER list it points to), for example,
TAPE2OUT DD statement
(Optional) Specifies the duplicate output tape or DASD copy to be created. All comments about “TAPEOUT” above apply to TAPE2OUT.
The ddname “TAPE2OUT” may be overridden by the TAPE2OUT= parameter on the COPY statement. If a TAPEOUT2 DD statement is present, it is treated as an alias for TAPE2OUT. If the TAPE2OUT and TAPEOUT2 DD statements are omitted, then the TAPEOUT file is the only copy created.
TSELCKPT DD Statement
(Optional.) Specifies the Checkpoint recovery file. Its usage is described in “Checkpoint / Restart” in FDRTSEL-Features-and-Considerations. If included, it should be allocated with JCL similar to:
//TSELCKPT DD DSN=PROD.TSEL.CHECKP,DISP=(MOD,CATLG), // UNIT=SYSALLDA,SPACE=(CYL,(2,1))
This creates and catalogs the file if it does not exist, and uses it if it does exist. If the file is new or empty, FDRTSEL writes checkpoint information to it. But if it is not empty at initialization, FDRTSEL automatically performs a restart. If FDRTSEL completes successfully, it rewrites the file as empty, ready for the next FDRTSEL execution.
Return codes
FDRTSEL ends with a return code as shown in this table:
00 (zero)
All functions ended normally
04 or “nn”
All completed functions ended normally, but FDRTSEL was terminated prematurely because of the MAXFILES= operand (on the CONTROL statement) or because of a “STOP” console command. “nn” – Set by STOPCC=nn value on CONTROL statement.
08
An error occurred (other than an FDRTCOPY error).
12
An FDRTCOPY error occurred.
If no backups match the selection criteria, FDRTSEL ends with return code of 08, unless SELTERR=NO is specified. If SELTERR=NO, FDRTSEL ends with return code of 00 when there are no matching backups.