LISTVOL
Related topic
The LISTVOL command lists the full volume dump copies of a specified volume or volumes.
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 following details are displayed:
- Time and date of the full dump
- Original size of the volume in cylinders
- Expiration date of the full dump
In addition, you can specify ENTry and UNIQUEID are to reference a specific full volume 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 | Specifies full volume dump copies that were created on a specific date only DATE and DATERange are mutually exclusive. | yyyy/mm/dd | 2019/08/15 |
DATERange | Specifies full volume 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 full volume 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 full volume 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 full volume 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 full volume dump copy was created | yyyy/mm/dd |
TIME | Local time at which the full volume dump copy was created | hh:mm:ss |
CYLINDARS | Original size, in volume cylinders | integer |
| EXPIRATION | The current expiration date of the full volume dump | yyyy/mm/dd NONE—The expiration date was not specified by either the catalog, VTOC or SMS N/A—The expiration date is not applicable for this type. |
UNIQUEID | 8-character value to uniquely identify the full volume 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