lsstgencl

The lsstgencl command displays a list of storage enclosures and status information for each enclosure in the list.


>>-lsstgencl--+-----+--+----------------+----------------------->
              +- -s-+  +- -state--------+   
              '- -l-'  '-+-normal-----+-'   
                         '-not normal-'     

>--+-storage_image_ID--. . .-+---------------------------------><
   '-" - "-------------------'

Parameters

-s: (Optional) Displays the storage enclosure ID. You cannot use the -l and the -s parameters together.
-l: (Optional) Displays default output, plus the storage enclosure feature code and engineering change level. You cannot use the -l and the -s parameters together.
-state normal|not normal: (Optional) Displays all the storage enclosures that are associated with the specified storage unit that contain a condition of normal or a condition that falls under the category of not normal.
storage_image_ID . . . | -: (Required) Displays storage enclosure information for the specified storage image IDs. A storage image ID consists of manufacturer, machine type, and serial number. You must separate multiple IDs with a space between each ID.
Note: You cannot specify an ID range.; 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 lsstgencl command using the -l parameter. There are some differences in the returned values for a 2107 versus a 1750.

Invoking the lsstgencl command

dscli>lsstgencl -l IBM.1750-68FA120

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI 
Version: 5.0.0.0 DS: IBM.1750-68FA120

ID	Frame	Enclnum	Loc	FC	Interfaces
IBM.1750- EX1.68FA120 /S00	- (null)	S01	U1750. 511.685FA120	- (Not applicable)	0080, 0081, 0180, 0181 (Not inter- face values. See the field definitions)
IBM.1750- EX1.68FA120 /S01	- (null)	S02	U1750. 511.685FA120	- (Not applicable)	0082, 0083, 0182, 0183 (Not inter- face values. See the field definitions)

Interadd	Storslot	Stordev	Cap	RPM	State
0 x 0	16	16	145	10000	normal
0 x 1	16	16	145	10000	normal

Report field definitions

ID

Specifies the enclosure ID and enclosure number.

Note: This is the only information that is displayed if you use the -s parameter. None of the other values are displayed.

Frame

Specifies null (-) for the 1750.

Enclnum

(1750) Identifies a storage enclosure within a storage unit frame. The values displayed for the enclosure are S00 - S03 or S10 - S13. These values are interpreted as follows:

Enclosures S0x are located on DA pair interface 0.
Enclosures S1x are located on DA pair interface 1.

Notes:

y represents the position of the storage enclosure. For example, the distance from the server enclosure. (0 – first, 1 – second, 2 – third, 3 – fourth)
The server enclosure contains a storage enclosure element that resides on FC-AL Loop 0, and that is what is returned with the command output.

Loc

Specifies the storage enclosure location by identifying the storage unit frame that contains the storage enclosure. The location format is Utttt.mmm.ppsssss.

FC

Specifies the feature code that was used to order this storage enclosure.

Interfaces

Specifies a list of four interface identifiers, one for each DA I/O port.

A DA interface ID consists of four hexadecimal characters with the following format: t00 eeeee aaaa pppp b, (value is separated for readability), where

t = port type (0 = I/O port, DA ports are always I/O ports)
00 = reserved
eeeee = enclosure number
aaaa = adapter number
pppp = port number
b = indicates that the value is a binary string

The values for DS6000 represent the following:

Notes:

For dual loop 0 enclosures, the DA I/O port values are displayed as 0080, 0081, 0180, 0181.
For dual loop 1 enclosures the DA I/O port values are displayed as 0082, 0083, 0182, 0183.

Interadd

Specifies the FC-AL interface base address assigned to this storage enclosure for DDM access.

Storslot

Specifies the number of slots for storage devices in this storage enclosure.

Stordev

Specifies the number of storage devices that are installed in this storage enclosure.

Cap

Specifies the capacity of DDMs in the storage enclosure.

Note: This field can contain multiple capacity values separated by a comma when the DDMs with different capacity are installed in the storage enclosure.

RPM

Specifies the rpm of the DDMs in the storage enclosure.

Note: This field can contain multiple RPM values separated by a comma when the DDMs with different capacity are installed in the storage enclosure.

State

Specifies the condition of the storage enclosure. The condition of the enclosure is either normal or one of the conditions that falls under the category not normal. The following values can be displayed:

normal: Indicates that the storage enclosure is not in any failure or transient condition.
failed: Indicates that the storage enclosure is broken and ready to be removed without impacting the system. This condition changes to inter failed if the storage enclosure is found to be in good condition again.
new: This condition only displays when a storage enclosure is first discovered.
removed: Indicates that the storage enclosure was removed from the system.
inappropriate: Indicates that the hardware resource cannot be integrated in the system.
inter failed: Indicates that the hardware resource is faulty but still working.
PFSed (Prepared for Service): Indicates that the storage enclosure is ready to be removed without impacting the system.
attention: Indicates that there is a problem with the storage enclosure; however, it is not known whether it is faulty or not. This condition reverts to normal if the problem is closed.