lsarraysite

The lsarraysite command displays a list of array sites and status information for each array site in the list.


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

>--+---------------------+--+-----------------+----------------->
   '- -dapair--dapair_ID-'  '- -cap--capacity-'   

>--+-------------------+--+---------------------------+--------->
   '- -array--array_ID-'  '- -state--+-assigned-----+-'   
                                     +-unassigned---+     
                                     +-abnormal-----+     
                                     '-initializing-'     

>--+--------------------+--------------------------------------><
   +-site_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 the qualified site ID is not specified.

-s

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

-l

(Optional) Displays the default output and the disk drive module rpm (revolutions per minute). You cannot use the -l and the -s parameters together.

-dapair dapair_ID

(Optional) Displays array sites that are associated with a common device adapter pair ID. A device adapter pair ID is a two-digit decimal number with no leading zeros.

-cap capacity

(Optional) Displays in gigabytes (GB) the array sites that have the specified capacity of the disk drive module.

-array array_ID

(Optional) Displays the array site that is associated with the specified array ID. An array ID is a four-digit decimal number with no leading zeros, prefixed with the letter A.

-state assigned | unassigned | unavailable | initializing

(Optional) Displays array sites that are in the specified state. One of the following values is displayed:

assigned: Specifies that the designated array site is defined as an array.
unassigned: Specifies that the array site is available to be defined as an array.
unavailable: Specifies that the designated array site is unassigned and at least one disk is not in the normal state. Also, the array site is not in the initializing state.
initializing: Specifies that the array site is unassigned and all disks are either in the normal or initializing state. Also, at least one disk is in the initializing state.

site_ID . . . | -

(Optional) Displays array sites that have the specified IDs. An array site identifier is a four-digit decimal number with no leading zeros, prefixed with the letter S.

To specify a range of array site IDs, separate the array site IDs with a hyphen.

You must separate multiple array site IDs or ranges of array site 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 lsarraysite 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 lsarraysite command

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

Arsite	DA pair	Dkcap (10^9B)	Diskrpm	State	Array	Diskclass
IBM.2107- 75FA120/ S10	IBM.2107- 75FA120 /11	300	1500	Assigned	IBM.2107- 75FA120 /A100	ENT
IBM.2107- 75FA120/ S11	IBM.2107- 75FA120 /11	300	1500	Assigned	IBM.2107- 75FA120 /A101	ENT
IBM.2107- 75FA120/ S12	IBM.2107- 75FA120 /12	300	1500	Assigned	IBM.2107- 75FA120 /A102	NL
IBM.2107- 75FA120/ S13	IBM.2107- 75FA120 /12	300	1500	Assigned	IBM.2107- 75FA120 /A103	NL

Report field definitions

Arsite

Specifies the array site ID. The array site ID is a four-digit decimal number, with no leading zeros, prefixed with the letter S.

Note: The array site ID does not point to a physical location.

DA pair

Identifies the DA pair ID. DA pairs are located in I/O enclosure pairs. The DA pair ID indicates the I/O enclosure location.

Note: An even-numbered DA pair ID indicates the first DA pair in an I/O enclosure pair. An odd-numbered DA pair ID indicates the second DA pair in an I/O enclosure pair.

Dkcap (10^9 Byte)

Specifies the minimum disk capacity of the disks in the designated array site in gigabytes.

Diskrpm

Specifies the minimum disk rpm of the disks in the designated array site.

State

Specifies the array site state. One of the following values can be displayed in this field:

Assigned: Specifies that the designated array site is defined as an array.
Unassigned: Specifies that the array site is available to be defined as an array.
Unavailable: Specifies that the designated array site is unassigned and at least one disk is not in the normal state. Also, the array site is not in the initializing state.
Initializing: Specifies that the array site is unassigned and all disks are either in the normal or initializing state. Also, at least one disk is in the initializing state.

Array

Specifies the array ID that this assigned array site is assigned to. The ID is prefixed by the letter A.

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