FDRABR Restore Job Control Requirements

The following Job Control Statements are necessary to perform restore from ABR Volume Backups:

STEPLIB or JOBLIB DD statement

If FDR is not in the system link list (LNKLST), specifies the program library in which FDRABR resides. The library must be APF authorized.

EXEC statement

Specifies the program name (PGM=FDRABR), region requirement (REGION=), and optional PARM= operand. The minimum region required is 512K. However, some restore options, especially logical restore, may increase the region requirement, so REGION=0M is recommended to get the largest below-the-line region available.

If a PARM= field is specified, ABR uses data specified as the first control statement, which must be a valid RESTORE statement; if the PARM= data contains a slash “/”, the data after the slash is used as the second control statement (usually a SELECT). For example,

//FDR EXEC PGM=FDRABR,PARM='RESTORE TYPE=FDR,CONFMESS=NO' //FDR EXEC PGM=FDRABR,PARM='RESTORE TYPE=ABR/ SELECT DSN=A.B.C'

If FDRABR is invoked from a user program, Register 1 must follow IBM's convention for passing data from the PARM field.

ABRREST DD statement

Specifies the remote queue data set for restores from the backup subsystem. This data set is optional. If specified, ABR reads the control statements contained within, if any, and append these statements to the SYSIN data set. The SYSIN data set must contain at least a RESTORE TYPE=ABR statement. If the operation is not a data set restore from the backup system, this file is ignored. After reading the control statements, ABR resets the file to null (empty) data set except on SIMREST.

Important

The TSO/ISPF panels (FDRABRM-ISPF-Interface) or program FDRABRUT ( Remote Queue Utility (FDRABRUT) in Archive-Restore-Examples ) write to these remote queue data sets. Specify DISP=SHR for ABRREST, since ABR internally controls access to this data set.

DISKxxxx DD statement

For ABR full-volume restore (RESTORE TYPE=FDR) a DISKxxxx DD statement must be provided for each DASD volume being restored unless the ONLINE operand is specified on the RESTORE statement. For example:

//DISK1234 DD UNIT=SYSALLDA,VOL=SER=DSK123,DISP=OLD

For data set restores, DISKxxxx DD statements are not used; ABR dynamically allocates any required output volumes. Even if DISKxxxx DD statements are present, they do not influence ABR’s choice of output volumes (see ABR Data Set Restore Procedure in Set-RESTORE-Statement).

FDREMAIL DD statement

Specifies input control statements for the FDR e-mail facility. If present, e-mail messages can be sent for unsuccessful or successful FDR operations. For more information, see FDR-E-mail-Notification-Facility.

FDRSUMM DD statement

(Optional) if present, ABR writes one-line messages for each volume restored, giving result codes, elapsed time, and byte counts. Usually a SYSOUT data set. It is used only for full-volume restores, not data set restores.

SYSIN DD statement

Specifies a data set containing the control statements for ABR. Usually a DD * data set. It is required, but if control statements were provided on the EXEC statement by PARM=, it can be DUMMY.

SYSPRINT DD statement

Specifies the output message data set; it is required. It is usually a SYSOUT data set but if it is assigned to a data set on tape or DASD, this DD statement must specify DISP=MOD. DCB characteristics are RECFM=FBA and LRECL=121; the block size defaults to 1210 on DASD or tape.

SYSUDUMP DD statement

Specifies the abend dump data set. Usually specifies a SYSOUT data set. Although not required, we strongly urge you to always include this DD statement, so that we can help you diagnose error conditions. If you have a debugging aid product on your system that would prevent the desired dump, please add the appropriate one of these statements to the JCL so that a fully-formatted dump is produced.

//ABNLDUMP DD DUMMY Print normal IBM dump in addition to the Abend-AID Report //CAOESTOP DD DUMMY Turn off CA OPT II & CA SYMDUMP //DMBENAN DD DUMMY Turn off DumpMaster //ESPYIBM DD DUMMY Turn off Eye-Spy //IDIOFF DD DUMMY Turn off IBM Fault Analyzer

TAPEx DD statement

Allocates an input tape drive to be used for the RESTORE operation. “x” may be 1 alphanumeric (A-Z, 0-9) or national (@ and $ in the US) characters. The national character “#” and its international equivalents are reserved for ABR dynamic allocation. This tape drive must be capable of reading all the tapes needed for this restore; if the tapes are in varying formats, such as 3490E and 3590, the restore fails (see DYNTAPE Note below).

Although this DD statement allocates a tape drive, ABR internally fills in the data set name, volume serials, and file number before it opens each tape file, so you do not have to provide any information about the backups to be read. However, z/OS requires that you provide:

DSN=

Provide any dummy data set name. It is not used by ABR, but z/OS enqueues on this name so multiple ABR restore jobs must use unique names.

VOL=SER=

Provide a dummy volume serial, for example, (VOL=SER=DUMMY).

UNIT=(xxxx,,DEFER)

This allocates the proper tape drive type (xxxx) but does not try to mount the dummy volume serial.

DISP=(OLD,KEEP)

Required.

Only the first TAPEx DD statement provided is used by ABR during a RESTORE. For example,

//TAPE1 DD DSN=FDR,VOL=SER=FDR, // UNIT=(TAPE,,DEFER),DISP=(OLD,KEEP)