FDRABRM ABRINIT Statement
ABRINIT statement syntax
ABRINIT | |
---|---|
,BYPASSACS | |
,CYCLE=10|nn | |
,DATACLAS=dataclas | |
,DISABLE=([ARCHIVE][OLDBKUP][SCRATCH]) | |
,ENABLE=([ARCHIVE][OLDBKUP][SCRATCH]) | |
,FORCE | |
,GEN=4|nnnn | |
,HIGHTHRESHOLD=80|nnn | |
,LIST=ALL|NO|YES | |
,LOWTHRESHOLD=50|nnn | |
,MGMTCLAS=mgmtclas | |
,ONLINE | |
,RESERVE=NO|YES | |
,RETPD=60|nnnn | |
,RETPD2=60|nnnn | |
,STORCLAS=storclas | |
,VOL=vol|VOLG=volg |
ABRINIT statement
The ABRINIT statement is used to perform ABR initialization on a volume that is not currently initialized for ABR processing, one that has no ABR Model DSCB and has never been backed up by ABR. It specifies the ABR DASD volume processing options and the volumes where they are to be set. If the ABRINIT statement contains the VOL or VOLG operand, the options are set on only the specified volumes. If the ABRINIT statement contains the ONLINE operand, the options are set on all mounted volumes. In either case, only volumes not currently initialized for ABR are altered.
ABRINIT statement operands
BYPASSACS
Specifies that the SMS ACS (Automatic Class Selection) routines are not to be invoked when allocating the ABR Model DSCB. The SMS classes specified by the DATACLAS=, MGMTCLAS=, and STORCLAS= operands are assigned if the volume on which the ABR Model DSCB is being created is SMS-managed. BYPASSACS must be specified if the installation's ACS routines do not permit a storage class to be assigned to an ABR Model DSCB on an SMS-managed volume.
Since BYPASSACS bypasses normal SMS allocation controls and rules, the user running the ABRINIT job must be authorized to the IBM RACF profile STGADMIN.ADR.RESTORE.BYPASSACS in class FACILITY, or the equivalent in other security systems.
Default: The SMS ACS routines are invoked for the ABR Model DSCB. The SMS classes, if any, specified by the MGMTCLAS= and STORCLAS= operands are passed to the ACS routines, which may accept, change, or nullify them.
CYCLE=
nn
Specifies the maximum cycle number (0 to 63) to be created in each generation of backups for this volume if DUMP TYPE=AUTO is used. It does not affect DUMP TYPE=FDR, ABR, or DSF. (For a full explanation of see Generations and Cycles in FDRABR-Volume-Backups).
Default: 10, unless overridden by a preceding DEFAULT statement or by a change in the FDR Global Options (ISPF option A.I.4.7).
DATACLAS=
MGMTCLAS=
STORCLAS=
smsclass
Specifies the SMS classes to be associated with ABR Model DSCBs that are created on SMS-managed volumes by this ABRINIT statement. The data class has no effect on the processing of the ABR Model DSCB; if specified, it is used only for documentation or reporting. The management class has little effect on ABR Model DSCBs since they are never archived. However, a storage class must be assigned for ABR Model DSCBs that are allocated on SMS-managed volumes. Class names that are valid in your current SMS configuration must be used.
Default: No SMS classes are associated with the ABR Model DSCBs unless your installation's ACS routines assign a management class and/or storage class to the data set.
DISABLE=
ENABLE=
The options specified are disabled or enabled for ABR processing of this volume. Multiple options are enclosed in parentheses and separated by commas. The options are:
Permits data set archiving on this volume. It is enabled by default.
Permits recording of previous backups for data sets on this volume, up to 13. When an ABR volume backup is executed on this volume, the previous backup cycles for each data set is recorded, in addition to the most recent backup. It is disabled by default; only the most recent backup of each data set is recorded.
Permits Superscratch (DUMP TYPE=SCR) on this volume. It is disabled by default.
FDRABRM verifies during initialization that the reserved fields (bytes 103 and 104) that are used by ABR are currently binary zero in every Format 1 DSCB. If this volume has previously been processed by ABR but the ABR Model DSCB was accidentally destroyed, this condition may exist and you need to use the REMODEL statement instead of ABRINIT to rebuild the ABR Model DSCB.
Indicates that ABR initialization is to proceed even if one or more DSCBs have non-zero values in those bytes (they are set to zero). Be cautious with the use of FORCE; do not specify it unless an ABRINIT without FORCE has failed because of non-zero reserved bytes, and you are sure that the information in those bytes is not needed.
Default: The initialization fails if any DSCB has non-zero data in bytes 103 or 104.
GEN=
nnnn
Specifies the maximum number of generations (1 to 1000) of backups for this volume that ABR is to maintain in the ABR catalog. At the beginning of a new generation, ABR uncatalogs all the backup tapes from the nnnn’th prior generation. (For a full explanation of generations, see Generations and Cycles FDRABR-Volume-Backups).
Default: 4, unless overridden by a preceding DEFAULT statement or by a change in the FDR Global Options (ISPF option A.I.4.7).
HIGHTHRESHOLD=
nnn
Specifies the high allocation percentage threshold (0 to 100) that ABR is to store in the ABR Model DSCB. It may optionally be used to bypass ARCHIVE and Superscratch on volumes that are below this threshold. (For an explanation of threshold usage, see Volume Thresholds in FDRABR-Processing-Options-and-Requirements).
Default: 80, unless overridden by a preceding DEFAULT statement or by a change in the FDR Global Options.
LIST=
No VTOC listing is printed.
ABRINIT prints a VTOC listing showing all data sets on the volumes being initialized.
Default: NO unless overridden by a preceding DEFAULT statement.
LOWTHRESHOLD=
nnn
Specifies the low allocation percentage threshold (0 to 100) that ABR is to store in the ABR Model DSCB. It may optionally be used to bypass ARCHIVE and Superscratch on volumes that are below this threshold. (For an explanation of threshold usage, see Volume Thresholds in FDRABR-Processing-Options-and-Requirements).
Default: 50, unless overridden by a preceding DEFAULT statement or by a change in the FDR Global Options.
Specifies that this ABRINIT statement is to initialize all DASD volumes that are online to this system, except those volumes referenced by another ABRINIT statement in this run containing VOL= or VOLG= and those that are already initialized for ABR.
If ONLINE is specified on a statement that also specifies VOL= or VOLG=, then ONLINE is ignored.
Indicates that only the SYSVTOC enqueue is to be issued.
Specifies that a RESERVE statement is to be used to insure VTOC integrity during the update operations, in addition to an enqueue on SYSVTOC for the volume involved.
Default: YES, unless specified on a preceding DEFAULT statement.
RETPD=
RETPD2=
nnnn
Specifies the default retention period, in days (1 to 9999), for the full-volume backups that begin each new generation of backups for this volume. RETPD= is the default for TAPEx DD statements (COPY1) and RETPD2= for TAPExx DD statements. All incremental backup cycles within a generation, by default, expire on the same day as the preceding full-volume backup. Retention periods can be overridden at the time of the backups. For a full explanation of cycles, generations, and retention periods for backups, See Generations and Cycles in FDRABR-Volume-Backups.
Default: 60, unless overridden by a preceding DEFAULT statement or by a change in the FDR Global Options (ISPF option A.I.4.7).
VOL=
Specifies the serial number (VOL=) or serial number prefix (VOLG=) of the DASD volumes to be initialized by this ABRINIT statement. For example, VOL=TEST01 or VOLG=TEST. Either VOL= or VOLG= is required.