LISTVOL
Logic
When the command lists a pattern of volumes, the copies in each volume are displayed separately, from the most current copy to the oldest.
The list includes the time and date of the full dump, and the original size of the volume in cylinders. In addition, you can specify ENTry and UNIQUEID are to reference a specific volume full dump copy in subsequent commands.
Syntax
[DATE(yyyy/mm/dd)|DATERange(yyyy/mm/dd-yyyy/mm/dd)]
[UNIQueid(<uniqueId>|ENTry(<integer>)]
Required parameters
Parameter | Description |
|---|---|
volumePattern | A volume or a group of volumes, specified by a pattern You can specify a pattern by using %, *, or **. For example, SYSRE*, or DBA%LG For more information about how to specify a pattern, see Specifying-the-data-set-or-volume-for-the-CLI-command. |
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 | 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 | 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 is displayed per volume. | integer | 0—The latest copy (default) 1—The copy prior to the latest, and so on. |
UNIQueid | 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 | You can take UNIQueid from a previous LISTVOL command’s output and use it in subsequent commands, such as RESTVOL. |
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 | 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 | Date on which the volume full dump copy was created | yyyy/mm/dd |
TIME | Local time at which the volume full dump copy was created | hh:mm:ss |
SIZE | Original size, in volume cylinders | integer |
UNIQUEID | 8-character value to uniquely identify the volume full dump copy | 8 characters |
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