Cloud Data Manager

LISTVOL

The LISTVOL command lists the volume full dump copies of a specified volume or volumes.

LISTVOL - Logic

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.

LISTVOL - Syntax
M9CLI LISTVOL <volumePattern>
 [DATE(yyyy/mm/dd)|DATERange(yyyy/mm/dd-yyyy/mm/dd)]
 [UNIQueid(<uniqueId>|ENTry(<integer>)]
LISTVOL - Required parameters

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 .

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 - 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.

<xxxxxxxx> 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.

<xxxxxxxx>

LISTVOL - Examples

The following examples demonstrate use of the command.

Listing a specific volume’s full dump copies

CLI_LISTVOL_1.png

Listing a volume’s full dump copies created on a specific date

CLI_LISTVOL_2.png

Listing a volume’s full dump copies created within a date range

CLI_LISTVOL_3.png