showextpool

The showextpool command displays detailed properties or performance metrics of an extent pool.


>>-showextpool--+-------------------------+--+-----------+------>
                '- -dev--storage_image_ID-'  '- -metrics-'   

>--+-extentpool_ID-+-------------------------------------------><
   '-" - "---------'

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which consists of manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the extent pool; otherwise, it is optional.

-metrics

(Optional) Displays the extent pool ID and performance metrics for the specified extent pool.

Note: All performance metrics are an accumulation since the most recent counter wrap or counter reset. The extent pool performance counters are reset on the following occurrences:

The storage unit is powered-up.
A server has failed and the failover and failback sequence is performed.

extentpool_ID | -

(Required) Specifies the extent pool to be displayed. Accepts a fully qualified extent pool ID, which consists of the storage image ID, or an extent pool number without the storage image ID if the -dev parameter is specified. The extent pool number is a four-digit decimal number with no leading zeroes, prefixed with the letter P. Even numbered extent pools are associated with rank group 0. Odd numbered extent pools are associated with rank group 1.

If you specify the dash (-), this parameter information is automatically supplied.

Example

For this command and all other DS CLI show 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 reports that are associated with the showextpool command. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the showextpool command to show extent pool properties

dscli>showextpool -dev IBM.2107-75FA120 P101

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	totlstor (2^30B)	availstor (2^30B)	resvdstor (2^30B)	rankgrp
host_4 _extpool	IBM.2107- 75FA120 /P21	fb	1000	800	0	1

num ranks	numvols	status	%allo- cated	%avail- able	config- ured	allowed	avail- able
4	3	exceeded	20	80	1000	600	800

allocated	reserved	%limit	%thres- hold
200	0	80	70

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:

totlstor (2^30 Bytes)

Specifies the amount of storage associated with the extent pool, in gigabytes.

availstor (2^30 Bytes)

Specifies the available storage for the designated extent pool, in gigabytes.

resvdstor (2^30 Bytes)

Specifies the amount of reserved storage for the designated extent pool, in gigabytes.

rankgrp

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

numranks

Specifies the number of ranks configured in the designated extent pool.

numvols

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

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

%allocated

Specifies the percentage of extents allocated. A value of 1 - 100 is displayed.

%available

Specifies the percentage of extents that are available. A value of 1 - 100 is displayed.

configured

Specifies the number of extents that are contained in the extent pool.

allowed

Specifies the number of extents that are below the applicable extent limit.

available

The number of extents of a given type that are available for allocation to a logical volume.

allocated

Specifies the number of extents of a given type in the extent pool that are allocated to logical volumes or auxiliary volumes.

%limit

Specifies the maximum percentage of allocated real extents that are allowed in this extent pool.

%threshold

Specifies threshold as a percentage of the real extents that are available compared with the actual percentage of real extents that are available.

Performance request

Invoking the showextpool command to show performance metrics

dscli>showextpool -metrics  IBM.2107-75FA120/P101

The resulting output

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

ID	Date	real extcap	realext	real allocext	real extconv
IBM.2107- 75FA120 /P101	10/11/04 02:23:47	10000	10000	10000	10000

dyreloc source	dyreloc target
10000	10000

Report field definitions

ID: Specifies the system assigned unique identifier for the extent pool object.
Date: Identifies the current time stamp for the extent pool performance counters.
realextcap: Specifies the real extent pool capacity in gigabytes.
realext: Specifies the number of real extents in the extent pool.
realallocext: Specifies the number of real allocated extents in the extent pool..
realextconv: Specifies real extent conversions.
dyrelocsource: Specifies the number of extents that were sources of a dynamic extent relocation
dyreloctarget: Specifies the number of extents that were targets of a dynamic extent relocation