lsvol

Use the lsvol command to list all volumes on a system, list a specific volume or volumes, or list volumes on a specific array.

Syntax

Parameters and arguments

-user user_name: Specifies an IBM Spectrum Control user ID.
-pwd password: Specifies the password for the IBM Spectrum Control user ID.
-url url: Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-dev GUID: Specifies the storage subsystem. The GUID variable is the globally unique identifier (GUID).
array array: Specifies the array. The array variable is the array ID. You can use the lsarray command to return information, including array IDs, about the arrays on a specific storage subsystem.
-l: Specifies that long information is listed. In addition to the volume ID, the volume size and FlashCopy® relationship information are listed. Also includes the user defined properties: UDP1, UDP2 and UDP3.
The user-defined property (UDP) contains anything of significance to the group administrator. This alphanumeric character string must contain fewer than 255 characters in length.
-fs character: Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
-header: Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-help | -h | -?: Lists help information for the command.
-qs character: Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
-silent: Suppresses all output for the command. If you omit this parameter, output is included.
volume id | -: Specifies the volumes. The volume_ID variable is a comma-separated list of volume IDs, such as that obtained by running the lsvol command. If a single dash (-) is issued, the volume IDs are read from standard input.

Example: Listing the volumes on a subsystem

The following command lists all volumes on a specified subsystem. The -dev parameter specifies your system. More information for the volumes can be displayed as specified with the -l parameter.

tpctool> lsvol -user me -pwd mypass -url myhost:9550 -dev 2107.75DG000+0 -l

The following output is returned:

ID		                                    Label	                    Size  Format
==============================================================================
IBM.2107-75DG000-111e+1+2107.75DG000+0	 Sample_Vol_111E (ID:111e)	100   FB
IBM.2107-75DG000-111d+1+2107.75DG000+0	 Sample_Vol_111D (ID:111d)	100   FB
IBM.2107-75DG000-111c+1+2107.75DG000+0  Sample_Vol_111C (ID:111c) 100   FB

FlashCopy	             RealUsed	            Encrypted
=====================================================
UNAVAILABLE            100                   No
UNAVAILABLE            100                   No
UNAVAILABLE            100                   No

UDP1		             UDP2		               UDP3
=====================================================
Sample             HostA                 -
Sample             HostA                 -
Sample             HostA                 -

FlashCopy

Indicates if the volume is in a FlashCopy relationship and whether it is a FlashCopy source or target. Volumes that are not in a FlashCopy relationship are displayed with a blank value. If information about the copy relationship of a volume is not available, UNAVAILABLE is displayed.

Note:

This value is available for volumes of the following systems only: IBM System Storage DS8000 and IBM SAN Volume Controller.

Real Used

Indicates the amount of space, in gigabytes, that a volume uses. IBM Spectrum Control allocates the entire space for standard-provisioned volumes when they are created. For thin-provisioned volumes, it does not. This column displays the space that is being used.

Note:

If a system is new and there is no data in the volumes, the value is zero. For example, the Size field might show 16 GB but the Real Used is 0.
For non-thin provisioned volumes, the Real Used value always matches the Size value.
Thin provisioned volumes always have an asterisk before their name (Label).
Thin provisioned volumes of other storage systems are not supported by IBM Spectrum Control. The Real Used value is displayed as N/A.

Encrypted

Indicates if the volumes are on encrypted disks (Yes or No).

UDP1

The user-defined property (UDP) contains anything of significance to the group administrator. This alphanumeric character string must contain fewer than 255 characters in length.

UDP2

The user-defined property (UDP) contains anything of significance to the group administrator. This alphanumeric character string must contain fewer than 255 characters in length.

UDP3

The user-defined property (UDP) contains anything of significance to the group administrator. This alphanumeric character string must contain fewer than 255 characters in length.