RESTVOL
Logic
You can restore only one volume per request. You must always specify the NEWVOL parameter to avoid accidental override of the source volume.
[DATE(yyyy/mm/dd)|DATERange(yyyy/mm/dd-yyyy/mm/dd)]
[ENTry(<integer>)|UNIQueid(<uniqueId>)]
[COPYVolid]
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:
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
Restoring a volume full dump copy, with replace
Restoring a volume full dump copy from a specific date
Restoring a volume full dump copy from a date range
Restoring a volume full dump copy using ENTRY or UNIQUEID