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 the execution of ABR that is not severe enough to cause immediate termination, ABR completes the 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 returns 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 FDRABR-Volume-Backups-introduction 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-and-Superscratch-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 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.

APPLUPDT

This option identifies which function of FDRABR controls resetting of the DSCB update flag (DS1IND02).

You can set the APPLUPDT option as follows:

• NO—(Default) ABR incremental backup (DUMP TYPE=ABR) continues to control resetting of the DSCB update flag.
• YES—Application backup function (DUMP TYPE=APPL) controls resetting of the DSCB update flag.

FDRABR uses this DSCB update flag to determine if a data set has been updated since the previous backup. This prevents duplicate backups for data sets that have not been modified since the previous backup. There is only one update flag and only one backup function that can control the resetting of the DSCB flag.

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

MAXBACKUPD

This option sets the default value for the MAXBACKUP= keyword.

MAXBACKUP keyword defines the maximum number of separate backup data sets a single restore job can access.

Values: 1 to 256 

Default: 100

NOABRRC                        

NOABRC option specifies whether RC12 should be set when FDR309 is issued due to a selected volume not being initialized for ABR processing. 

IF YES is specified, the default will cause RC12 to be set at the end of the run when a volume is not initialized for ABR processing. 

If NO is specified,  the return code is not set when FDR309 is issued.

Default: YES

COPY2EXP         

On ABR command restore TYPE=ARC, including auto recall, this indicates whether to switch to COPY2 if COPY1 is expired. 

If YES is specified, restore will switch to COPY2 when COPY1 is expired. 

If NO is specified, the restore fails if COPY1 is expired.  This can be used when COPY1 is on disk, COPY2 is on tape, and you do not want the restore to call for COPY2 on tape.

 Default: YES

FDR315RC12      

Specifies whether ABR returns code 12 when the FDR315 message is issued. 

If YES is specified, RC12 is set.

If NO is specified, the return code is not set.

Default: YES

ABRCRITERR      

ABR abend U0888 on subtask or serious error

ABR will end with return code 12 on any major or minor error.  The ABRCC option can be used to set a different return code value, or to specify an abend U0888 should be invoked.  However, that return code value, or abend, will be issued on all errors. 

If YES is specified, a U0888 abends when a serious error in a product subtask has occurred, as opposed to a less severe error when the subtask runs to completion.  When a subtask error occurs on a backup, for example, the backup tape is not cataloged, the gen and cycle numbers in the DSCB are not updated, and the job must be re-run.  Setting ABRCC to a return code value, and setting this option to YES, the user can be alerted to serious errors more easily.

Default: NO

RQRECAT            

RECAT option is used on the remote queue to restore requests.

Default: YES

RQNVOL            

NVOL option is  used on the remote queue to restore requests

This specifies whether the RECAT= and NVOL= keywords are used on the remote queue to restore requests.  This impacts all remote queue requests, including those selected by the user for remote queue restore after failing foreground requests.

Default: YES

FDRW50             

This specifies whether to issue FDRW50 on a TSO foreground restore failure if the restore request is going to be re-attempted by the remote queue.

 Default: YES

FDR324               

FDR324 ignores date or time error and do not issue FDR324 REASON=6.

FDR324 is issued when the date or time of the last update to the Archive Control File (ACF) is greater than the current time.  However, if sharing an ACF across multiple systems that operate on different time-of-day clock times or different time zones, this can be an acceptable condition. 

Specify YES here to bypass this check.

Default: NO

USEFREST           

The TSO HRECALL uses LXDFREST option to determine the recall method.

Generally, when HRECALL is issued from TSO, if the request is asynchronous (HRECALL with NOWAIT specified or defaulted to) the recall is done in the background by the SYNRECALL started task. If the request is synchronous (HRECALL with WAIT specified), then the restore is done in the foreground within the TSO address space. 

If YES is specified, then for an asynchronous request the restore will be done using the method(s) specified in the LXDFREST option. For synchronous requests, the restore will be done by the SYNRECALL started task, and the TSO address space will wait on its completion.

Default: NO

RFAILTAPE    

The RFAILTAPE will fail TSO SYNRECALL RESTORE if the archive or backup is on tape

Specifying YES, causes the SYNRECALL started task to fail a request from TSO if the archive or backup is on tape.  This option is intended to be used in an environment where the LXFGSYNBG option is enabled, causing all foreground restores from TSO to be done as synchronous external restores to the SYNRECALL started task.

Default: NO

DROPCAT          

When the DROPCAT option is set to YES, the FDRTCOPY will not copy any backup tape files that have EXPDT=99000 and are not cataloged.

Default: NO

FDRW90S

This option will suppress FDRW90 REASON=S issued during scratch or rename of a data set restored by HSM/DFDSS.

If YES is specified, message FDRW90 REASON=S is suppressed when a volume is encountered where the current generation number in the ABR model DSCB for the volume is zero, where the volume has not been initialized for ABR processing.

Default : NO

NOCOPY2            

Switch to copy2 if copy1 is not cataloged.

Generally, on a command restore TYPE=ABR, if the COPY1 data set is not found, and a COPY2 data set exists, the restore will attempt to use COPY2 data set. 

If NO is specified, then this attempt will not occur. This option can be used if a COPY2 is created but is then kept offsite or for some reason requires some intervention to access it.

Default: YES

NOTAPEPASS         

NOTAPEPASS option will bypass tape passing during auto-recall.

Tape passing can result in message CBR4196D in an IBM ATL if a tape is left mounted on one system and is needed on a different system.  With Oracle STK silo or VSM tapes, tape passing can result in SLS5079E and/or SLS6667I messages if a tape is needed on another system. 

If YES is specified, the tape passing is bypassed during auto-recall.

Default: YES

CATINUSER 

This option specifies the number of retries attempted when catalog in-use is received.

Value: 1 to 100

Default: 30

CATINUSEI

This option specifies the number of .01 seconds to wait before each retry when catalog in-use is received.

Generally, when a catalog in-use condition is detected, processing will wait 2 seconds and then retry the request, with retry occurring every 2 seconds for 30 attempts.  The number of retries and the wait time between retries can be modified here.

Value: 1 to 500

Default: 200

REP3480           

REP3480 replaces units 3480 and 3480X with SYS348OR and SYS348XR.

Specifying YES will cause restore to replace the tape unit name 3480 with SYS3480R, and unit name 3480X with SYS348XR. 

Using SYS3480R in place of 3480 forces allocation of any drive capable of reading a 3480 non-IDRC tape (including 3490E).  Using SYS348XR in place of 3480X forces restore to allocate any drive capable of reading a 3480 IDRC tape. This option can be used when 3480s are not available. If this option is set to YES in an environment where no 3490E drives exist, you will not be able to perform restores.

Default: NO

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