lspool

Use the lspool command to list all file system pools that are on a specified Storwize V7000 Unified storage system. You can also list the pools by file system.

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 dev_id | -filesystem file_system_id... | -pool pool_id...

The -dev parameter specifies that information is displayed for all pools that are associated with a storage system. This parameter requires the globally unique identifier (GUID) of the storage system. You can use the lsdev command to return information, including the GUID, for all storage systems that were discovered.

The -filesystem parameter specifies that information is displayed only for pools that are associated with specific file systems. You can enter one or multiple file system IDs. Use a comma to separate multiple IDs. You can use the lsfs command to return information, including the file system IDs, for all file systems that were discovered.

The -pool parameter specifies that information is displayed only for specific pools. You can enter one or multiple pool IDs. Use a comma to separate multiple IDs.

-l

Specifies that the following information is listed.

ID: An ID for the pool that is composed of the pool name, storage system name, and storage system format.
Pool: The name of the pool.
Capacity (GB): The capacity of the pool.
Available Space (GB): The amount of unused space that is in the pool.

If you omit this parameter, only the ID is returned.

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

-grouping

Enables the grouping of numeric values. For example, in English, the value 12000 displays as 12,000. The grouping character is determined by the system locale.

Example: List all file system pools that are on a storage system

The following command generates a list of all file system pools that are on a Storwize V7000 Unified storage system.

tpctool> lspool -dev 00000200A0E0005C+0 -l

The following output is returned:

ID                        Pool   Capacity (GB) Available Space (GB)
===================================================================
system+00000200A0E0005C+0 system        21400              20109.43