lsportstats

Use the lsportstats command to view the port transfer and failure counts and Small Form-factor Pluggable (SFP) diagnostics data that is recorded in the statistics file for a node.

Syntax

Parameters

-node node_id_or_name: (Required) Specifies the node ID or node name of the node that has the port that you are interested in. This value is the node_id or node_name as seen in the output of lsnode or lsnodecanister.
port_id: (Optional) Specifies the specific port ID as present in the statistics file for the node. This value is the port ID as seen in output of lsportstats -node node.

Description

This command displays the statistics of a port from the statistics file for a node.

The command displays the file name of the node statistic file from which the data displayed is taken.

Pay attention to node_dump_name between "Nn_stats_" and the date stamp in the file name to be sure that it corresponds to the node that has the ports that you are interested in.
Pay attention to date and timestamp suffix of the file name to understand how recently the file was created. (YYMMDD_HHMMSS)

If a port ID is not provided, attributes for every port in the node is displayed so that you can find which port ID has the worldwide port name (WWPN) or iSCSI qualified name (IQN) that you are interested in. If a port ID is provided, a meaningful description is displayed, instead of the attribute, together with a value for the port ID given. Statistics files are only created for nodes that are online in the system and when statistics is on in the output of lssystem. See the starstats command. If the software version on your system does not support lsportstats, then you can get a utility package from https://www.ibm.com/support/home/, which installs utilportstats command such as utilporstats -node 1.

This table provides the attribute values that can be displayed as output.

Table 1. lsportstats output
Attribute	Values
port id	Indicates the port ID. The value is a positive number (integer). Every port of every type on the node is assigned a port id.
type	Indicated the connection type. The possible values are FC, iSCSI, Eth_iSCSI, SAS, PCIe, NVMe
type_id	Indicates the port ID for the above type of port. The value is a positive integer in the range of 1 up to the maximum port number for that type.
wwpn	Indicates the WWPN or the value is blank.
fc_wwpn	Indicates the Fibre Channel WWPN or the value is blank.
sas_wwn	Indicates the Serial Attached SCSI WWPN or the value is blank.
iqn	Indicates the IQN for an Ethernet port or the value is blank.
hbt	Indicates the bytes sent to hosts.
hbr	Indicates the bytes received from hosts.
het	Indicates the exchanges that are initiated to hosts.
her	Indicates the exchanges that are received from hosts.
cbt	Indicates the bytes sent to controllers.
cbr	Indicates the bytes received from controllers.
cet	Indicates the exchanges that are initiated to controllers.
cer	Indicates the exchanges that are received from controllers.
lnbt	Indicates the bytes sent to local nodes.
lnbr	Indicates the bytes received from local nodes.
lnet	Indicates the exchanges that are initiated to local nodes.
lenr	Indicates the exchanges that are received from local nodes.
rmbt	Indicates the bytes sent to remote nodes.
rmbr	Indicates the bytes received from remote nodes.
rmet	Indicates the exchanges that are initiated to remote nodes.
rmer	Indicates the exchanges that are received from remote nodes.
dtdt	Indicates the total time in microseconds for which data transmission was excessively delayed.
dtdc	Indicates the number of transfers that experienced excessive data transmission delay.
dtdm	Indicates the number of transfers that had their data transmission delay measured.
dtdt2	Indicates the data transmission delay time 2 in microseconds (µs).
dtdc2	Indicates the data transmission delay count 2.
lf	Indicates the link failure error count.
lsy	Indicates the loss of sync error count.
lsi	Indicates the loss of signal error count.
pspe	Indicates the primitive sequence protocol error count.
itw	Indicates the invalid transmission word error count.
icrc	Indicates the invalid CRC error count.
bbcz	Indicates the zero buffer-buffer credit timer in microseconds (µs).
tmp	Indicates the SFP temperature in degrees Celsius.
tmpht	Indicates the SFP temperature high alarm threshold in degrees Celsius.
txpwr	Indicates the TX power in microwatts (µW).
txpwrlt	Indicates the TX power low alarm threshold in microwatts (µW).
rxpwr	Indicates the RX power in microwatts (µW).
rxpwrlt	Indicates the RX power low alarm threshold in microwatts (µW).
hsr	Indicates the slow host Read operations.
hsw	Indicates the slow host Write operations.
har	Indicates the aborted host Read operations.
haw	Indicates the aborted host Write operations.