CA Dynam for VSE User Guide

Disk File Maintenance Utilities
These operands are mutually exclusive:
'file-id'
file-id* Identifies the specific file ID or group of file IDs to be selected from the
tape volume and restored. Each file is restored to its original extents.
For generation data sets, you must specify the desired generation by
indicating its absolute generation number in parentheses, such as (G#nn).
VOL=volser
Restores all files from the tape to the specified disk volume. The volser must
be specified as a six-character real volume serial number. A pool or generic
volume serial number is not allowed. This is a full volume RESTORE command.
Optional Parameters
These operands are optional and mutually exclusive except OLDVOL and
REPLACE, which are also optional but can be used with any one of the others.
If the UNEXPIRED command is combined with PERM, RETAIN, or EXPIRE, then
the UNEXPIRED command takes precedence. When PERM, RETAIN, and
EXPIRE are specified together, only those files satisfying all three conditions
are restored. If none of these operands (EXPIRE, PERM, RETAIN, UNEXPIRED)
are specified, DYNUTIL selects all files for transfer to tape.
EXPIRE=yy/ddd|yyyy/ddd
Restores only those files whose expiration date equals or exceeds the specified
expiration date (yy or yyyy is the year, and ddd is a day of that year).
PERM
RETAIN
UNEXPIRED
OLDVOL=xxxxxx
REPLACE
Restores only files with an expiration date equal to the date specified in the
AUTODTE parameter of the DYNAM/D option record.
Restores only files with an expiration date equal to the date specified in the
MANDTE parameter of the DYNAM/D option record.
Restores only those files whose expiration date is the same as or exceeds the
current date.
Restores files to the same physical location that they occupied on the old
volume. The original volume serial number from which the disk files were
dumped is indicated by xxxxxx. It is used only when the DUMP disk volume
serial number differs from the RESTORE disk volume serial number. It can only
be used for a full volume RESTORE; the input tape must be a full volume
DUMP tape. And, the old and new DASD devices must be of the same type.
Causes each file on the tape to automatically overwrite the disk file of an equal
file ID. If you omit this parameter and an equal file ID exists on the VTOC, the
following message is issued and the file is not changed:
CADD548E DUPLICATE FILE-ID ON VOLUME=xxxxxx
5–38 User Guide