lsvol

Parameters

-help | -h | -?

Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.

-s

Displays default information for each volume, including the name, ID, device, manufacturer, volume type, and whether the volume is protected and space efficient.

-l

Displays the following detailed information for each volume.

Column Label	Details
Name	The volume name.
ID	The volume ID. The volume ID is displayed regardless of whether you provide the volume ID or name for the volume parameter.
Device	The ID of the storage system
Manufacturer	The manufacturer of the storage system. Currently, only IBM® storage systems are supported.
Type	The values CKD for count key data or FB for fixed block. The value that is displayed depends on the storage system type.
Protected	Yes if the volume is protected. No if the volume is not protected.
Space Efficient	Yes if the volume is a space-efficient volume.No if the volume is not a space-efficient volume.
Format	Volume format
LSS/IO Group/Pool	The logical subsystem (LSS), IO group, or pool. The value that is displayed depends on the storage system type.
Size	The volume size.
Size Unit	The unit of measure that the capacity is given in, either gigabytes or cylinders.
Is Z Attached	Identifies whether the volumes are connected through an IBM z/OS® connection.
Locked	Indicates whether the volume is locked. Applies only to FlashSystem/IBM Spectrum Accelerate.
Device number	Indicates the device number.

-fmt { default | xml | delim | stanza }

Specifies the format of the output. You can specify one of these values:

default

Specifies that the output is displayed in tabular format using spaces as delimiters between columns. This is the default value.

xml

Specifies that the output is displayed in XML format.

delim

Specifies that output is displayed in a tabular format using commas as delimiters between columns.

To use a character other than a comma as the delimiter, specify -fmt delim -delim char , where char represents the character that you want to use as the delimiter. For example, if you want to use a colon (:) as the delimiter, use the following -fmt parameter:

-fmt delim -delim :

If you use a shell metacharacter as the delimiting character, enclose the character in quotation marks or single quotation marks. A blank space is not a valid character.

stanza

Specifies that the output is displayed as one keyword-value pair per line.

-p { on | off }

Specifies whether to display one page of text at a time or all text at once.

on

Displays one page of text at a time. Pressing any key displays the next page. This is the default value when the command is run in interactive mode.

off

Displays all text at once. This is the default value when the command is run in single-shot mode.

-hdr { on | off }

Specifies whether to display the table header. You can specify one of these values:

on

Displays the table header. This is the default value.

off

Hides the table header.

-r number

Specifies the number of rows per page to display when the -p parameter is specified. You can specify a value of 1 - 100. The default value is 22.

-v { on | off }

Specifies whether to enable verbose mode. You can specify one of these values:

on

Enables verbose mode.

off

Disables verbose mode. This is the default value.

-devtype { ds | ess | storwize-v3500 | storwize-v3700 | storwize-v5000 | storwize-v7000 | flashsystem-v9000 | flashsystem-v840 | svc | flashsystem-a9000 | flashsystem-9100| flashsystem-9200| xiv }

Specifies volumes by storage system type. The parameter values are:

• ds: IBM DS8000®
• ess: IBM TotalStorage Enterprise Storage Server® Model 800
• storwize-v3500: IBM Storwize® V3500
• storwize-v3700: IBM Storwize V3700
• storwize-v5000: IBM Storwize V5000
• storwize-v7000: IBM Storwize V7000 and IBM Storwize V7000 Unified
• flashsystem-v9000: IBM FlashSystem V9000
• flashsystem-v840: IBM FlashSystem V840
• svc: IBM System Storage SAN Volume Controller
• flashsystem-a9000: IBM FlashSystem® A9000
• flashsystem-9100: IBM FlashSystem 9100
• flashsystem-9200: IBM FlashSystem 9200
• xiv: The FlashSystem/IBM Spectrum Accelerate

-dev dev_ id

Specifies volumes by storage system ID.

-protected

Specifies that only protected volumes, or volumes that cannot be used in an add copy set action, are shown.

-unprotected

Specifies that only unprotected volumes, or volumes that can be used in an add copy set action, are shown.

volume_id | volume_name | -

Specifies the volume for which data is listed. The same volume can be in multiple groups but not multiple pools.

For IBM DS8000 and TotalStorage Enterprise Storage Server Model 800 storage systems, use the volume ID for this parameter.

For other storage systems, you can use the volume ID or name for this parameter.

Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin). The dash is supported only in single-shot mode.