lspool
Use the lspool command to list pools that are on FlashSystems/IBM Spectrum Accelerate.
Syntax
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.
- 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