FDRDRP RESTORE Statement

RESTORE statement syntax

RESTORE

TYPE=DRP


,CONFMESS=NO|YES


,COPY=1|n


,CPYVOLID=NO|YES


,EXPDT=yyddd|yyyyddd


,MAXERR=20|nnnn


,MAXTAPES=10|nn


,MAXTASKS=100|nnn


,OPERATOR


,SMSPROT=ALL|NONE


,TAPEVOLGn=(vol,unit)


,VOLRESET=NO|YES

RESTORE statement

The RESTORE TYPE=DRP statement performs a full-volume recovery of one or more DASD volumes from ABR Volume Backups. Only one RESTORE statement is allowed per execution of FDRDRP.

Warning

Before you do a full-volume restore, make sure that the target volume is offline to all systems other than the system where the restore is to be run. If you do not, the other systems may access the original VTOC of the restored volume and access or delete the wrong data.

RESTORE Statement Operands

TYPE=DRP

Required for an FDRDRP full volume restore.

It is followed by one or more SELECT statements, each specifying a volume to be recovered.

CONFMESS=
NO

Suppresses the WTOR and begins the restore immediately.

YES

Before beginning the restore, FDR requests confirmation via a WTOR FDRW01 message to which the z/OS operator must reply.

Default: NO.

COPY=

n

Specifies the copy (1 to 9) of the backup from which the restore is to be done. COPY=2 can be specified if a duplicate tape copy (TAPExx) was created at backup time. Copies 2 through 9 can be created by the FDRTCOPY or FDRTSEL utility (see FDR-and-ABR-Backup-Maintenance).

If COPY=1 or 2 and ABR finds that one of the backup tapes is not cataloged under the copy specified, ABR checks to see if the other copy was created. If cataloged, ABR uses the other copy. So, if the specified copy has expired (and been uncataloged by a tape management system) ABR automatically uses the other copy (1 or 2) if it still exists.

Default: COPY=1 unless overridden in the FDR Global Options.

CPYVOLID=

Specifies whether the volume serial number of the DASD that was backed up is restored, if the existing volume serial number of the output DASD is different.

NO

The volume serial number of the output volume is retained.

YES

Volume serial number of the output volume is replaced with the original volume serial number 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 the VOLRESET= in FDRDRP RESTORE Statement for details on its interaction with CPYVOLID=.

Default: NO, unless the volume being restored was SMS-managed, when YES is forced.

Important

Although full-volume FDRDRP restore does not catalog data sets, any data sets that were cataloged to the original volume are automatically cataloged to the new volume when restoring with CPYVOLID=YES, assuming that you restore the system catalogs to the same point-in-time. If you use CPYVOLID=NO and do not later relabel the volume, data sets may need to be manually recataloged.

EXPDT=

Specifies an expiration date that is passed to OPEN when each backup file is opened. Since these are input tapes, the expiration date is probably ignored by your tape management system except for certain special dates. The most common use is EXPDT=98000, which is accepted by most tape management systems and means, “this tape is not in the tape management database”. You might need to use EXPDT=98000 (or whatever your TMS supports) when the tape management database has not been restored to a point after the ABR backups were taken, so that it does not reflect the backup tapes that FDRDRP needs to read. In this case, it might be easier to disable tape management until the database can be made current.

The date is specified in Julian format with a 2-digit year “yyddd” or a 4-digit year “yyyyddd”. If the 2-digit year is used, year numbers less than 70 is assumed to be in the 21st Century (for example, 20123 = 2020.123).

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.

MAXTAPES=

nn

Specifies the maximum number of tape drives (1 to 99) that FDRDRP uses to restore the selected DASD volumes. You can use this to insure that other tape drives remain free for other recovery operations. FDRDRP usually uses only one tape drive per DASD volume being restored. FDRDRP may occasionally use one more tape drive than specified by MAXTAPES=, if a drive is available.

Default: 10.

Important

If FDRDRP needs another tape drive (MAXTAPES= not reached) and no additional tapes of the proper type are online, it issues console message FDRW10 asking you to vary an additional drive online. If you do so, FDRDRP recognizes it and begins using it after a few seconds; if you ignore the message, FDRDRP only uses tape drives that are already online. You may want to insure that MAXTAPES= tape drives are online before you start the FDRDRP job to avoid this interaction. If the disaster system has fewer than 10 tape drives of the proper type, specify MAXTAPES=n (the actual number available) to avoid extra overhead in FDRDRP.

MAXTASKS=

nnn

Specifies the maximum number of volumes to be restored concurrently in this step. The value may be from 1 to 512.

Default: 100.

OPERATOR

Specifies that, before the RESTORE operation begins, an operator message is issued for each tape necessary to complete the restore. This option gives the operator the ability to pre-pull required tapes or bypass individual cycles for which the tapes may not be available at this time. However, if some cycles are bypassed, the restore may not correctly restore the latest version of some data sets.

Important

Since the restore subtasks for all the selected DASD volumes begins at the same time (up to 512 at a time), the FDRW25 messages generated by OPERATOR appear for all DASD volumes in a short period, which may be confusing and require a lot of replies. It is not recommended. However, if some off-site tapes are unavailable; this may be the only way to bypass the missing tapes.

SMSPROT=
ALL

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 volumes only to non-SMS volumes. CPYVOLID=YES is forced when an SMS-managed volume is restored.

NONE

Allows the restore of SMS-managed volumes to non-SMS volumes, and vice versa. Also allows the restore of SMS-managed volumes to new volume serial numbers if CPYVOLID=NO is specified.

Warning

SMSPROT=NONE is usually used at a disaster recovery site where a re-IPL of z/OS is done after the restores, to place all volumes in the proper SMS status. See System-Managed-Storage-SMS for more details on restoring and moving SMS-managed volumes.

Default: NONE.

TAPEVOLGn=(vol,unit)

This can be used to override the dynamic allocation of input tape units if the generic unit names that ABR uses (e.g. 3480, 3490, 3590-1) are not available in the operating system where the restore is being done (such as when tapes are restored at a DR site).

n

specifies a numeric value of 1, 2, or 3, allowing for the specification of up to 3 groups of tape volume serial numbers.

vol

Is a 1-6 character tape volume serial prefix.

unit

Is an esoteric or generic tape device name (UNITNAME) to be used for dynamic allocation of volumes with the corresponding volume serial prefix.

VOLRESET=

NO

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.

YES

If CPYVOLID=NO is specified or defaulted, and the volume serial of the output DASD volume is different from that of the original DASD volume 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 of the output DASD volume. Also, the DSCB field DS1DSSN (data set serial number, usually the volume serial 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 is set so that the next incremental backup of the volume creates the next cycle number in the current generation for that volume (a restore using TAPEDD= sets the cycle number to 63 to force the next backup to be a full-volume backup and increment the generation number).

Important

  • If you intend to restore the backup to a new permanent volume serial, use CPYVOLID=NO with VOLRESET=YES.

Data sets on the volume are not re-cataloged to the new volume serial, but you can catalog them using the IDCAMS “DEFINE” command (note that VSAM must be re-cataloged with DEFINE CLUSTER RECATALOG and SMS non-VSAM data sets must be re-cataloged using DEFINE NONVSAM RECATALOG); see the IBM IDCAMS manual for syntax details.

  • If you intend to restore the backup to a temporary volume serial but later relabel it back to the original volume serial (from the backup), use CPYVOLID=NO with VOLRESET=NO.

Default: NO.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*