Explanation: DATE(yyyy/mm/dd), GENERATION(gennum), and VERSION(vernum) are mutually exclusive,
optional parameters specifying the particular backup version or dump
copy of one or more data sets you want to recover.
DATE(
yyyy/mm/dd) can be used to
specify the particular dump copy to be used for a restore. DATE applies
when recovering a backup version or dump copy of a specific data set
or an entire volume. For
yyyy/mm/dd, substitute the date
for the backup version or dump copy of the data set or volume that
you want to recover in the following form. A leading zero is not required
for a one-digit month or day. If DFSMShsm is recovering a data set,
it recovers the latest backup version that was created on or before
the date you specified. If DFSMShsm is recovering a volume, DFSMShsm
recovers the latest backup version of each data set that was backed
up on or after the date you specified. If DFSMShsm is recovering
a volume from a dump copy, the most recent dump copy made on or before
the date is selected. If DFSMShsm is recovering a data set from a
dump copy and the data set is cataloged, the most recent dump copy
made on or before the date is selected. If the data set is not cataloged,
there must be an incremental backup version created on or prior to
the date for the data set to be recovered from the dump copy.
- TIME(hhmmss)
- is an optional sub-parameter of DATE that specifies the exact
time in hours, minutes, and seconds (hhmmss) when the backup
version is created. The valid range for hours is 00–23, and
for minutes and seconds is 00–59. If you specify TIME, you must
also specify DATE, otherwise the RECOVER command fails. You must specify
a fully qualified data set name. You cannot specify TIME on a volume
recovery request. If a version with specified date and time cannot
be found, the command fails.
GENERATION(gennum) specifies that
you want to recover a particular incremental backup version of a specific
data set. For gennum, substitute the relative generation
number of the backup version of the data set to be recovered. A 0
specifies the latest version, 1 specifies the next to the latest version,
and so on, to the maximum number of versions existing for the data
set. The gennum can be up to 3 digits long.
VERSION(vernum) specifies that you
want to recover a particular version of a backed up data set. For vernum, substitute a decimal number from 1 to 999 for the particular
backup version you want to recover. If DFSMShsm is unable to find
the specified backup version, the recover fails and message ARC1128I
is issued.
Defaults: If you do not specify DATE, GENERATION,
or VERSION, DFSMShsm recovers the latest backup version of the data
set.
Note: - The GENERATION and VERSION parameters do not apply to volume recovery.
If you specify GENERATION or VERSION when it does not apply, DFSMShsm
ignores it.
- The GENERATION or VERSION parameters should not be specified if
FROMDUMP is specified.
- DATE should not be specified if DUMPVOLUME or DUMPGENERATION is
specified.
- If either the GENERATION or the VERSION parameter is specified,
DFSMShsm selects only from incremental backups and will not recover
from physical dump copies, even if the physical dump is more recent.
- To recover a retained backup version specify the date, and if
necessary, the time that the retained backup copy was created. You
cannot recover a retained copy with the GENERATION and VERSION keywords.