TSO Command Processor › DRESTORE — Deferred Restore › DRESTORE Command

DRESTORE Command

The DRESTORE command requests the deferred restoring of a data set.

The DRESTORE command syntax is:

DRESTORE	{DSN(data set names)}

{NEWNAME(newname)}
{VERSION(-nn)}
{TIMEDATE(hhmmdate)}
{VOLUME(volser)}
{POOL(name)}
[NOCATALOG]
[RECATALOG]
[SCRATCH]
[ERASE]
{PASSWORD(password)}

DSN

A list of one to ten names of data sets to be restored. The DSN can be eliminated from the command line and a prompt for a data-set name list will be issued. The VERSION or TIMEDATE parameter can be used to designate other than the most recently archived version of a data set.

NEWNAME

To change the name of the data set being restored, this parameter must be specified.

VERSION

Specify -1 to -99 to restore the progressively older version of the data set to be restored. The absence of this parameter and the TIMEDATE parameter will default to restoring the most current version of the data set.

TIMEDATE

This parameter provides a more precise technique for designating a version of a data set to be restored. The format is hhmmdate, where hhmm is 24 hour time and date is any acceptable CA Disk date format, described in the section Date Formats in the chapter "General Information." The values can be obtained from either the batch LISTD or TSO LISTDMS index listing for the data set.

VOLUME

This parameter can be specified to restore to a volume other than the original source volume.

POOL

To cause the data set to be restored to a volume belonging to a predefined POOL of volumes, this parameter is required.

NOCATALOG

The inclusion of this parameter prevents the data set from being cataloged after it has been successfully restored.

RECATALOG

Default processing attempts to catalog all data sets, but will not change an existing catalog entry. Specify this parameter only when you want to force the data set to be cataloged to the target volume.

SCRATCH

If the data set already exists on the target volume, this parameter causes it to be scratched and then reallocated.

ERASE

This parameter will cause the directory of a preallocated partitioned data set to be formatted before being used.

PASSWORD

The password parameter provides the password value required to access a protected VSAM cluster. If the cluster is to be restored but not scratched, the update-level or higher is required. If the cluster is to be scratched, the master-level password is required.