RESTDSN

The RESTDSN command restores a data set backup copy, either from an incremental backup or from a volume full dump.

RESTDSN - Logic

Only one data set can be restored per request. Unless specified otherwise, the RESTDSN does not replace the source data set, and does catalog the restored target copy. By default, the most current backup copy is restored.

RESTDSN - Syntax

M9CLI RESTDSN <dsname> [VOLume(<volumePattern>)]
 [DATE(yyyy/mm/dd)|DATERange(yyyy/mm/dd-yyyy/mm/dd)]
 [ENTry(<integer>)|UNIQueid(<uniqueId>)] 
 [NEWVol(<volume>)] 
 [NEWName(<dsname>)] 
 [NEWMClass(<managementClass>)|NULLMC]
 [NEWSClass(<storageClass>)|NULLSC]
 [BYPASSACS]
 [NODUMP]
 [NOCATalog] 
 [REPLace]

RESTDSN - Required parameters

RESTDSN - Optional Parameters

RESTDSN - Output

The output displays the given RESTDSN command and parameters, followed by the requested information:

DATA SET <dsname> WAS RESTORED FROM A BACKUP COPY MADE ON <yyyy/mm/dd> at <hh:mm:ss>

DATA SET <dsname> WAS RESTORED FROM A FULL VOLUME DUMP MADE ON <yyyy/mm/dd> at <hh:mm:ss>

If the request fails, the complete log will be displayed. If the requesting user is not available, the first 100 records of the output will be printed in the executing agent's log.

RESTDSN - Examples

The following examples demonstrate various ways to use the command.

Restoring the latest copy of a data set with a new name

TSO M9CLI RESTDSN M9.USER.SOURCE NEWNAME(M9.USER.SOURCE.PREVIOUS)

Restoring the latest copy of a data set with replace

TSO M9CLI RESTDSN M9.USER.SOURCE REPLACE

Restoring the latest copy of a data set, requesting to use only incremental backup as the input

TSO M9CLI RESTDSN M9.USER.SOURCE NEWNAME(M9.USER.SOURCE.PREVIOUS) NODUMP

Restoring the latest copy of a data set with the same name, on a new volume, without cataloging

TSO M9CLI RESTDSN M9.USER.SOURCE NEWVOL(M9USER) NOCAT

Restoring the latest copy of a data set with specific management class and storage class as input to the ACS routines

TSO M9CLI RESTDSN M9.USER.SOURCE NEWMC(M9PRODMC) NEWSC(M9PRODSC)

Restoring a non-cataloged data set within a date range using ENTRY or UNIQUEID

When restoring a data set other than the latest, LISTDSN the volume first for the available copies:

The restore can be executed using the same search criteria specified on the LIST command, where the specific copy is selected using ENTRY:

M9CLI RESTDSN SYS1.PARMLIB VOL(M9RES1) DATER(2019/06/30-2019/06/01) ENTRY(2) NOCAT

There is no need to specify any additional search criteria when using the UNIQUEID parameter:

M9CLI RESTDSN SYS1.PARMLIB VOL(M9RES1) UNIQUEID(F9E717CE) NOCAT

Last updated