lscontroller

The list report style can be used to obtain two styles of report.
  1. A list containing concise information about controllers. (Each entry in the list corresponds to a single controller.)
  2. The detailed information about a single, user specified, controller.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svcinfo -- -- lscontroller -- ------------------------------>

>--+--------------------------------+-- --+----------+-- ------->
   '- -filtervalue -- attrib=value -'     '- -nohdr -'

>--+-----------------------+-- --+-------------+-- ------------->
   '- -delim -- delimiter -'     +- object_id -+
                                 '- name ------'

>--+-----------------+-----------------------------------------><
   '- -filtervalue? -'

Parameters

-filtervalue attribute=value
Optionally specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.
-nohdr
By default, headings are displayed for each column of data (in a concise style view), and each item of data (in a detailed style view). Using the -nohdr parameter will suppress the display of these headings.
Note:Note: If there is no data to be displayed (for example, an empty view has been returned), then headings are not displayed irrespective of whether the -nohdr option was used or not.
-delim delimiter
By default in a concise view, all columns of data are space separated. The width of each column is set to the maximum possible width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed the data is separated from the header by a space. Using the -delim parameter will override this behavior. Valid input for the -delim parameter is a one byte character. If, for example, you entered -delim : a colon will be used to separate all items of data in a concise view (for example, the spacing of columns does not occur) and in a detailed view the data is separated from its header by a colon.
object_id | name
Optionally specifies the name or ID of a controller. If not supplied, the concise view of all objects, or all of those objects matching the filtering requirements in -filtervalue (if specified), of the given type are returned. If supplied, the detailed view of the specific object is returned, and any filtervalue entry (if entered) is ignored.
-filtervalue?
Display a list of valid filter attributes. The valid filters for the svcinfo lscontroller command is:
  • controller_id
  • id

Description

This command will return a concise list or a detailed view, of controllers visible to the cluster.

The following list provides possible values that are applicable to the attributes that are displayed as data in the output views:
degraded no, yes

Determining a storage controllers name from its SAN Volume Controller name: List the storage controllers by issuing the svcinfo lscontroller command. Remember the controller name or ID for the controller you want to determine. For the controller in question, issue the svcinfo lscontroller <controllername/id> command, where <controllername/id> is the controller name or ID. Remember the WWNN for the controller. Make a written record of it. The WWNN can be used to determine the actual storage controller by launching the native controller user interface or using the command line tools it provides to verify the actual controller that has this WWNN.

Determining the relationship between MDisks and RAID arrays or LUNs: Each MDisk corresponds with a single RAID array, or a single partition on a given RAID array. Each RAID controller will define a LUN number for this disk. The LUN number and controller name or ID are needed to be able to determine the relationship between mdisks and RAID arrays or partitions.

Show the detailed view of the given MDisk <mdiskname>, by issuing the svcinfo lsmdisk <mdiskname> command, where <mdiskname> is the name of the MDisk.

Note:Note: Remember the controller name or controller ID and controller LUN number.

Show the detailed view of the controller determined in by issuing the svcinfo lscontroller <controllername> command, where <controllername> is the name of the controller.

Note:Note: Remember the vendor ID, product ID, and WWNN. Use these to determine what is being presented to the MDisk.

From the native user interface for the given controller, list the LUNs it is presenting and match the LUN number. This will tell you the exact RAID array or partition that corresponds with the MDisk.

Possible failures

Examples

A concise invocation example

svcinfo lscontroller -delim :

The concise resulting output

id:controller_name:ctrl_s/n:vendor_id:product_id_low:product_id_high
7:controller7:3EK0J5Y8:SEAGATE :ST373405:FC      
8:controller8:3EK0J6CR:SEAGATE :ST373405:FC      
9:controller9:3EK0J4YN:SEAGATE :ST373405:FC      
10:controller10:3EK0GKGH:SEAGATE :ST373405:FC      
11:controller11:3EK0J85C:SEAGATE :ST373405:FC      
12:controller12:3EK0JBR2:SEAGATE :ST373405:FC      
13:controller13:3EKYNJF8:SEAGATE :ST373405:FC      
14:controller14:3EK0HVTM:SEAGATE :ST373405:FC 

Examples

A detailed invocation example

svcinfo lscontroller -delim = 7

The detailed resulting output

id=7
controller_name=controller7
WWNN=20000004CF2412AC
mdisk_link_count=1
max_mdisk_link_count=1
degraded=no
vendor_id=SEAGATE 
product_id_low=ST373405
product_id_high=FC      
product_revision=0003
ctrl_s/n=3EK0J5Y8
WWPN=22000004CF2412AC
path_count=1
max_path_count=1
WWPN=21000004CF2412AC
path_count=0
max_path_count=0

Related topics

(C) Copyright International Business Machines Corporation 2003, 2004