showarray

The showarray command displays detailed properties of a specific array.

Read syntax diagramSkip visual syntax diagram
>>-showarray--+-------------------------+--+-array_ID-+--------><
              '- -dev--storage_image_ID-'  '-" - "----'   

Parameters

-dev storage_image_ID
(Optional) Specifies the storage image ID, which consists of the manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the array.
array_ID | -
(Required) Specifies the array ID that you want to view. This parameter accepts a fully qualified array 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 A.
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 report that is associated with the showarray command. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the showarray command
dscli>showarray  -dev IBM.2107–75FA120 A44
The resulting output
Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107–75FA120
Array SN State Datastate RaidType Arsite
IBM.2107-75FA120/A44 AZ123AQ Assigned Normal 5 (6+P) S21
Rank DA Pair

DDMcap
(10^9B)

DDMRPM

Interface
Type

Interrate
(GB/secs)

Diskclass

2107-75FA
123/R26

2107-75FA
123/11

145 15000 FCAL 2 ENT

Report field definitions

Array
Specifies the array ID number. The array ID number starts with the prefix A, followed by a four-digit decimal number with, no leading zeros (for example, A44).
SN
Specifies the unique internal identifier for the data space of the designated array (for example, AZ123AQ).
State
Specifies the array state. One of the following values is displayed:
Assigned
The array is assigned to a rank.
Unassigned
The array is not assigned to a rank and all of the storage devices that are indicated by the disk serial numbers attribute are in the normal state.
Unavailable
The array is not assigned to a rank and one or more of the disk drive modules (DDMs) that are indicated by the disk serial numbers attribute are not in the normal state.
Datastate
Specifies the current data state. One of the following values is displayed:
Normal
The array is in the Normal data state if none of the other data states applies. This status applies if the array is unassigned.
Degraded
The array is in the Degraded data state if both of the following conditions exist:
  • The Read-only, Failed, Repairing, or Inaccessible data states do not apply.
  • One or more redundancy groups are rebuilding (that is, there is a DDM with a rebuilding state in the array).
Read Only
The array is in the Read-only data state if all of the following conditions exist:
  • The Failed, Repairing, and Inaccessible data states do not apply.
  • One or more DDMs have failed.
  • There are insufficient spares to support all rebuild operations.
  • Continued write operation without redundancy could result in data loss.
Failed
The array is in the Failed data state if all of the following conditions exist:
  • The Repairing and Inaccessible data states do not apply.
  • Two or more DDMs in the array have failed.
  • There are insufficient DDMs left in the array to rebuild the data that was lost on the failing storage devices.
Repairing
The array is in the Repairing data state if all of the following conditions exist:
  • The Inaccessible data state does not apply.
  • The array has previously entered the failed state.
  • The repair array function has been accepted.
  • The repair array function has not completed.
Inaccessible
The array is in the Inaccessible data state if the storage unit cannot access a set of storage devices that are sufficient to access all the data on the array.
RaidType
Specifies the type of RAID array (5 or 10) and the array configuration (for example, 6+P).
Arsite
Specifies the array sites that are associated with the array.
Rank
Specifies the rank that the array is assigned to. The value is displayed as a combination of a storage image ID and a rank number. The rank number is the prefix R, followed by a four-digit decimal number, with no leading zeros (for example, R26).
Note: If the array is unassigned, the field is null (–)
DA pair
Specifies the DA pair ID. DA pairs are located in I/O enclosure pairs. The DA pair ID indicates the location of the I/O enclosure.
Note: DA adapters are installed in slot 3 an enclosure and slot 6 in the peer enclosure. The DA pair ID identifies the enclosure that contains the DA adapter in slot 3. For example, a DA adapter is installed in slot of 3 of enclosure 2. Its peer is installed in slot 6 of enclosure 3. In this case, the DA Pair ID is 2.
DDMcap (10^9B)
Specifies the minimum disk capacity (10^9B) of the storage devices (DDMs) in the designated array.
DDMRPM
Specifies the minimum disk rpm of the DDMs in the designated array.
Interface Type
Specifies the disk interface type of the DDMs in the designated array
Interrate
Specifies the minimum disk interface rate of the disks in the designated array.
Disk class
Specifies the disk class as either high speed fibre-channel disk drives or near-line disk drives. The displayed value is one of the following:
ENT
Specifies enterprise and represents high speed fibre-channel disk drives
NL
Specifies near-line and represents ATA (FATA) disk drives
Related reference
lsarraysite
showarraysite
mkarray
rmarray
lsarray
mkrank
chrank
rmrank
lsrank
showrank
mkextpool
chextpool
rmextpool
lsextpool
showextpool
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.