Archive Restore Job Control Requirements

The following Job Control Statements are necessary to perform manual restore from Archive 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. 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,

//FDRABR EXEC PGM=FDRABR,PARM='RESTORE TYPE=ARC' //FDRABR EXEC PGM=FDRABR,PARM='RESTORE TYPE=ARC/ 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.

ABRARCH DD statement

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

Important

The TSO/ISPF panels or program FDRABRUT write to these remote queue data sets (see Remote-Queue-Utility-FDRABRUT). DISP=SHR should be specified for ABRARCH, since ABR internally controls access to this data set

ARCHIVE DD statement

Specifies the ABR Archive Control File. This DD statement is required for restores from Archive Backups unless the DYNARC operand is specified on the RESTORE statement. The standard name for this data set is FDRABR.ARCHIVE, but your installation may have chosen a different name. Specify DISP=SHR since ABR internally serializes access.

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. See FDR-E-mail-Notification-Facility for requirements and details.

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=120; 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 (@ $ 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 "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 will not be 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 an archive restore.

Example:

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