lsportsas

Use the lsportsas command to display the status of all SAS ports in the clustered system.

Syntax

Read syntax diagramSkip visual syntax diagram lsportsas

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-filtervalue attribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?
(Optional) Displays a list of valid filter attributes.

Description

This command displays information about system port status.

This command output shows all available paths, which are defined by zoning, independent of their usage. This means that the command output includes paths that are not used because of port masking.

This table provides the attribute values that can be displayed as output view data.
Table 1. lsportsas output
Attribute Description
id Indicates the line number within the displayed information (numeric string).
port_id Indicates the ID of the port.
port_speed Indicates the speed of the I/O port (in XGb). This speed is the fastest local link speed for the SAS port. The value is the last-known port speed if the port is inactive, and N/A if port has is unused and was never active.
node_id Indicates the ID of the node that contains the port (numeric string).
node_name Indicates the name of the node that contains the port (alphanumeric string).
WWPN Indicates the worldwide port name (WWPN) for the I/O port (16-character hexadecimal string).
status Indicates the status of the port (numeric string). The values can be:
  • online if the port is functioning
  • offline if the port is not functioning
  • offline_unconfigured if not functioning but not configured by the user
  • degraded if one or more ports are not functioning or have a lower speed than others
  • excluded if excluded by the user or system
switch_WWPN Indicates the WWPN of the switch port if attached to switch (16-character hexadecimal string), or is blank. If the port is offline, the last-known value is displayed.
attachment Indicates what the port is attached to. The possible values are:
  • drive
  • controller
  • switch
  • host
  • enclosure
  • none
If the port is offline, the field shows what was attached when the port was last online.
type Indicates how the port is configured. This field also shows the devices that can be attached to the SAS port. The possible values are:
  • drive
  • enclosure
  • enclosure_controller
  • host_controller
  • none
adapter_location Displays the location of the adapter that contains the SAS port (any number in the range 0 - 6).
adapter_port_id Displays the location of the SAS port that is in the adapter (any number in the range 1 - 4).