The showrank command displays detailed properties or performance metrics of a rank.
>>-showrank--+-------------------------+--+-----------+--rank_ID->< '- -dev--storage_image_ID-' '- -metrics-'
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 rank; otherwise, it is optional.
- -metrics
- (Optional) Displays the rank ID and performance statistics for the specified
rank.Note: All performance statistics are an accumulation since the most recent counter wrap or counter reset. Rank performance counters are reset on a power up sequence or by a server failover and failback sequence.
- rank_ID
- (Required) Specifies the properties for the specified rank. This parameter accepts a fully qualified rank ID, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeros, prefixed by the letter R.
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 showrank command. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.
Invoking the showrank command to show rank properties
dscli>showrank -dev IBM.2107-75FA120 R34
The resulting output
Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.1750-75FA120
| ID | SN | Group | State | Datastate | Array | RAIDtype |
|---|---|---|---|---|---|---|
1750 |
A23567 | 0 | Normal | Normal | IBM.1750 |
10 |
| ExtpoolID | Extpoolnam | Volumes | Stgtype | Exts | Usedexts |
|---|---|---|---|---|---|
IBM.1750 |
host_4 |
IBM.1750 |
FB | 1,000 | 500 |
| Widearrays | Nararrays | Trksize | Strpsize | Strpesize | Extsize |
|---|---|---|---|---|---|
| 1 | 0 | 128 | 4 | 4 | 16,384 |
Report field definitions (-metrics parameter not specified)
- ID
- Specifies the unique ID that is assigned by the system to the rank. The ID includes the storage image ID and the rank ID.
- SN
- Specifies the unique serial number that is assigned to the designated rank ID.
- Group
- Specifies the rank group that the rank is assigned to. One of the following
values are displayed: 0, 1, - (null).Note: Null (-) is displayed if the rank has not been assigned to an extent pool.
- State
- Specifies the configuration state that is associated with the rank at
the time that the report is generated. The following values can be displayed
for the rank:
- Normal
- Specifies that a rank is assigned to an extent pool ID and none of the other state conditions apply.
- Configuring
- Specifies that a rank is in the process of being initially configured. Generally this state indicates that the associated rank transaction has not completed.
- Unassigned
- Specifies that a rank is not assigned to an extent pool ID.
- Reserved
- Specifies that rank extents are not eligible for volume allocation.
- Deconfiguring
- Specifies that a rank is in the process of being deleted.
- Configuration Error
- Specifies that a rank configuration process did not complete successfully. This state indicates that there is an internal error condition and it is not an indication that there was a user input error.
- Deconfiguration Error
- Specifies that a rank removal process did not complete successfully. This state indicates that there is an internal error condition and it is not an indication that there was a user input error. This configuration state is corrected by reissuing the rmrank command.
- Datastate
- Specifies the current state of the data extents that are contained by
this rank ID. The following values can be displayed for the rank:
- Normal
- Specifies that none of the other data states apply.
- Degraded
- Specifies that one or more arrays in the rank are in the degraded state.
- Read Only
- Specifies that one or more arrays in the rank are in the Read Only state.
- Failed
- Specifies that one or more arrays in the rank are in the Failed state.
- Repairing
- Specifies that one or more arrays in the rank are in the Repairing state.
- Inaccessible
- Specifies that one or more arrays in the rank are in the Inaccessible state.
- Array
- Specifies the array ID that is assigned to the designated rank.
- RAIDtype
- Specifies the RAID type of the array that is associated with the designated rank.
- ExtpoolID
- Specifies the extent pool to which the designated rank is assigned.
- Extpoolnam
- Specifies the extent pool to which the designated rank is assigned.
- Volumes
- Specifies the volume IDs that have an extent pool value that is allocated on the designated rank.
- Stgtype
- Specifies the storage type of the extent pool the designated rank is assigned to. Valid values are fixed block and count key data (CKD).
- Exts
- Specifies the number of extents that are contained in the designated rank. 1 - 4000 are valid values.
- Usedexts
- Specifies the number of extents that are allocated to volumes from the designated rank.
- Widearrays
- Specifies the number of wide arrays that are contained by the designated rank. 0 or 1 are valid values.
- Nararrays
- Specifies the number of narrow arrays that are contained by the designated rank.
- Trksize
- Specifies the track size.Notes:
- The track size is displayed as a 1 if it is associated with a CKD storage type.
- The track size is displayed as 128 if it is associated with a fixed block storage type.
- Strpsize
- Specifies the number of logical tracks in a strip on the designated rank.
- Strpesize
- Specifies the number of logical tracks in a stripe on the designated rank.
- Extsize
- Specifies the number of logical tracks in a extent on the designated rank.Notes:
- A CKD 1 GB extent contains 16 696 tracks.
- A fixed block 1 GB extent contains 16 384 tracks.
Performance request
Invoking
the showrank command to show performance metrics
dscli>showrank -dev IBM.2107-75FA120 - metrics R34
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 | Byteread | Bytewrite | Reads |
|---|---|---|---|---|
1750 |
10/11/04 |
10000 | 10000 | 10000 |
| Writes | Timeread | Timewrite |
|---|---|---|
| 10000 | 10000 | 10000 |
Report field definitions (with the -metrics parameter specified)
- ID
- Specifies the unique ID that is assigned by the system to the rank. The ID includes the storage image ID and the rank ID.
- Date
- Specifies the time stamp for the rank performance counters.
- Byteread
- Specifies the number of rank bytes that are read in 128 KB increments.
- Bytewrite
- Specifies the number of rank bytes that are written in 128 KB increments.
- Reads
- Specifies the rank read operations.
- Writes
- Specifies the rank write operations.
- Timeread
- Specifies the rank read response time in 16 millisecond increments.
- Timewrite
- Specifies the rank read response time in 16 millisecond increments.