lsddm

The lsddm command displays a list of disk drive modules (DDMs) and status information for each DDM in the list.


>>-lsddm--+-----+--+---------------------------+---------------->
          +- -s-+  '- -enclosure--enclosure_ID-'   
          '- -l-'                                  

>--+---------------------+--+------------------------+---------->
   '- -dapair--dapair_ID-'  '- -arsite--arraysite_ID-'   

>--+---------------------------+--+-------------------------+--->
   '- -usage--+-unassigned---+-'  '- -state--+-normal-----+-'   
              +-unconfigured-+               '-not_normal-'     
              +-spare--------+                                  
              +-not_spare----+                                  
              '-array_member-'                                  

>--+-------------------+--+-storage_image_ID--+-------+-+------><
   '- -dualloop--+-1-+-'  |                   '-. . .-' |   
                 '-2-'    '-" - "-----------------------'

Parameters

-s: (Optional) Displays the DDM IDs. You cannot use the -s and -l parameters together.
-l: (Optional) Displays the default output. You cannot use the -s and -l parameters together.
-enclosure enclosure_ID: (Optional) Displays DDMs that are associated with a common storage enclosure ID. This parameter accepts a fully qualified enclosure ID, which includes either the storage image ID or a shortened version without the storage image ID. The shortened version is a hexadecimal number within the range (00 - 3F).
-dapair dapair_ID: (Optional) Displays DDMs that are associated with a common device adapter (DA) pair ID. This parameter accepts a fully qualified DA pair ID, which includes either the storage image ID or a shortened version without the storage image ID. The shortened version is a two-digit decimal number with no leading zeros.
-arsite arraysite_ID: (Optional) Displays DDMs that are associated with a common array site ID. This parameter accepts a fully qualified array site ID, which includes either the storage image ID or a shortened version without the storage image ID. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter S.
-usage unassigned | unconfigured | spare | not_spare | array_member: (Optional) Displays DDMs that are associated with a specified usage.
-state normal | not_normal: (Optional) Displays DDMs that are associated with a specified state.
-dualloop 1 | 2: (Optional) Specifies that DDMs that are associated with a specified dual loop be displayed.
storage_image_ID . . . | -: (Required) Displays DDM information for the specified storage image IDs. A storage image ID includes manufacturer, type, and serial number. You can specify multiple IDs and they must be separated with a space between each ID.
Note: You cannot specify ID ranges.; If you use 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 lsddm command using the -l parameter. A separate example is not shown for the 1750 because the information is the same for both. The only difference is the machine type designation, 2107 versus 1750. Also, the table shows only the first 2 DDMs associated with the specified storage unit.

Invoking the lsddm command

dscli>lsddm -l IBM.2107-75FA120

The resulting output

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

ID	Model	loc	Firmware level	DA pair	Dualloop	dkcap (10^9B)
IBM.2107- D21- 75FA120 /R1-S11- P1-D1	S0BE146	U2107.921. 75FA120	3603	11	1	145
IBM.2107- D21- 75FA120 /R1-S11- P1-D2	S0BE146	U2107.921. 75FA120	3603	11	1	145

Diskrpm	Dkinf	Dkrate	Dkuse	Arsite	Position	State	Diskclass
1000	FCAL	2	array member	S123	1	normal	ENT
1000	FCAL	2	array member	S123	2	normal	ENT

Report field definitions

ID

Specifies the system-assigned unique identifier for the DDM.

Model

Specifies the DDM model. The model name is a string of the form VRFCGGG, where VRFC is the type of disk family and GGG is the disk capacity in GB.

loc

Specifies the storage enclosure and the DDM location. The DDM location format is Pn-Dn, where Pn is the Planer number (1), and Dn is the DDM number (1 - 16).

Firmwarelevel

Specifies the level of firmware that is installed on the specified DDM.

DA pair

Specifies the device adapter pair ID. DA pairs are located in I/O enclosure pairs.

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.

Dualloop

Specifies the dual loop that the specified DDM resides on. The value is either 1 or 2.

dkcap (10^9B)

Specifies the DDM raw capacity in gigabytes.

diskrpm

Specifies the DDM rpm. One of the following values is displayed:

10000
15000

dkinf

Specifies the DDM interface type. One of the following values are displayed:

FC-AL
FC-NL

dkrate

Specifies the DDM interface rate.

dkuse

Specifies the DDM usage in an array site. One of the following values are displayed:

unassigned
unconfigured
spare required
spare not required
array member

arsite

Specifies the array site ID.

Position

Specifies the DDM position in an array site configuration of DDMs.

State

Specifies the current DDM state. One of the following values are displayed:

Normal: The storage device is operational and functional in its current disk usage.
New: Indicates the initial state when a DDM is inserted or first discovered.
Installing: A new storage device has been identified.
Verifying: The storage device is made accessible to the device adapter, its characteristics are determined, cabling is checked, and diagnostics are run.
Formatting: A verified storage device requires low-level formatting and the formatting operation is in progress.
Initializing: The storage device is being initialized with all zero sectors.
Certifying: The storage device is read-accessed to determine that all sectors can be read.
Rebuilding: The storage device is being rebuilt with data from the array that it is associated with.
Migration Target: DDM migration is migrating another array member storage device to this spare storage device.
Migration Source: DDM migration is migrating this array member storage device to another spare storage device.
Failed: The storage device has failed and an immediate repair action is required.
Failed - Deferred Service: The storage device has failed and a repair action is not immediately required.
Removed: The storage device is removed from the system and removal has been processed by the system.
Inappropriate: The storage device is incompatible with the system; for example, a storage device that has the wrong capacity or rpm. The DDM is not failed, because it can be valid for other systems and locations.
Inter failed: Indicates that the DDM is faulty but still working.
PFSed: Indicates that the DDM is prepared for service, and ready to be removed without impacting the system.

Diskclass

Specifies the disk class as either high speed fibre channel disk drives or near-line disk drives. The value displayed 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