lshost

The list report style can be used to obtain two styles of report.
  1. A list containing concise information about all the hosts visible to the cluster. (Each entry in the list corresponds to a single host.)
  2. The detailed information about a single host.

Syntax

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

>--+--------------------------------+-- --+----------+-- ------->
   '- -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 an object. 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 lshost command are:
  • host_name
  • host_id
  • port_count
  • name
  • id

Description

This command will return a concise list or a detailed view, of hosts 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:
status offline, online, degraded, degraded (offline)

Possible failures

Examples

A concise invocation example

svcinfo lshost -delim :

The concise resulting output

id:name:port_count
0:hhost1port:1
1:hhost3ports:3
2:hhost:1

A detailed invocation example

svcinfo lshost -delim : 1

The detailed resulting output

id:1
name:hhost3ports
port_count:3
WWPN:00000000000000AB
port_logged_in_count:0
WWPN:00000000000000AC
port_logged_in_count:0
WWPN:00000000000000AD
port_logged_in_count:0

Related topics

(C) Copyright International Business Machines Corporation 2003, 2004