DSM/Tape Catalog Management Programming Manual

Common Definitions
DSM/Tape Catalog Management Programming Manual—520481-003
4-57
ZMCS Maps
ZMCS-MAP-RECOVER-DISKFILE
MEDIASRV includes this extensible structured token in RECOVER DISKFILE
commands to describe parameters used when copying one or more disk files from one
backup tape set to disk. ZMCS-MAP-RECOVER-DISKFILE is based on ZMCS-DDL-
RECOVER-DISKFILE, which is defined as:
ZGENERATION
corresponds to the GEN parameter of the MEDIACOM RECOVER DISKFILE
command. ZGENERATION denotes which generation of the tape file ID is used to
recover the disk file.
A number from 1 through 32767 is used as an absolute value.
A negative number in the range -1 through -32768 denotes a relative value. The
default is -1, which represents the most recent generation.
ZGENISPRESENT
contains a status of TRUE or FALSE. ZGENISPRESENT must contain TRUE
whenever an absolute value is present for ZGENERATION.
ZTIMEDUMPED
corresponds to the TIME parameter of the MEDIACOM RECOVER DISKFILE
command. ZTIMEDUMPED denotes the ending point for the information retrieved
in the form of a date (month day year, or day month year) or date and
optional time (hh:mm:ss, or hh:ss). If time was not specified, the default time is
seen as 00:00:00.
Only disk file entries cataloged before the date and time specified are used to
recover the disk file.
ZOVERRIDE
corresponds to the OVERRIDE parameter of the MEDIACOM RECOVER
DISKFILE command. ZOVERRIDE (ON or OFF) denotes whether approval is
necessary for the RECOVER DISKFILE command to continue after it has located
the catalog information for the disk file name.
•
ON means no approval is necessary. After RECOVER DISKFILE determines
which backup tape or tapes to use, it executes a RESTORE run command to
copy the disk file or files from tape to disk.
def ZMCS-DDL-RECOVER-DISKFILE.
02 ZGENERATION type ZMCS-DDL-GENERATION.
02 ZGENISPRESENT type ZSPI-DDL-BOOLEAN.
02 ZTIMEDUMPED type ZSPI-DDL-BOOLEAN.
02 ZOVERRIDE type ZSPI-DDL-BOOLEAN.
end.