FDRTSEL CONTROL Statement

CONTROL statement syntax

The CONTROL statement is optional. It specifies FDRTSEL processing options.

CONTROL statement operands

ABRINDEX=

Specifies the ABR prefix (first index level) of the ABR ARCHIVE and BACKUP files to be copied. This may be used with application backups (DUMP TYPE=APPL, see FDRAPPL-Application-Backup).

Default: Use the ABRINDEX in the FDR Global Options (usually “FDRABR”).

ARCBACKUP=DSF

When copying Archive or Application Backup files, directs FDRTSEL to invoke FDRDSF to DUMP the Archive Control File used in this step as the last file on the tape once all files have been copied. This operates the same as the ARCBACKUP=DSF option of ABR.

If the ARCB1DSN= and/or ARCB2DSN= operands are not specified, FDRTSEL names these files on the tape by changing the index level “ARCHIVE” in the Archive Control File data set name to “ARCBKUP” for TAPEOUT and “ARCBKU2” for TAPE2OUT.

ARCB1DSN=

ARCB2DSN=

Specifies the data set names to be used on TAPEOUT (ARCB1DSN=) and TAPE2OUT (ARCB2DSN=) for the backup of the Archive Control File if the ARCBACKUP=DSF operand is also specified. The default names are described under “ARCBACKUP=DSF” in FDRTSEL-Control-Statements.

COPYERR=STOP

Directs FDRTSEL to shutdown if an error occurs during any error from invoking FDRTCOPY to copy a selected file. If an error occurs during the FDRTCOPY process without this option specified, FDRTSEL dismounts the volumes pointed to by //TAPEOUT and //TAPE2OUT and calls for a new scratch tape to be mounted.

DEFRABRV

NODEFABRV

Specifies whether (DEFRABRV) or not (NODEFABRV) FDRTSEL should recognize if FDRABR is waiting on a tape volume and release control of the tape volume to FDRABR. This allows the FDRABR job to dynamically allocate the volume. Once control if the volume is released, FDRTSEL will reallocate the tape volume and wait behind FDRABR to finish with the volume. When FDRTSEL releases a tape volume, it issues a WTO indicating that it released the tape volume.

Default: NODEFABRV.

MAXFILES=

nnnn

Specifies the maximum number (1 to 9999) of ARCHIVE or BACKUP files to be copied in this FDRTSEL step. Once this limit is reached FDRTSEL terminates. Files not processed may be selected in a subsequent run.

Default: All selected files are copied.

REBUILD

Applies only to SELECT ARCHIVE/ARCEDIT functions.

Directs FDRTSEL to select the backups for copying based on the COPY=n or IFNOCOPY=n operand, however it uses the other copy to copy from. This allows you to rebuild a version of a set of backups from the other copy.

SIM

Invokes a simulation mode, and generates a report detailing the archive or backup files that would be copied. This is recommended for testing FDRTSEL options.

STACK=

STACK2=

Controls how output files are stacked on TAPEOUT (STACK=) and TAPE2OUT (STACK2=), that is, whether multi-file output tapes are created.

NO

Create only one file per output tape.

YES

Stack up to 255 files.

VOLUME

Stack all the selected backups related to the same DASD volume on one set of output tapes.

nnnnn

Stack up to nnnnn files (1 to 65534).

If the stack limit is reached, FDRTSEL calls for a fresh scratch tape (or the next tape in the TAPEOUT volume list if supplied) and starts with file sequence 1.

Default: YES.

STOPCC=

When premature termination of FDRTSEL is requested via the operator command “P job” or “F job, STOP” (see “Operator Commands” in FDRTSEL-Features-and-Considerations), FDRTSEL shuts down processing files at the completion of the current file. STOPCC= specifies the step return code to be set to indicate that this has occurred.

Default: 4.

TMS

NOTMS

Specifies the Tape Management System (TMS) option for use with the LAST TAPE option (see “LASTAPE Support” in FDRTSEL-Features-and-Considerations).

NOTMS

Causes FDRTSEL to overwrite the LASTAPE file on the previous tape when adding new files to the tape.

TMS

Causes it to add new files after the previous LASTAPE file for compatibility with tape management.

Default: Taken from the TMS option in the FDR Global Options (ISPF panel A.I.4.4).

UNITNAME=

The first name is the generic unit name that FDRTSEL normally used to allocate the TAPEIN DD statement for a given backup on a given device, such as 3480, 3480X, 3490, or 3590-1. The second name is the user-supplied replacement esoteric or generic device name to use instead of the first name. For example: UNITNAME=(3490,NONSILO)

This keyword can be repeated up to 15 times for a total of 16 UNITNAME device pairs.

UPPER

By default, FDRTSEL issues messages in upper and lower case print characters. If you require that all messages be printed in UPPER case only, specify this option.