lsrank

The lsrank command displays a list of defined ranks in a storage image and status information for each rank.


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

>--+--------------+--+----------------------------+------------->
   '- -grp--+-0-+-'  '- -state--+-normal--------+-'   
            '-1-'               +-configuring---+     
                                +-unassigned----+     
                                +-reserved------+     
                                +-deconfiguring-+     
                                +-depopulating--+     
                                +-configerr-----+     
                                '-deconfigerr---'     

>--+--------------------------+--+----------------+------------->
   '- -data--+-normal-------+-'  '- -type--+-5--+-'   
             +-degraded-----+              '-10-'     
             +-readonly-----+                         
             +-failed-------+                         
             +-repairing----+                         
             '-inaccessible-'                         

>--+--------------------------+--+--------------------+--------->
   '- -extpool--extentpool_ID-'  '- -stgtype--+-fb--+-'   
                                              '-ckd-'     

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

Parameters

-dev storage_image_ID: (Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number.
Example: IBM.1750-68FA120
-s: (Optional) Displays the rank ID. You cannot use the -l and the -s parameters together.
-l: (Optional) Displays the default output, extent pool name, number of extents, and extents that are used for each rank. You cannot use the -l and the -s parameters together.
-grp 0 | 1: (Optional) Displays only the ranks that belong to the specified rank group. A rank in the unassigned state is not associated with a rank group.
-state normal | configuring | unassigned | reserved | deconfiguring | depopulating | configerr | deconfigerr: (Optional) Displays only ranks in the specified state.
-data normal | degraded | readonly | failed | repairing | inaccessible: (Optional) Displays only ranks in the specified data state.
-type 5 | 10: (Optional) Displays only ranks of the specified RAID type.
-extpool extentpool_ID: (Optional) Displays only ranks in the specified extent pool. An extent pool ID is a four-digit decimal number with no leading zeroes, prefixed with the letter P.
-stgtype fb | ckd: (Optional) Displays only ranks that are configured for the specified storage type.
rank_ID . . . | –: (Optional) Displays rank information for specified rank IDs. An ID range is defined by two IDs that are separated by a hyphen.; You must separate multiple rank IDs or ranges of rank IDs with a blank 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 lsrank command using the -l parameter. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the lsrank command

dscli>lsrank  -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

ID	State	Datastate	Array	RAIDtype
IBM.2107-75FA120/R1	Normal	Normal	A1	5
IBM.2107-75FA120/R2	Normal	Normal	A2	5
IBM.2107-75FA120/R3	Normal	Normal	A3	5
IBM.2107-75FA120/R4	Normal	Normal	A4	5

ExtentpoolID	Extpoolnam	Stgtype	Exts	Usedexts
P1	host_1_volumes	fb	1,000	500
P1	host_1_volumes	fb	1,000	500
P1	host_1_volumes	fb	1,000	500
P1	host_1_volumes	fb	1,000	500

Report field definitions

ID

Specifies the unique identifier assigned to the rank.

Group

Specifies the rank group that the rank is assigned to. A value of 0, 1, or - (null) is displayed. If a rank is unassigned the value displayed is - (null).

State

Specifies the current configuration state of this rank ID. One of the following values is displayed:

Normal: Specifies that rank is assigned to an extent pool ID and none of the other state conditions apply.
Configuring: Specifies that the rank is in the process of being initially configured.
Unassigned: Specifies that the rank is not assigned to a extent pool ID.
Reserved: Specifies that the rank extents are not eligible for volume assignment.
Deconfiguring: Specifies that the rank is in the process of being deleted.
Depopulating: Specifies that the extents on a rank are not eligible for allocation and the existing allocations are to be moved to another rank in the extent pool using dynamic extent relocation.
Configuration Error: Specifies that a rank configuration process failed to complete successfully. This state reflects an internal error condition and not an error in the user’s request to create the rank. To correct this state, you must delete the designated rank configuration.
Deconfiguration Error: Specifies that a rank removal process has failed to complete successfully. This state reflects an internal error condition and not an error in the request to remove the rank. To correct this state, you must reissue the rmrank command for the designated rank configuration.

Datastate

Note: A rank is not considered for new extent allocations if it is not in the normal or degraded data state (even if the configuration state is normal).

Datastate specifies the current state of the data extents contained by the designated rank ID. One of the following values is displayed:

Normal: A rank is in the normal data state when the configuration state is one of the following: unassigned, configuring, or configuration error.
Degraded: A rank is in the degraded data state if one or more arrays in the rank are in the degraded data state and none are in the read only, failed, repairing, or inaccessible data states.
Read only: A rank is in the read only data state if one or more arrays in the rank are in the read only data state and none are in the failed, repairing, or inaccessible data states.
Failed: The rank is in the failed data state if one or more arrays in the rank are in the failed data state.
Repairing: A rank is in the repairing data state if one or more arrays in the rank are in the repairing data state and none are in the failed data state.
Inaccessible: A rank is in the inaccessible data state if one or more arrays in the rank are in the inaccessible data state and none are in the failed or repairing data states.

Array

Specifies the array ID that is assigned to the designated rank.

RAIDtype

Specifies the RAID type of the array associated with this rank. The value displayed is either 5 or 10.

ExtentpoolID

Specifies the extent pool to which the rank is assigned.

Extpoolnam

Specifies the name that is assigned to the extent pool to which the rank is assigned.

Stgtype

Specifies the storage type of the extent pool to which the rank is assigned. The value displayed is either fb (fixed block) or ckd (count key data)

Exts

Specifies the number of extents that are contained in the designated rank. The value displayed is a number in the range of 1 - 4000.

Usedexts

Specifies the number of extents that are allocated to volumes from the designated rank. The value displayed is a number in the range of 1 - 4000.