lspool

Displays a list of the existing storage pools and their attributes.

Read syntax diagramSkip visual syntax diagram
>>-lspool--+--------+--+-----------------------------+---------->
           +- -?----+  |        .-default----------. |
           +- -h----+  '- -fmt--+-delim--character-+-'
           '- -help-'           '-xml--------------'

>--+--------------+--+----------------+--+-------------+-------->
   |      .-off-. |  |        .-on--. |  '- -r--number-'
   '- -p--+-on--+-'  '- -hdr--+-off-+-'

>--+--------------+--+-----+--+---------------------+----------->
   |      .-off-. |  +- -l-+  '- -type--+-default-+-'
   '- -v--+-on--+-'  '- -s-'            +-system--+
                                        '-user----'

>--+---------------+-------------------------------------------><
   | .-----------. |
   | V           | |
   +---pool_name-+-+
   '- - -----------'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–fmt
Specifies the format of the output. You can specify one of the following values:
default
Specify this value to display output in a tabular format using spaces as the delimiter between the columns. This is the default value. For example:
Name    Type   Size (MB)  Used (MB)   Used (%)  Threshold (%)   Volumes
========================================================================
Pool1   User        1400        575         41             90         2
delim character
Specify this value to display output in a tabular format using the specified character to separate the columns. If you use a shell metacharacter (for example, * or \t) as the delimiting character, enclose the character in single quotation mark (') or double quotation mark ("). A blank space is not a valid character. For example:
Pool1,User,
xml
Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_StoragePool">
<PROPERTY NAME="Name" TYPE="string"><VALUE TYPE="string">Pool1</VALUE>
</PROPERTY>
<PROPERTY NAME="PoolType" TYPE="uint32"><VALUE TYPE="uint32">0</VALUE>
</PROPERTY>
<PROPERTY NAME="AlertPercentage" TYPE="uint16"><VALUE TYPE="uint16">90
</VALUE></PROPERTY>
<PROPERTY NAME="Size" TYPE="uint64"><VALUE TYPE="uint64">1400</VALUE>
</PROPERTY>
<PROPERTY NAME="SizeAllocated" TYPE="uint64"><VALUE TYPE="uint64">575
</VALUE></PROPERTY>
<PROPERTY NAME="SizeAllocatedPercentage" TYPE="uint16"><VALUE 
TYPE="uint16">41</VALUE></PROPERTY>
<PROPERTY NAME="NumberOfVolumes" TYPE="uint32"><VALUE TYPE="uint32">2
</VALUE></PROPERTY>
</INSTANCE>
</IRETURNVALUE>
–p
Specifies whether to display one page of text at a time or all text at once.
off
Displays all text at one time. This is the default value when the sfscli command is run in single-shot mode.
on
Displays one page of text at time. Pressing any key displays the next page. This is the default value when the sfscli command is run in interactive mode.
–hdr
Specifies whether to display the table header.
on
Displays the table header. This is the default value.
off
Does not display the table header.
–r number
Specifies the number of rows per page to display when the –p parameter is on. The default is 24 rows. You can specify a value from 1 to 100.
–v
Specifies whether to enable verbose mode.
off
Disables verbose mode. This is the default value.
on
Enables verbose mode.
–l
Displays additional information about the storage pools.
–s
Displays only the names of the storage pools. This is the default.
–type
Displays information for only those storage pools that match the specified type. If not specified, all storage pools are displayed. Possible types are:
default
Displays information for the default storage pool.
system
Displays information for the system storage pool.
user
Displays information for all user storage pools.
pool_name
Specifies the names of one or more storage pools to display.
Specifies that you want to read the names of one or more storage pools to display from stdin (for example, – << /work/stgpools_list.txt).

Prerequisites

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

If you do not specify a listing parameter, this command displays the following default information for each storage pool:
  • Name of the storage pool.
  • Type of storage pool.
  • Size of the storage pool, in MB.
  • Amount of space used, in MB.
  • Percent of space used.
  • Alert threshold.
  • Number of volumes in the storage pool.
If you specify the –l listing parameter, this command displays the following information in addition to the default information for each storage pool:
  • Partition size, in MB (16, 64, or 256).
  • Allocation size, in KB (auto, 4 or 128).
  • Pool description.

Example

Display a long listing The following example lists all the attributes of all the storage pools:
sfscli> lspool -l

Name      Type     Size (MB)  Used (MB)   Used (%)  Threshold (%)   Volumes
===========================================================================
Pool1     User          1400        575         41             90         2
Pool2     User          2000       1000         50             90         3
DEFAULT   Default      10000       2500         25             80        10
SYSTEM    System       10000       7500         75             80        10

Partition Size (MB)   Allocation Size (KB)   Description
=========================================================
                 16                      2   Accounting 
                 16                      3   Engineering
                 64                    128   DEFAULT pool
                 64                    128   SYSTEM pool

Parent topic: Administrative commands

Related reference
disabledefaultpool
chpool
mkpool
rmpool
setdefaultpool

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.