lsrank

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

Parameters

-dev storage_image_ID

(Optional) The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs or do not set the devid variable in your profile or through the setenv command. The storage image ID is also required if HMC is aware of more than one storage image.

Using the -dev parameter temporarily overrides any defined value for devid for the current command.

Example: IBM.2107-75FA120

-s

(Optional) Displays only the rank ID. You cannot use the -l and the -s parameters together.

-l

(Optional) Displays the default output plus the extent pool name, number of extents, extents that are used, and key group 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.

(Optional) Displays only ranks in the specified state.

(Optional) Displays only ranks in the specified data state.

-type 5 | 6 | 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 zeros, prefixed with the letter P.

-stgtype fb | ckd

(Optional) Displays only ranks that are configured for the specified storage type.

-keygrp key_group_ID

(Optional) Displays the key group that this rank uses.

-marray managed_array_ID

(Optional) Displays only those ranks that are assigned to the specified managed array.

-extsize

(Optional) Displays only those ranks that have the specified extent sizes.

1GiB: The rank storage type is FB and there is 1 GiB in an extent on this rank.
16MiB: The rank storage type is FB and there is 16 MiB in an extent on this rank.
1113cyl: The rank storage type is CKD and there are 1113 cylinders in an extent on this rank.
21cyl: The rank storage type is CKD and there are 21 cylinders in an extent on this rank.

rank_ID ... | –

(Optional) The 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.

The ellipsis (...) means that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example: Displaying ranks' status information

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

Output (The output displays in two parts to avoid text overflow.)


ID Group State datastate Array RAIDtype extpoolID extpoolnam           stgtype exts  
===================================================================================
R0  1    Normal Normal    A1     5        P1      pool_large_ckd_wht   ckd      95     
R1  1    Normal Normal    A2     5        P3      pool_small_ckd_wht   ckd    20949


usedexts   keygrp  marray   extsize(cap)
===========================================
0          -           MA2        1113cyl
0          -           MA3          21cyl

Output definitions

ID

The unique identifier that is assigned to the rank.

Group

The rank group that the rank is assigned to. A value of 0, 1, or " - " is displayed. If a rank is unassigned, the value that is displayed is " - ".

State

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

Normal: The rank is assigned to an extent pool ID and none of the other state conditions apply.
Unassigned: The rank is not assigned to an extent pool ID.
Reserved: The rank extents are not eligible for volume assignment.
Depopulating: 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 by using dynamic extent relocation.
Configuring: The rank is being initially configured.
Unassigned Reserved: A rank is not assigned to any extent pools, and it is also reserved. A rank with this state will change to Reserved state after it is assigned to an extent pool or changed to the Unassigned state after it is released.
Depopulation Error: Depopulating of the specified rank failed and efforts to depopulate the rank were stopped. (A failed rank can occur when the state of the rank is not valid.) A rank with this state changes to Reserved state if it is reserved, or change to Normal state if it is released.
Configuration Error: 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.
Deconfiguring: The rank is being deleted.
Deconfiguration Error: A rank removal process did not complete successfully. An internal error condition, not a user input error. This state is corrected by reissuing the rmrank command.

Datastate

The current state of the data extents that are contained by the designated rank ID. One of the following values is displayed:

Normal: A rank is in the normal data state during one of the following configuration states: 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.

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

Array

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

RAIDtype

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

ExtpoolID

The extent pool to which the rank is assigned.

Extpoolnam

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

Stgtype

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

Exts

The number of extents that are contained in the designated rank.

Usedexts

The number of extents that are allocated to volumes from the designated rank.

keygrp

The encryption key group. A dash ( - ) means that either encryption is supported but not used, or encryption is not supported.

marray

The managed array that is assigned to this rank. This parameter only displays when you specify the -l parameter. The following values can display:

"-": If the system does not support managed arrays, a dash (-) displays.
Unknown: If managed arrays are understood by the system, ranks consisting of more than one array are in the Unknown state.
managed_array_ID: If managed arrays are understood by the system, the specified rank has only one array, with only one array site. The range of managed array ID numbers that display is the same as the range of array site numbers, but prefixed with MA.

extsize(cap)

The extent size for the specified rank. There is a direct relationship with the -extsize parameter specified for the rank when it is created and the CKD and FB small extent values.

Note: This parameter only displays when you specify the -l parameter. The following values can display.

1GiB: The rank storage type is FB and there is 1GiB in an extent on this rank.
16MiB: The rank storage type is FB and there is 16MiB in an extent on this rank.
1113cyl: The rank storage type is CKD and there are 1113 cylinders in an extent on this rank.
21cyl: The rank storage type is CKD and there are 21 cylinders in an extent on this rank.