LISTVOL
LISTVOL - Syntax
[DATE(yyyy/mm/dd)|DATERange(yyyy/mm/dd-yyyy/mm/dd)]
[UNIQueid(<uniqueId>|ENTry(<integer>)]
LISTVOL - Required parameters
Parameter | Description |
|---|---|
volumePattern | A volume or a group of volumes, specified by a pattern Specify a pattern using: %,*,**, e.g.:SYSRES, SYSRE*, DBA%LG For more information about how to specify a pattern, see Identifying the data set and volume for the command. |
LISTVOL - Optional Parameters
Option[Short option] | Description | Format | Examples |
|---|---|---|---|
DATE | Requests volume full dump copies that were created on a specific date only. DATE and DATERANGE are mutually exclusive. | yyyy/mm/dd | 2019/08/15 |
DATERANGE[DATER] | Requests volume full dump copies that were created within 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. The entries are relative to the selection used in the LISTVOL command. When listing a pattern, ENTRY will be displayed per volume. | <integer> | 0—The latest copy (default) 1—The copy prior to the latest, and so on. |
UNIQueid[UNIQ] | An 8-character that when combined with the volume name identifies each volume full dump copy. Using the 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 subsequent commands, such as RESTVOL. |
LISTVOL - Output
The LIST output displays the given LIST commands and parameters, followed by the requested information. For every filtered volume, a headline is displayed with the name of the volume, followed by a list of the available volume full dump copies.
For each record on the list, the following details are displayed:
Column | Description | Available values |
|---|---|---|
ENTRY | An integer representing the sequence of the displayed list. The entries are relative to the filter used in the LISTVOL command. | 0,1,2,...— a full dump copy, available for restore |
DATE | The date on which the volume full dump copy was created | yyyy/mm/dd |
TIME | The local time at which the volume full dump copy was created | hh:mm:ss |
SIZE | Original size, in volume cylinders | <integer> |
UNIQUEID | An 8-character value to be used to uniquely identify the volume full dump copy. | 8 characters |
LISTVOL - Examples
The following examples demonstrate use of the command.
Listing a specific volume’s full dump copies
Listing a volume’s full dump copies created on a specific date
Listing a volume’s full dump copies created within a date range
