lsextpool

The lsextpool command displays a list of extent pools in a storage unit and status information on each extent pool in the list.


>>-lsextpool--+-------------------------+--+-----+-------------->
              '- -dev--storage_image_ID-'  +- -s-+   
                                           '- -l-'   

>--+--------------------+--+------------------+----------------->
   '- -stgtype--+-fb--+-'  '- -rankgrp--+-0-+-'   
                '-ckd-'                 '-1-'     

>--+--------------------------+--------------------------------><
   +-extentpool_ID--+-------+-+   
   |                '-. . .-' |   
   '-" - "--------------------'

Parameters

-dev storage_image_ID: (Optional) Specifies the storage image ID, which consists of manufacturer, type, and serial number.
-s: (Optional) Displays extent pool IDs. You cannot use the -l and the -s parameters together.
-l: (Optional) Displays default output plus additional attributes that are identified as long output. You cannot use the -l and the -s parameters together.
-stgtype fb | ckd: (Optional) Displays only extent pools with the specified storage type.
-rankgrp 0 | 1: (Optional) Displays only extent pools in the specified rank group.
extentpool_ID . . . | –: (Optional) Displays only the extent pools with the specified IDs. An extent pool ID is a four-digit decimal number with no leading zeroes, prefixed by the letter P.; To specify a range of extent pool IDs, separate the extent pool IDs with a hyphen.; You must separate multiple extent pool IDs or ranges of extent pool IDs with a space between each ID or range of IDs.; If you specify the dash (-), this parameter information is automatically supplied.

Example

For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

The following tables represent the headers that are displayed on the output report that is associated with the lsextpool command using the -l parameter. A separate example is not shown for the 1750 as the information is the same for both the 2107 and 1750.

Invoking the lsextpool command

dscli>lsextpool -dev IBM.2107-75FA120 -l

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107-75FA120

Name	ID	Stgtype	Rankgrp	Status	Avail- stor (2^30B)
host_1 _extpool	IBM.2107- 75FA120 /P21	fb	0	exceeded	1000
host_1 _extpool	IBM.2107- 75FA120 /P22	fb	1	exceeded	1000
host_2 _extpool	IBM.2107- 75FA120 /P23	fb	0	exceeded	1000
host_2 _extpool	IBM.2107- 75FA120 /P24	fb	1	exceeded	1000
host_3 _extpool	IBM.2107- 75FA120 /P25	fb	0	exceeded	1000
host_3 _extpool	IBM.2107- 75FA120 /P26	fb	1	exceeded	1000

%allo- cated	Avail- able	Reser- ved	Num- vols	Num- ranks
10	1000	100	4	4
10	1000	100	4	4
10	1000	100	4	4
10	1000	100	4	4
10	1000	100	4	4
10	1000	100	4	4

Report field definitions

Name

Identifies the name you assigned to the extent pool.

ID

Specifies the system assigned unique identifier for the extent pool object.

stgtype

Identifies the storage type associated with the extent pool. One of the following is displayed:

rankgrp

Specifies the rank group in which the designated extent pool is configured.

Status

Specifies the extent status. One of the following values is displayed:

exceeded: Specifies that the %Extents available is greater than the extent threshold
below: Specifies that the %Extents Available is less than the extent threshold
full: Specifies that the %Extents Available is 0.

availstor (2^30 Bytes)

Specifies the available storage for the designated extent pool, in gigabytes (2 ^ 30 Bytes).

%allocated

Specifies the percentage of extents allocated.

available

Specifies the maximum number of extents available for allocation in the designated extent pool.

reserved

Specifies the extents reserved in the designated extent pool.

numvols

Identifies the number of logical volumes that have been configured from the designated extent pool.

numranks

Identifies the number of ranks that have been configured in the designated extent pool.