FDR RESTORE Statement
RESTORE statement syntax
RESTORE | |
|---|---|
,CONFMESS=NO|YES | |
,CPYVOLID=NO|YES | |
,EMSG=OK | |
,ENQ=OFF|RESERVE | |
,MAXERR=20|nnnn | |
,MAXTASKS=1|n | |
,PROT=NONE | |
,SMSPROT=ALL|NONE | |
,VOLRESET=NO|YES |
RESTORE statement
The RESTORE statement requests a full-volume restore operation. It is optional (see EXEC Statement for specifying operands via the PARM= operand), but if present must be the first and only statement input.
These operands control the restore of each specified backup data set (TAPEx DD statement) to its output DASD volume (DISKx DD statement). The backup must be a full-volume backup created by FDR, ABR, or SAR.
An FDR RESTORE operation can restore from a backup of a DASD volume to a larger capacity volume of the same DASD type (for example, 3390-3 to 3390-9). If you want to restore from a larger DASD (such as 3390-9) to a smaller device (3390-3) it is usually more convenient to use COMPAKTOR (see COMPAKTOR-CPK-DASD-Volume-Reorganization) or FDRDSF (see FDRDSF-Data-Set-Functions). However, if you prefer to use RESTORE TYPE=FDR and no data sets are allocated on tracks beyond the end of the smaller DASD volume, you can do so by specifying PROT=NONE.
RESTORE statement operands
TYPE=FDR
Specifies that a full volume restore is to be performed. It must be specified on the RESTORE statement.
CONFMESS=
Begin the restore immediately. This is recommended at disaster recovery sites.
The operator must reply to a console WTOR for message FDRW01 before the restore begins.
Default: YES.
CPYVOLID=
The volume serial of the output DASD is retained.
Volume serial of the output DASD is replaced with the original volume serial of the DASD that was dumped. If another online volume has the same serial, the restored volume is placed offline at the end of the restore.
See VOLRESET= for details on its interaction with CPYVOLID=.
Default: CYPVOLID=NO, unless the volume being restored was SMS-managed, when CPYVOLID=YES is forced.
EMSG=
Used when the FDR e-mail notification facility has been invoked by including an FDREMAIL DD statement in the FDR execution JCL.
E-mail notifications are sent from successful FDR operations as well as failures.
Default: E-mail notifications are sent only for FDR failures.
ENQ=
Specifies whether a SYSVTOC enqueue should be done on the VTOC of each DASD volume during the restore.
The VTOC is not enqueued or reserved during the restore.
A hardware RESERVE is issued on each DASD volume during its restore. On the system where FDR is executing, an enqueue for (SYSVTOC,volser) is done, but other systems are unable to read or write any data on the volume.
Default: ENQ=RESERVE
MAXERR=
nnnn
Specifies the number of tape or DASD errors (1 to 9999) that, if reached, cause the operation to abend. Each error is indicated by a message and possible mini-dump.
Default: 20.
MAXTASKS=
n
Specifies the maximum number of volumes that are restored concurrently in this step. The value may be from 1 to 9 but the actual number of concurrent restores are no greater than the number of TAPEx DD statements in this step's JCL.
Default: MAXTASKS=1; however, if MAXTASKS= is omitted all restore messages are printed on SYSPRINT, if MAXTASKS=n is specified (even if “n” is 1), messages are directed to the SYSPRINx DD statement corresponding to the TAPEx DD statement associated with the restore.
PROT=
FDR can only restore to volumes of the same type as the dumped DASD and normally requires that the output DASD have the same or larger capacity (number of cylinders) as the input DASD, for example, 3390-3 to 3390-3 or 3390-9. PROT=NONE allows FDR to restore to a smaller DASD of the same type, for example, 3390-9 to 3390-3. Do not specify PROT=NONE unless you need this function since it also suppresses other validity checks.
Default: All validity checks are done.
SMSPROT=
Enforces several rules when SMS-managed volumes are involved. Backups of SMS-managed volumes can only be restored to SMS-managed volumes, and non SMS-managed volumes only to non SMS-managed volumes. CPYVOLID=YES is forced when an SMS-managed volume is restored.
Allows the restore of SMS-managed volumes to non SMS-managed volumes, and vice versa. Also allows the restore of SMS-managed volumes to new volume serial numbers if CPYVOLID=NO is specified.
Default: SMSPROT=ALL
VOLRESET=
If CPYVOLID=NO or PARM=N is specified or defaulted, and the volume serial of the output DASD is different from that of the original DASD on the backup, the volume serials that are part of the data set names of the VTOC Index (SYS1.VTOCIX.volser), the VVDS (SYS1.VVDS.Vvolser) and the ABR Model DSCB (usually FDRABR.Vvolser) are checked to see if they match the input volume serial (the volume backed up). If so, they are renamed to match the volume serial number of the output DASD. Also, the DSCB field DS1DSSN (Data Set Serial Number, usually the volume serial number of the first or only volume of the data set) for every data set on the volume is changed to the new volume serial if the existing value matched the original volume serial.
Regardless of the value of CPYVOLID=, the ABR Model DSCB on the restored volume (if it exists) sets the cycle number to 63 to force the next ABR backup to be a full-volume backup and increment the generation number.
Do not do any of the processing listed above for VOLRESET=YES. All data sets are restored with the names they have on the backup and the ABR Model DSCB is restored unmodified.
Default: YES