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 [ -filtervalue attribute=value ] [ -filtervalue? ] [ -nohdr ] [ -delim delimiter ] [ 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.

lsportfc output 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 Indicates a unique value for the object. The value must be a numeric 0 or greater.
fc_io_port_id Indicates the FC I/O port ID. The value must be a positive integer.
port_id Indicates the platform port ID. The value must be a positive integer.
type Indicates the type of platform port. The value can be either fc or ethernet.
port_speed Indicates 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 Indicates the ID of the node containing the port. The value must be a positive integer.
node_name Indicates the name of the node containing the port.
WWPN Indicates the I/O port worldwide port name (WWPN). The value must be in 16-character hexadecimal format.
nportid Indicates 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 Indicates if the port is configured to a device of Fibre Channel (FC) port. The values are:
  • active
  • inactive_configured
  • inactive_unconfigured.
switch_WWPN Indicates 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 Indicates 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 Indicates 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 Indicates 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 Indicates 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 Indicates 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 Indicates the location of the adapter containing the Ethernet port (any number from 0 to 6).
adapter_port_id Indicates the location of the Ethernet port that is in the adapter (any number from 1 to 4).
fabric_WWN Indicates the World Wide Name (WWN) value for the connected fabric string. The value must be in 16-character hexadecimal format, or all zeroes if the port has never been active or the port is not connected to a fabric.

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 none
adapter_location 1
adapter_port_id 1fabric_WWN 202700053346FA3C