lstargetportfc

Use the lstargetportfc command to generate the list of host count and login count for each worldwide port names (WWPNs) required to set up Fibre Channel (FC) zoning and to display the current failover status of host IO ports.

Syntax

Read syntax diagramSkip visual syntax diagram lstargetportfc -filtervalueattribute=value-nohdr-delimdelimiter-filtervalue?

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.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcard characters when you use the CLI:
  • The wildcard character is an asterisk (*), which must be the first or last character in the string.
  • The command can contain a maximum of one wildcard.
  • When you use a wildcard, enclose the filter entry within double quotation marks ("").
-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 no data is 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 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 1-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.
-filtervalue?
(Optional) Displays the valid filter attributes for the lstargetportfc command:
  • port_id
  • owning_node_id
  • current_node_id
  • host_io_permitted
  • virtualized
  • protocol

Description

This command generates lists of worldwide port names (WWPNs) required to set up Fibre Channel (FC) zoning. This command also displays the current failover status of host I/O ports.

This table provides the attribute values that can be displayed as output view data.
Table 1. lstargetportfc output
Attribute Description
id Indicates the ID of the port.
WWPN Indicates the WWPN of the port. The value is hexadecimal.
WWNN Indicates the worldwide node name (WWNN) of the port. The value is hexadecimal.
port_id Indicates the system port ID. The value is the same as the lsportfc port_id field.
owning_node_id Indicates the ID of the node that owns the port.
Note: This node can be offline whether the port is online or offline.
current_node_id Indicates the ID of the node on which this port is active. The value is blank if the port is not active on any node
nportid Indicates the nportid hexadecimal value.
host_io_permitted Indicates whether host I/O operations can run on the port. The values are yes and no.
virtualized Indicates whether it is a virtualized port. The values are yes and no (which indicates that this port cannot be online on any node other than the owning node).
protocol Indicates the protocol supported by the port. The values are scsi and nvme.
Note: Some Fibre channel adapters and platforms do not support NVMe over Fibre Channel.
fc_io_port_id Indicates the Fibre Channel IO port ID.
portset_count Indicates the number of portsets the WWPN is added to.
host_count Indicates the number of hosts configured through WWPN through the same portset.
active_login_count Indicates the number of active login counts through WWPN. For a configured host, blocked login will not be included.

An invocation example

This example shows the concise output with the protocol field.

lstargetportfc

The detailed resulting output:


id WWPN             WWNN             port_id owning_node_id current_node_id nportid host_io_permitted virtualized protocol  fc_io_port_id portset_count host_count active_login_count
 1  500507680C111A10 500507680C001A10 1       1                              000000  no                no          scsi      1             0              0          0
 2  500507680C151A10 500507680C001A10 1       1                              000000  yes               yes         scsi      1             2              2          4
 4  500507680C121A10 500507680C001A10 2       1                              000000  no                no          scsi      2             0              0          0
 5  500507680C161A10 500507680C001A10 2       1                              000000  yes               yes         scsi      2             2              2          2
 7  500507680C211A10 500507680C001A10 3       1              1               010900  no                no          scsi      3             0              0          0
 8  500507680C251A10 500507680C001A10 3       1              1               010901  yes               yes         scsi      3             3              4          0
 9  500507680C291A10 500507680C001A10 3       1              1               010902  yes               yes         nvme      3             3              1          2
 10 500507680C221A10 500507680C001A10 4       1              1               010A00  no                no          scsi      4             0              0          0
 11 500507680C261A10 500507680C001A10 4       1              1               010A01  yes               yes         scsi      4             1              0          0
 12 500507680C2A1A10 500507680C001A10 4       1              1               010A02  yes               yes         nvme      4             1              0          0
 49 500507680C11091A 500507680C11091A 1       4                              000000  no                no          scsi      1             0              0          0
 50 500507680C15091A 500507680C11091A 1       4                              000000  yes               yes         scsi      1             0              2          0
 52 500507680C12091A 500507680C11091A 2       4                              000000  no                no          scsi      2             0              0          0
 53 500507680C16091A 500507680C11091A 2       4                              000000  yes               yes         scsi      2             0              2          0
 55 500507680C21091A 500507680C11091A 3       4                              000000  no                no          scsi      3             0              0          0
 56 500507680C25091A 500507680C11091A 3       4                              000000  yes               yes         scsi      4             4              0          0
 57 500507680C29091A 500507680C11091A 3       4                              000000  yes               yes         nvme      4             1              0          0
 58 500507680C22091A 500507680C11091A 4       4                              000000  no                no          scsi      4             0              0          0
 59 500507680C26091A 500507680C11091A 4       4                              000000  yes               yes         scsi      4             2              0          0
 60 500507680C2A091A 500507680C11091A 4       4                              000000  yes               yes         nvme      4             2              0          0

An invocation example

This example shows the full output with the protocol field.

lstargetportfc 6

The detailed resulting output:

id 6
WWPN 500507680B2AC5C6
WWNN 500507680B00C5C6
port_id 2
owning_node_id 1
current_node_id 1
nportid 071501
host_io_permitted yes
virtualized yes
protocol nvme