LISTVOL
The LISTVOL command lists the volume full dump copies of a specified volume or volumes.
When listing 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, ENTRY and UNIQUEID are specified to reference a specific volume full dump copy in subsequent commands.
M9CLI LISTVOL <volumePattern>
[DATE(yyyy/mm/dd)|DATERange(yyyy/mm/dd-yyyy/mm/dd)]
[UNIQueid(<uniqueId>|ENTry(<integer>)]
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 an explanation on the use of patterns, see: Identifying the data set / volume for the command . |
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 - for the latest copy (the default). 1 - for 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. |
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 |
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
Last modified 4mo ago