showarray

The showarray command displays detailed properties of a specific array.

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 a fully qualified array ID. It is also required if you do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.
array_ID | -: (Required) 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 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 detailed array properties

dscli> showarray -dev IBM.2107–75FA120 A44

Output

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	Encrypt
2107-75FA 123/R26	2107-75FA 123/11	145	15000	FCAL	2	SATA	unsupported

Output definitions

Array

The array ID number. The array ID number starts with the prefix A, followed by a decimal number up to 4 digits in length, with no leading zeros. For example, A44.

SN

The unique internal identifier for the data space of the designated array (for example, AZ123AQ).

State

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

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 failed.
There are insufficient spares to support all rebuild operations.
Continued write operation without redundancy might 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 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 previously entered the failed state.
The repair array function was accepted.
The repair array function did not complete.

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

The type of RAID array (5, 6, or 10) and the array configuration (for example, 6+P). Storage system array configurations are based on 8 DDM array sites for DA Pair Types 1 and 2, and 7 or 8 DDM array sites for DA Pair Type 3.

Arsite

The array sites that are associated with the array.

Rank

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 number up to 4 digits in length, with no leading zeros. For example, R26.

Note: If the array is unassigned, the field is " – "

DA pair

The DA pair ID. DA pairs are in I/O enclosure pairs. The DA pair ID locates 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)

The minimum disk capacity (10^9B) of the storage devices (DDMs) in the designated array.

DDMRPM

The minimum disk rpm of the DDMs in the designated array.

Interface Type

The disk interface type of the DDMs in the designated array.

Interrate

The minimum disk interface rate of the disks in the designated array.

Diskclass

The disk class. One of the following values can be displayed:

ENT: Enterprise; High-speed Fibre Channel disk drives.
NL: Near-line; ATA (FATA) disk drives.
SATA: High capacity SATA disk drives.
SSD: Solid-state devices.
FlashTier0: High performance flash (Flash Tier 0) drives.
FlashTier1: The first tier of high capacity flash (Flash Tier 1) drives.
FlashTier2: The second tier of high capacity flash (Flash Tier 2) drives.

encrypt

The encryption support capability. One of the following values can be displayed:

supported: The disk drive modules in this array support encryption.
unsupported: The disk drive modules in this array do not support encryption.