ABR Options

If you are not licensed for ABR, you may skip these panels.

Panel A.I.4.4 – Set FDR Global Options for ABR

These options are used by components of ABR.

Set FDR Global Options for ABR – Panel A.I.4.4

ABRCC

If an error occurs during execution of ABR that is not severe enough to cause immediate termination, ABR completes processing of the current volume and other requested volumes and then terminates the step with an abend or return code to call attention to the error. The default of 12 sets return code 12. If you wish to change the return code, set any desired value from 8 to 255. Set ABRCC to “ABEND” if you wish ABR to end with abend U0888.

Default: 12

DISKUPDATE

If “YES”, the ABR remote queue utility (FDRABRUT) updates the DSCBs of selected data sets directly when a remote queue backup or archive is requested. If set to “NO”, FDRABRUT uses remote queue data sets; (see The Remote Queue Data Sets in Create-the-Remote-Queue-Files and sections Remote Queue in Processing-Options-and-Requirements and Remote Queue in FDRABR-Processing-Options-and-Requirements). FDRABRUT always uses remote queue data sets for restores from backup and archive.

Default: YES

TMS

The tape techniques used by ABR are generally compatible with tape management systems, such as CA 1, CA TLMS, or DFSMSrmm. However, you must inform ABR that Tape Management exists in the Operating System by specifying “YES”.

Default: NO

ARCRECALL

If “NO”, ABR ARCHIVE does not catalog archived data sets for automatic recall unless the RECALL=YES option is specified on the DUMP TYPE=ARC statement. If you want most archived data sets to be eligible for auto-recall, make RECALL=YES the default by changing this option to “YES”. It can be overridden at run time.

Default: NO

MIGRAT

By default, if ABR ARCHIVE recatalogs archived data sets for automatic recall, the catalog entry retains the original volume serial of the DASD from which the data set was archived, unless the MIGRAT=YES option is specified on the DUMP TYPE=ARC statement, in which case the volume serial “MIGRAT” is used instead (except for multi-volume VSAM). You can make MIGRAT=YES the default by changing this option to YES. Do not set MIGRAT to “YES” if you do not have the ABR Catalog Locate exit activated. It can be overridden at run time.

Default: NO

ARCOPY

If set to “2”, ABR ARCHIVE restores and FDRAPPL application restores restore from the COPY2 backup You may want to set ARCOPY to “2” at a disaster site where only COPY2 is available from off site storage. It can be overridden at run time.

Default: 1

BKPCOPY

If set to “n” (1 to 9), ABR restores from full-volume and incremental backups restore from the COPYn backup You may want to set BKPCOPY to “2” at a disaster site where only COPY2 is available from off site storage. It can be overridden at run time.

Default: 1

DYNDEALC

Controls the operation of the DYNTAPE option for ABR restores from tape.

If set to “NO”, ABR allocates a tape drive for the first tape required for a given restore step, but if the next tape required is the same type as the previous tape (for example, 3590) the same drive is used to mount that tape. Only when a different type of drive is required for the next tape does ABR deallocate the current drive and allocate a new one. This is to avoid the problem of the ABR restore tapes bouncing from one drive to another and possibly waiting for a free drive. However, in installations with an Automated Tape Library (ATL) or a Virtual Tape System (VTS), it may be necessary to allocate a new drive for each tape to be mounted.

If set to “YES”, ABR deallocates and reallocates whenever a new tape backup data set on a new volume is required, allowing the allocation to choose an appropriate ATL, VTS, or native tape drive. If the next backup file is on the tape already mounted, it is not reallocated.

Default: NO

ALLOCATEFLAG

ABR dynamically allocates the backup medium (tape or DASD) during restore operations if the DYNTAPE operand is specified (assumed for auto-recall). The options below affect dynamic allocation of the backup data sets.

MOUNT

If “YES”, a TSO user can mount a tape, whether or not the user has MOUNT authority in their TSO profile. This allows TSO users to do foreground recalls from tape even though they are not normally allowed to mount tapes. Normally if MOUNT is “YES”, OFFLN should also be “YES”.

OFFLN

If “YES”, dynamic allocation can ask the operator to vary an offline tape drive online to mount the backup tape if no online tape units of the proper type are available. Normally if MOUNT is “YES”, OFFLN should also be “YES”.

WTDSN

If “YES”, ABR waits if the required backup data set name is in use. This option is recommended for systems with JES2; however, it should not be set in systems with JES3, where it can cause an interlock.

WTUNT

If “YES”, ABR waits for an available unit if all eligible units are already in use. The operator may need to reply “WAIT” to a z/OS allocation recovery message.

WTVOL

If “YES”, ABR waits for the tape volume if it is currently in use by another job. WTVOL is automatically assumed on full volume restores.

Default: NO (for all 5 values)

Panel A.I.4.5 – Set FDR Global Data Set Name Options

This panel controls naming conventions and data set names used by ABR. Quotes are not required around any of the names specified on this panel; they are assumed to be fully-qualified names.

ABR Data Set Names – Panel A.I.4.5

ABRINDEX

ABR normally uses a first level index of “FDRABR” for all backup and ARCHIVE data sets created by FDRABR (Tape Format and Naming Conventions in Overview-of-FDRABR-Volume-Backups and Tape Format and Naming Conventions in Introduction-to-FDRABR-Archiving-and-Superscratch describe the ABR naming conventions). In addition, this index level is used in the names of the ABR Model DSCBs that are placed in the VTOCs of every volume initialized for ABR processing (FDRABR.Vvolser). It is recommended that the standard index name of “FDRABR” be used but if you must use a different name change it here; ABRINDEX must be a single index (ABR adds a period at the end if you omit it).

Default: FDRABR.

SCRINDEX

This single character (alphabetic or national) plus a period is prefixed onto the name of any data set that is scratched by z/OS, if it also has a current ABR backup. This modified name is cataloged into the ABR scratch catalog if the ABR DADSM Pre-processing exit is installed (see DADSM Pre-Processing Exit in Section 90.60). The default is “#.” (pound-sign) and BMC recommends that you do not change it but if you must change it specify a single replacement character here (ABR adds a period at the end if you omit it).

Default: #.

DSNCK

If set to “YES”, ABR validates the names of the Archive Control File and the remote queue data sets, as explained under those options. To disable this validation, change this option to “NO”.

Default: YES

LASTAPE

This value is the prefix for the data set name (up to 16 characters) used for the LASTAPE option; LASTAPE allows multiple ABR jobs to place backup files on the same tapes as explained in LAST TAPE Option in Volume-DUMP-Job-Control-Requirements and LAST TAPE Option in Archive-and-Superscratch-Job-Control-Requirements.

Default: FDRABR.LASTAPE

POOLDISK

This value is the prefix for the data set name (up to 16 characters) used for the POOLDISK option. POOLDISK allows ABR to manage a pool of DASD used for ABR output files (usually used for ARCHIVE) as explained in POOLDISK Option in Archive-and-Superscratch-Job-Control-Requirements.

Default: FDRABR.POOLDISK

ARCDSN

This is the fully-qualified name of the default Archive Control File (up to 44 characters). ABR dynamically allocates this file for the AUTOMATIC RECALL of data sets and for any ARCHIVE job specifying the DYNARC option.

Default: FDRABR.ARCHIVE

ARCHDMPQ

ARCHRSTQ

BKUPDMPQ

BKUPRSTQ

These are the names of the ABR Remote Queue data sets (up to 44 characters). One index level of the name (other than the first) must be the middle index shown in the defaults above unless the DSNCK option is “NO” (for example, one index level in the ARCHDMPQ data set must be “ABRARDQ”).

ARCHDMPQ

ARCHIVE dump remote queue. See ABRARDQ DD Statement in Archive-and-Superscratch-Job-Control-Requirements and The Remote Queue Data Sets in Create-the-Remote-Queue-Files.

Default: FDRABR.ABRARDQ.DATA

ARCHRSTQ

ARCHIVE restore remote queue. See ABRARCH DD Statement in Archive-Restore-Job-Control-Requirements and The Remote Queue Data Sets in Create-the-Remote-Queue-Files.

Default: FDRABR.ABRARCH.DATA

BKUPDMPQ

Volume Backup dump remote queue. See ABRBKDQ DD Statement in Volume-DUMP-Job-Control-Requirements and The Remote Queue Data Sets in Create-the-Remote-Queue-Files.

Default: FDRABR.ABRBKDQ.DATA

BKUPRSTQ

Volume Backup restore remote queue. See ABRREST DD Statement in FDRABR-Restore-Job-Control-Requirements and The Remote Queue Data Sets in Create-the-Remote-Queue-Files.

Default: FDRABR.ABRREST.DATA

Panel A.I.4.7 – Set ABR Disk Volume Processing Options

This panel defines defaults used by FDRABRM, the ABR VTOC Maintenance Utility (described in VTOC-Maintenance-Utility-FDRABRM) and Panel A.I.8 – Set ABR Disk Volume Processing Options. Most of these can be overridden at run time. It also includes options relating to ABR OLDBACKUP processing.

ABR Volume Processing Options – Panel A.I.4.7

OLDBENT

OLDBOFF

These are the OLDBACKUP options. The ABR Volume Backup system always records the most current backup cycle on which a given data set was backed up. In addition, ABR provides the option of recording up to 13 previous backups. OLDBACKUP processing is enabled on a volume-by-volume basis when the ABR Model DSCB is initialized or updated to enable a volume for ABR processing.

The OLDBENT and OLDBOFF options specify a field within each Format 1 DSCB where the old backup information is to be stored. OLDBENT (the number of entries) is the length of the field in bytes; OLDBOFF is the displacement the field from the beginning of the Format 1 DSCB. At one time there were several such DSCB fields available for ABR use, but now the only safe field is DS1SYSCD (the “system code” field; this is initialized to a constant by allocation but is not used for any purpose), which is represented by the default values above.

CYCLE

nn

Specifies the number of cycles (incremental backups) that are created within each generation (full volume backup) of backup tapes created by ABR (using DUMP TYPE=AUTO). The number may be from 0 to 63 inclusive.

Default: 10

GEN

nnnn

Specifies the number of generations of backup tapes ABR maintains in the catalog for each volume. The number may be from 1 to 1000 inclusive.

Default: 4

RETPD

nnnn

Specifies the retention period in days of ABR full volume backup tapes (COPY1). The number may be from 1 to 9999 inclusive.

Default: 60

RETP2

nnnn

Specifies the retention period in days of ABR full volume backup tapes (COPY2). The number may be from 1 to 9999 inclusive.

Default: “DITTO”, which causes the COPY1 retention period to be used.

FORCE

If set to “YES”, allows the ABRINIT command of FDRABRM and ISPF panel A.I.8 to initialize volumes for ABR processing even if some Format 1 DSCBs have non-zero data in the reserved bytes 103-104 used by ABR.

Default: NO

CSLREF

If set to “YES”, the ABRINIT and MAINT commands of FDRABRM and ISPF panel A.I.8 set the last reference date on any data set with a zero LRDATE to today’s date.

Default: NO

LIST

If set to “YES”, all functions of FDRABRM and ISPF panel A.I.8 list the names of all data sets changed by the function.

Default: NO

Panel A.I.4.8 – Set FDR Global Options for ABR

Set FDR Global Options for ABR – Panel A.I.4.8

ARCHI

ARCLOW

These are the default values (0 to 99) for the high-allocation and low-allocation thresholds used by ARCHIVE and Superscratch if THRESHOLD=HIGH or LOW is specified on the DUMP statement (see Section 51.5 “Archive DUMP and SCRATCH Statements”). They are stored in the ABR Model DSCB, so this is the defaults used by FDRABRM and panel A.I.8 (although it can be overridden). These defaults are also used by ABR for volumes on which a threshold has never been set.

MAXFILES

This is the default for the MAXFILE= operand in ABR backups. Unless overridden, it specifies the maximum number of files that ABR creates on a multi-file backup tape, from 1 to 65534. If you are outputting to high-capacity cartridges, you may want to increase this value. This can be overridden at run time.

Default: 255

Panel A.I.4.9 – Set FDR Global Report Options

Set FDR Global Report Options – Panel A.I.4.9

SDAYS

Specifies a value used to calculate the stop date when processing the Archive Control File with a PRINT ARVCHIVE request. Stop date is calculated by subtracting the value of SDAYS from today’s date. Only data sets that were archived on or after the stop date are processed. The number may be from 0 to 9999 inclusive.

Default: 0, no stop date. That is, how long ago a data set was archived does not affect whether it is included in the PRINT ARCHIVE report.

XDAYS

Specifies a value used to calculate a future expiration date. This date is used in the summary at the end of the Archive Control File report to inform the use of data sets that expire on or before the date printed. The number may be from 1 to 999 inclusive.

Default: 10

ARCSUM

Specifies if the Archive Control File summary report is produced during a PRINT ARCHIVE function.

DETAIL

Specifies if data set information is to be printed by a VTOC list function.

Default: YES

SUM

Specifies if the summary if to be produced after each VTOC list.

Default: YES

SORTCORE

Specifies the amount of storage the program “SORT” is to use if external sorting is required. The number may be from 10000 to 8000000 inclusive.

Default: 100000

SORTMSG

Specifies the message option to be used by the program “SORT” if external sorting is required.

AC

All messages to the console.

AP

All messages to the printer (SYSOUT).

CC

Critical messages to the console.

CP

Critical messages to the printer.

NO

No messages are produced.

PC

Critical messages to both console and printer.

Default: CC

SORTPFX

Specifies the DDNAME prefix used by the program “SORT” if external sorting is required. If the string specified is less than 4 characters, a dollar sign “$” fill character is used.

Default: SORT

LASTABR

Specifies the number of days that are to have passed since a volume was last processed by FDRABR before warning messages are issued. The number may be from 1 to 90 inclusive.

Default: 7

OLDBACKUP

Specifies the relative tape numbers that are to be printed when the cross reference (XREF) option of ‘PRINT VTOC’ is selected.

ALL

All backup tapes associated with the data set.

CUR

Requests the current backup tape only.

nn

Numeric values of 0 to 13 inclusive permit the user to select specific relative backup numbers for printing, where 0 is the current backup and 13 is the oldest possible backup tape.

Panel A.I.4.10 – Set FDR Global Report Options

Set FDR Global Report Options – Panel A.I.4.10

ICFSOURCE

Specifies the source of information for reporting on ICF VSAM data and index components.

DEFAULT

If the program runs APF authorized, read the VVDS directly, otherwise, issue the LOCATE SVC to retrieve the necessary information.

LOCATE

Issue the LOCATE SVC to retrieve the necessary information, regardless of APF authorization status.

VVDS

Read the “SYS1.VVDS.Vxxxxxx” cluster directly and extract the necessary information directly from the VVR records. Either the program must run APF authorized or the end of extent appendage (IGG019YZ) must be placed in the authorized appendage list.

Default: DEFAULT

MAXICF

Specifies the maximum number of ICF clusters that can be retained in storage during a single program execution. The number may be from 100 to 10000 inclusive.

Default: 400

GBLDSN

Specifies a character string from 1 to 7 characters in length that is used to specify all data sets. An ampersand “&” must prefix the specified string.

Default: &ALLDSN

GBLVOL

Specifies a character string from 1 to 5 characters in length that is used to specify all DASD volumes. An ampersand “&” must prefix the specified string.

Default: &ALLV

DYNAL

Specifies that dynamic allocation of DASD devices is to be permitted on those systems that support dynamic allocation.

Default: YES

MAXONLINE

Specifies the maximum number of DASD volumes, either virtual or real, that are allocated via DD statements and/or by dynamic allocation during any single program execution. The number may be from 5 to 32767 inclusive.

Default: 256

MAXTCVX

Specifies the maximum number of tapes that are tabled for all DASD volumes during the execution of a combined DSNAME/backup tape cross reference (XREF) report. The number may be from 100 to 32000 inclusive.

Default: 1000

MAXTSVX

Specifies the maximum number of tapes that are tabled for a given DASD volume during the execution of a volume oriented DSNAME/backup tape cross reference (XREF) report under FDRABRP, or a report that includes backup information under FDREPORT. The number may be from 10 to 300 inclusive.

Default: 100

XREFERROR

Controls the printing of warning messages when the cross reference (XREF) of “PRINT VTOC” or “PRINT BACKUP” is selected.

YES

Requests all warning messages be printed.

NO

Requests warning messages be printed only if no other backup tape messages are printed.

Default: YES