RESTVOL

The RESTVOL command restores a volume from a volume full dump, either to the same target volume name or to a different target volume.

Logic

You can restore only one volume per request. You must always specify the NEWVOL parameter to avoid accidental override of the source volume.

M9CLI RESTVOL <volume> NEWVol(<volume>)
 [DATE(yyyy/mm/dd)|DATERange(yyyy/mm/dd-yyyy/mm/dd)]
 [ENTry(<integer>)|UNIQueid(<uniqueId>)]
 [COPYVolid]

Related topic

CLI-command-reference

Required parameters

Parameter

Description

volume

A specific volume serial to be restored

NEWVol

The target volume serial

You must specify the target volume even when it’s the same as the source, to avoid accidental overriding a live volume. If the target volume is different from the source volume, you must specify COPYVOLID.

Optional parameters

Option (short option)

Description

Format

Examples

DATE

Requests for volume full dump copy that was created on a specific date only

DATE and DATERange are mutually exclusive.

yyyy/mm/dd

2019/08/15

DATERange

Requests for volume full dump copy that was created on a specific date range

DATERange and DATE are mutually exclusive.

yyyy/mm/dd-yyyy/mm/dd

2019/01/01-2019/08/15

ENTry

A positive sequential number from 0, 1, 2 and so on, representing the available entries of a volume full dump copy, according to the specified criteria

integer

0—The latest copy (default).

1—The copy prior to the latest, and so on.

UNIQueid

An 8-character ID that when combined with the volume name identifies each volume full dump copy

Using UNIQueid, you can refer to a specific copy without having to specify any additional filters.

UNIQueid and ENTRY are mutually exclusive.

8 characters

You can take the UNIQueid from a previous LISTVOL command’s output and use it in RESTVOL.

COPYVolid

Specifies that the volume serial number (VOLID) from the input volume is to be copied to the output volume

This parameter is required when restoring a source volume to a different target volume. The target volume is specified in the required parameter NEWVOL.

NA

NA

Output

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

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

If the request fails, the complete DFDSS 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.

Examples

The following examples demonstrate use of the command.

Restoring the latest available volume full dump copy, without replace

Example:

By default, the restore takes the latest copy and restores it to the target volume, as specified by the NEWVOL parameter.

M9CLI RESTVOL M9RES1 NEWV(M9TST1)

Restoring a volume full dump copy, with replace

Example:

When replacing the source volume with the volume full dump copy, use the COPYVOLID parameter.

M9CLI RESTVOL M9RES1 NEWV(M9RES1) COPYVOLID

Restoring a volume full dump copy from a specific date

Example:

The selected copy for restore will be the latest copy created on that date, unless specified otherwise (see examples using ENTRY or UNIQUEID).

M9CLI RESTVOL M9RES1 NEWV(M9TST1) DATE(2020/04/24)

Restoring a volume full dump copy from a date range

Example:

The selected copy for restore will be the latest copy created within the date range, unless specified otherwise (see examples using ENTRY or UNIQUEID).

M9CLI RESTVOL M9RES1 NEWV(M9TST1) DATER(2020/04/24-2020/04/01)

Restoring a volume full dump copy using ENTRY or UNIQUEID

Example:

When restoring a volume full dump copy other than the latest, we recommend that you specify LISTVOL first for the available copies:

Listing Volume: M9RES1

  ENTRY DATE   TIME     SIZE   UNIQUEID
  ----- ---------- --------- ------ --------
      0 2020/04/24 11:05:30 32790  DK4FSJ4K
      1 2020/04/24 08:10:11  32790  NX300X23
      2 2020/04/24 07:30:06 32790  F2065KSF
      3 2020/04/24 07:00:15 32790  W34DP4KF

You can run the restore by using the same search criteria specified on the LIST command, where the specific copy is selected using ENTRY:

M9CLI RESTVOL M9RES1 NEWV(M9TST1) DATE(2020/04/24) ENTRY(2)

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

M9CLI RESTVOL M9RES1 NEWV(M9TST1) UNIQUEID(F2065KSF)

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*