lspool

Use the lspool command to list pools that are on FlashSystems/IBM Spectrum Accelerate.

Syntax

Read syntax diagramSkip visual syntax diagramlspool-help-h-?-s-l-fmtdefaultxmldelim-delimcharstanza-ponoff-hdronoff-rnumber-voffon-devdevice_ID-devicename device_name

Parameters

-help | -h | -?
Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-s | -l
Displays the following information:
Column Label Details
Device Name The name of the FlashSystem/IBM Spectrum Accelerate that contains the pools.
Device ID The ID of the FlashSystem/IBM Spectrum Accelerate that contains the pools.
Pool Name The name of the pool.
Pool ID The ID for the pool.
-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.
-dev device_ID and -devicename device_name
Both of these parameters specify that only pools on a specific storage system are displayed. The -dev parameter specifies that the storage system is determined by the ID for the system. The -devicename parameter specifies that the storage system is determined by the name of the storage system.

The -dev and -devicename parameters are mutually exclusive.

If the -dev or -devicename parameter is not provided, the output shows the pools for all FlashSystems/IBM Spectrum Accelerate.

Example: Listing pools on all FlashSystems/IBM Spectrum Accelerate

The following command lists the pools that are on all FlashSystems/IBM Spectrum Accelerate.

csmcli> lspool -l

The following output is returned:

Device Name         Device ID             Pool Name       Pool ID
=================================================================================
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool1     XIV:POOL:1300202:100929
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool2     XIV:POOL:1300202:100930
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool3     XIV:POOL:1300202:100931
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool4     XIV:POOL:1300202:112412
XIV_B               XIV:BOX:1566078       healthcare      XIV:POOL:1566078:436473
XIV_B               XIV:BOX:1566078       mysnappool1     XIV:POOL:1566078:436474
XIV_B               XIV:BOX:1566078       yogapool        XIV:POOL:1566078:436475

Example: Listing pools on a specific FlashSystem/IBM Spectrum Accelerate by storage system ID

The following command lists the pools that are on the FlashSystem/IBM Spectrum Accelerate with the ID XIV:BOX:1300202.

csmcli> lspool -dev XIV:BOX:1300202 -l

The following output is returned:

Device Name         Device ID             Pool Name       Pool ID
=================================================================================
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool1     XIV:POOL:1300202:100929
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool2     XIV:POOL:1300202:100930
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool3     XIV:POOL:1300202:100931
XIV 1300202 Troy    XIV:BOX:1300202       mysnappool4     XIV:POOL:1300202:112412

Example: Listing pools on a specific FlashSystem/IBM Spectrum Accelerate by storage system name

The following command lists the pools that are on the FlashSystem/IBM Spectrum Accelerate that is named XIV:BOX:1300202 Troy.

csmcli> lspool -devicename 'XIV:BOX:1300202 Troy'

The following output is returned:

Device Name         Device ID            Pool Name       Pool ID
=================================================================================
XIV 1300202 Troy    XIV:BOX:1300202      mysnappool1     XIV:POOL:1300202:100929
XIV 1300202 Troy    XIV:BOX:1300202      mysnappool2     XIV:POOL:1300202:100930
XIV 1300202 Troy    XIV:BOX:1300202      mysnappool3     XIV:POOL:1300202:100931
XIV 1300202 Troy    XIV:BOX:1300202      mysnappool4     XIV:POOL:1300202:112412