RESTVOL
RESTVOL - Required parameters
Parameter | Description |
|---|---|
volume | A specific volume serial to be restored |
NEWVol(<volume>) | The target volume serial The target volume has to be specified even when it’s the same as the source, to avoid accidental overriding a live volume. When the target volume is different from the source volume, you must specify COPYVOLID. |
RESTVOL - Optional parameters
Option[Short option] | Description | Format | Examples |
|---|---|---|---|
DATE | Requesting 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[DATER] | Requesting 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[ENT] | 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[UNIQ] | 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 | UNIQueid can be taken from a previous LISTVOL command’s output, to be used in RESTVOL. |
COPYVOLID[COPYV] | Specifies that the volume serial number (VOLID) from the input volume is to be copied to the output volume This parameter is needed when restoring a source volume to a different target volume. The target volume is specified in the required parameter NEWVOL. | - | - |
RESTVOL - 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.
RESTVOL - Examples
The following examples demonstrate use of the command.
Restoring the latest available volume full dump copy, without replace
By default, the restore takes the latest copy and restores it to the target volume, as specified by the NEWVOL parameter.
Restoring a volume full dump copy, with replace
When replacing the source volume with the volume full dump copy, use the COPYVOLID parameter.
Restoring a volume full dump copy from a specific date
The selected copy for restore will be the latest copy created on that date, unless specified otherwise (see examples using ENTRY or UNIQUEID).
Restoring a volume full dump copy from a date range
The selected copy for restore will be the latest copy created within the date range, unless specified otherwise (see examples using ENTRY or UNIQUEID).
Restoring a volume full dump copy using ENTRY or UNIQUEID
When restoring a volume full dump copy other than the latest, it is recommended to LISTVOL 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:
There is no need to specify any additional search criteria when using the UNIQUEID parameter: