lsportfc

Use the lsportfc command to view the status and properties of the Fibre Channel (FC) input/output (I/O) ports for the clustered system.

Syntax

lsportfc [ -filtervalueattribute=value ] [ -filtervalue? ] [ -nohdr ] [ -delimdelimiter ] [ object_id ]

Parameters

-filtervalue attribute=value
(Optional) 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.
-filtervalue?
(Optional) Displays the valid filter attributes. The following filter attributes for the lsportfc command are valid:
  • type
  • status
  • node_id
  • fc_io_port_id
  • attachment
-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-delim delimiter
(Optional) 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. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a one-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
object_id
(Optional) Specifies the ID of an object displayed in the view.

Description

This command enables you to view information about clustered system port status.

Table 1 provides the attribute values that can be displayed as output view data.
The following table shows the possible outputs:
Table 1. lsportfc output
Attribute Description
id Specifies a unique value for the object. The value must be a numeric 0 or greater.
fc_io_port_id Specifies the FC I/O port ID. The value must be a positive integer.
port_id Specifies the platform port ID. The value must be a positive integer.
type Specifies the type of platform port. The value can be either fc or ethernet.
port_speed Specifies the I/O port speed. The value is XGb. The value is N/A if the port has never been active. If the port is inactive it shows the last-known port speed.
node_id Specifies the ID of the node containing the port. The value must be a positive integer.
node_name Specifies the name of the node containing the port.
WWPN Specifies the I/O port worldwide port name (WWPN). The value must be in 16-character hexadecimal format.
nportid Specifies the most recent NPort ID used by the port. The value must be in 6-character hexadecimal format, and all zeroes if never active.
status Specifies if the port is connected to a device. The value is active or inactive.
switch_WWPN Specifies the WWPN of the device most recently attached to the port. The value must be in 16-character hexadecimal format, or all zeroes if the port has never been active.
fpma Specifies the Fabric Provided MAC Address (FPMA) assigned to the Fiber Channel over Ethernet (FCoE) VN_PORT port. The value is a formatted 48-bit MAC address. If the switch is connected to an FCF, the value is N/A for ports that are never active. If the port is inactive the last-known FPMA is used.
vlan_id Specifies the VLAN ID on which a specific VN port is communicating. The value is up to a 4-character decimal string. The value is N/A for ports that are never active. If the port is inactive the last-known VLAN ID is used.
fcf_MAC Specifies the MAC address for the switch attached to the VN port. The value is N/A for ports that are never active. The value is a formatted 48-bit MAC address. If the port is inactive the last known fcf_MAC value is used.
attachment Specifies if the port is attached to an FC switch or directly to an FC host. (Or, if the port is offline, it specifies which one it was attached to when last online.)
cluster_use Specifies the node's current capability for local or partner cluster communications:
  • none indicates the port cannot be used for any node communication
  • local indicates the port can be used for local clustered system (system) node communication
  • partner indicates the port can be used for partner system node communication
  • local_partner indicates the port can be used for both local and partner system node communication
adapter_location Displays the location of the adapter containing the Ethernet port (any number from 0 to 6).
adapter_port_id Displays the location of the Ethernet port that is in the adapter (any number from 1 to 4).

A concise invocation example

lsportfc

The resulting output:

id fc_io_port_id port_id type     port_speed node_id node_name WWPN             nportid status                 attachment cluster_use    adapter_location  adapter_port_id
0  1             1       fc       8Gb        1       node1     500507680140BADD 0E2411  active                 switch     local_partner  1                  1
1  2             2       fc       8Gb        1       node1     500507680130BADD 0E2412  active                 switch     local_partner  1                  2
2  3             3       fc       N/A        1       node1     500507680110BADD 000000  inactive_unconfigured  none       partner        1                  3
3  4             4       fc       N/A        1       node1     500507680120BADD 000000  inactive_unconfigured  none       none           1                  4
4  5             3       ethernet 10Gb       1       node1     500507680150BADD 0E2413  active                 switch     local          2                  1
5  6             4       ethernet 10Gb       1       node1     500507680160BADD 0E2414  inactive_configured    switch     local          2                  2
6  1             1       fc       N/A        2       node2     500507680140BADE 000000  inactive_unconfigured  none       local_partner  2                  3
7  2             2       fc       N/A        2       node2     500507680130BADE 000000  inactive_unconfigured  none       local_partner  2                  4
8  3             3       fc       N/A        2       node2     500507680110BADE 000000  inactive_unconfigured  none       partner        3                  1
9  4             4       fc       N/A        2       node2     500507680120BADE 0E2414  active                 switch     none           3                  2
10 5             3       ethernet 10Gb       2       node2     500507680150BADE 0E2415  active                 switch     local          3                  3
11 6             4       ethernet 10Gb       2       node2     500507680160BADE 0E2416  active                 switch     local          3                  4

A detailed invocation example

lsportfc 10

The detailed resulting output:

id 10
fc_io_port_id 5
port_id 3
type ethernet
port_speed 10Gb
node_id 6
node_name node3
WWPN 50050768015051E5
nportid 012701
status active
switch_WWPN 202700053346FA3D
fpma 0E:FC:00:01:27:01
vlanid 100
fcf_MAC 00:05:73:C2:CA:B4
cluster_use noneadapter_location 1
adapter_port_id 1