lsioport

The lsioport command displays a list of all I/O ports (ESCON and Fibre Channel type) that are installed in a specified storage image, and optionally provides performance metrics for each I/O port listed.

Read syntax diagramSkip visual syntax diagramlsioport  -dev  storage_image_ID  -s  -l  -type  fc  escon  -topology  scsi-fcp  ficon  -state offline  resuming quiescing fenced  deconfigured  no_light_detected communication_established  -security disabledenabled enforced -metrics  port_ID  ...  "-"

Parameters

-dev storage_image_ID
(Optional) The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified port ID. It is also required if you do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.
-s
(Optional) Displays fully qualified port IDs. You cannot use the -l and -s parameters together.
-l
(Optional) Displays default output plus the I/O port interface speed.
-type fc | escon
(Optional) Displays I/O ports of the specified port type. The Escon option can be specified as the port type
-topology scsi-fcp | ficon
(Optional) Displays Fibre Channel I/O ports with the specified topology.
-state offline | resuming | quiescing | fenced | deconfigured | no_light_ detected | communication_established
(Optional) Displays I/O ports of the specified state. See the Example section for the state descriptions.
-security enabled | disabled | enforced
(Optional) Displays the current security setting of an I/O port. One of the following values is displayed.
Disabled
Endpoint Security is not enabled for the port.
Enabled
Endpoint Security is enabled to allow authentication between the host and the port, but authentication is not required for I/O processing.
Enforced
Endpoint Security is enabled and authentication is required between the host and the port for I/O processing. Host ports that do not support security or do not complete authentication will be logged out and denied login.
-metrics
(Optional) Displays port ID and performance metrics for each port that is specified.
Note: All performance counts are an accumulation since the most recent counter-wrap or counter-reset operation. I/O port performance counters are reset with a storage system power-on sequence.
port_ID ... | -
(Optional) Displays I/O ports that match the specified IDs. This parameter accepts a fully qualified port ID, which includes the storage image ID. You can also specify a shortened version without the storage image ID when the -dev parameter is specified.
A port ID is prefixed with the letter "I" and consists of four hexadecimal characters in the format EEAP, where:
  • EE is an I/O port enclosure number in the range of 00 - 17.
  • A is the adapter number and is specified as 1, 2, 4, or 5.
  • P is the port number (0 - 3).

Example 1: Displaying a list of all I/O ports (ESCON and Fibre Channel type) that are installed in a specified storage image

dscli> lsioport –dev 2107-75FA120 -l
Output
Note: For DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.
ID WWPN State Type Topo Portgrp Speed Security
2107-75FA120/I0111
307BCF30
A3299E0
Communication
Established
Fibre
Channel-LW
SCSI-FCP 0 1 Gb/s Disabled
Frame I/O Enclosure HA Card
1 2 4

Report field definitions (without the -metrics parameter)

ID
The fully qualified port ID, which includes the storage image ID.
WWPN
The Fibre Channel worldwide port number. If the port type is not Fibre Channel, the value that is displayed is " - ".
State
The current I/O port status. One of the following values can be displayed:
Offline
The state of the port that is internal to the storage system and indicates that the port is not capable of processing I/O.
Resuming
The storage system is coming online.
Quiescing
The storage system is going offline.
Fenced
The storage system failed and is offline.
Deconfigured
The I/O port is being deleted.
No Light Detected
There is no light that is detected on the port and, therefore, the port is not capable of processing I/O.
Communication Established
The storage system can process all functions.
Type
The port type. The following values can be displayed:
  • Fibre Channel-SW (short wave)
  • Fibre Channel-LW - (long wave, 10 KM)
  • Fibre Channel-LW 4 KM
  • ESCON
Topo
The I/O port topology. The following values can be displayed:
  • SCSI-FCP
  • FICON®
  • " - " This value is displayed when the port type is not Fibre Channel.
Portgrp
The identifier that associates a subset of the I/O ports that are operating in anonymous access mode. Default value is 0 when these subsets are not specified.
Speed
The I/O port interface speed. The following values can be displayed:
  • ESCON ports = 200 Mb/s
  • FCP ports = 1 Gb/s, 2 Gb/s, 4 Gb/s, 8 Gb/s, 16 Gb/s, 32 Gb/s
  • FICON ports = 1 Gb/s, 2 Gb/s, 4 Gb/s, 8 Gb/s, 16 Gb/s, 32 Gb/s
Security
The current security setting of an I/O port. One of the following values is displayed.
Disabled
Endpoint Security is not enabled for the port.
Enabled
Endpoint Security is enabled to allow authentication between the host and the port, but authentication is not required for I/O processing.
Enforced
Endpoint Security is enabled and authentication is required between the host and the port for I/O processing. Host ports that do not support security or do not complete authentication will be logged out and denied login.
Frame
Identifies the unique identifier of the storage system frame that contains the I/O enclosure.
I/O Enclosure
Identifies the unique identifier of the I/O enclosure that contains the host adapters.
HA Card
Identifies the ID number of the host adapter.

Report field definitions (with the -metrics parameter)

When you use the -metrics parameter and do not specify a port type, separate reports are displayed for storage system models:
  • FICON/ESCON IO port type: A banner is displayed (for example: ===FICON/ESCON-Enabled I/O Ports===) before each report.
  • SCSI-FCP IO port type.
  • Security Login Counts per FC IO Port
Note: A report is not displayed for a port type that has no enabled ports.

FICON/ESCON ports

Each of the following headers and value types is displayed:
ID
The fully qualified port ID.
Date
The current time stamp for the I/O port performance counters. For example, 08/11/14 02:23:49 is the format that is used to report this value.
bytewrit
The number of bytes that are written in 128 KB increments.
byteread
The number of bytes that are read in 128 KB increments.
Reads
Indicates a value that is based on extended count-key-data (ECKD) data received operations.
Writes
Indicates a value that is based on ECKD data transferred operations.
Timewrite
Indicates a value that is based on the ECKD data that is transferred (write-accumulated time) on a channel. The displayed value is based on increments of 16 milliseconds.
Timeread
Indicates a value that is based on the ECKD data that is received (read-accumulated time) on a channel. The displayed value is based on increments of 16 milliseconds.
CmdRetries
The number of retries that are requested for transport mode write operations.
TransferReady
The number of transport mode operations from channels that require transfer ready and that were received from channels that support transport mode command retry operations.

SCSI-FCP ports

Each of the following headers and value types is displayed:
ID
The fully qualified port ID.
Date
The current time stamp for the I/O port performance counters. For example, 08/11/05 02:23:49 is the format that is used to report this value.
Bytewrit
Indicates a value for the remote mirror and copy data transferred operations in increments of 128 KB.
Byteread
Indicates a value for the remote mirror and copy data received operations in increments of 128 KB.
Writes
Indicates a value for the remote mirror and copy data transferred operations.
Reads
Indicates a value for the remote mirror and copy data received operations.
Timewrite
Indicates a value that is based on the remote mirror and copy data transferred (write-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds.
Timeread
Indicates a value for the remote mirror and copy data received (read-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds.
Byteread
Indicates a value that is based on the SCSI data received operations. The displayed value is based on increments of 128 KB.
Reads
Indicates a value that is based on the SCSI data transferred operations.
Writes
Indicates a value that is based on the SCSI data transferred operations.
Timeread
Indicates a value that is based on the SCSI data received (read-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds.
Timewrite
Indicates a value that is based on the SCSI data transferred (write-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds.
Security Login Counts per FC IO Port
Note: The Security Login Counter per FC IO Port report applies to all types of ports.
Each of the following headers and value types is displayed.
ID
The fully qualified port ID.
Logins
The number of remote hosts or peer N_ports currently logged in to the specified I/O port.
SecCapableLogins
The number of logins that are capable of Fibre Channel security protocols. (The security bit is set in both N_ port login and response.) If the port is security-enabled, the remote ports are expected to perform authentication.
AuthLogins
The number of security-capable logins that have negotiated link authentication.
EncryptedLogins
The number of remote host or peer N_ports currently logged into the specified port that successfully authenticated and negotiated an encryption algorithm for IBM® Fibre Channel Endpoint Security.

Example 2: Without any parameters

dscli> lsioport
Output
ID WWPN State Type Topo Portgrp Security
I0100
50050763
06081343
Communication
Established
Fibre Channel-SW FICON 0 Disabled

Example 3: With the security parameter

dscli> lsioport -security enabled
Output
ID WWPN State Type Topo Portgrp Security
I0101
50050763
06085344
Communication
Established
Fibre Channel-SW SCSI-FCP 0 Enabled

Example 4: With the metrics parameter

dscli> lsioport -metrics I0100
Output
ID Logins SecCapableLogins AuthLogins EncryptedLogins
I0100 0 0 0 0

Report field definitions (with -metrics and –l parameters)

Fibre Channel Link Errors: Each of the following headers and value types is displayed:
ID
The fully qualified port ID.
LinkFailErr
The total number of miscellaneous Fibre Channel link errors.
LossSyncErr
The number of loss of synchronization errors. These errors occur when there is a confirmed and a persistent synchronization loss on the Fibre Channel link.
LossSigErr
The number of times that a loss of signal was detected on the Fibre Channel link when a signal was previously detected.
PrimSeqErr
The number of primitive sequence protocol error counts where an unexpected primitive sequence was received.
InvTxWordErr
The number of times a "bit" error was detected. Examples of a "bit" errors are a code violation, an invalid special code alignment, or a disparity error.
CRCErr
The number of times the CRC of a received frame is in error.
LRSent
The number of times the port changed from an active (AC) state to a Link Recovery (LR1) state.
LRRec
This count is the number of times the port that is changed from an active (AC) state to a Link Recovery (LR2) state.
IllegalFrame
The number of frames that violated the Fibre Channel protocol. One example of a violation is an invalid frame header, which occurs when the first frame of a data sequence is missing and a subsequent data frame is detected as illegal.
OutOrdData
The number of times that an out-of-order frame is detected. The frame is either missing from a data sequence or it is received beyond the sequence reassembly threshold of the port.
OutOrdACK
The number of times that an out-of-order ACK frame is detected. The frame is either missing from a data sequence or it is received beyond the sequence reassembly threshold of the port.
DupFrame
The number of times a frame was received that was detected as previously processed.
InvRelOffset
The number of times that a frame was received with bad relative offset in the frame header.
SeqTimeout
The number of times the port detected a timeout condition after receiving a sequence initiative for a Fibre Channel exchange.
BitErrRate
The number of the bit error (invalid transmission word) bursts for the previous 5-minute counting window. This number is reset every 5 minutes.
Read Diagnostic Parameters: Each of the following headers and value types is displayed:
ID
The fully qualified port ID.
TxPower
The measured coupled TX output power in dBm and uW. The maximum value is 18.1 dBm (6500 uW).

If value displays 0 when the link state is active, the function is not supported by the current level of microcode.

RxPower
The measured received optical power in dBm and uW. The maximum value is 18.1 dBm (6500 uW).

If value displays 0 when the link state is active, the function is not supported by the current level of microcode.

TransceiverTemp
The internally measured transceiver temperature. This value is reported in the range -128 C to + 128 C.

If value displays 0 when the link state is active, the function is not supported by the current level of microcode.

SupplyVolt
The internally measured supply voltage. This value is reported in mV and the value range is 0 - 6550 mV.

If value displays 0 when the link state is active, the function is not supported by the current level of microcode.

TxBiasCurrent
The measured transmitter laser bias current. This value is reported in mA and is in the value range of 0-131mA.

If value is 0 when the link state is active, the function is not supported by the current level of microcode.

ConnectorType
Indicates 1 of 3 connector type values:
SFP+
A transmit power level of small form factor pluggable device.
Unknown
The connector type might not be determined.
Dash (-)
The data was not available.
TxType
A value for the Port Tx type:
Laser-SW
A short-wave laser port.
Laser LC 1310-LW
A long-wave laser LC 1310 nm port.
Laser LL 1550-LW
A long-wave laser LotusLive 1550 nm port.
Non-Optical
The port is not optical or is of another type.
Unknown
The port type is not recognized.
Dash (-)
The data was not available.
CurrentSpeed
The current operating link speed:
  • Inactive – Link not operational
  • 200 Mb/s – ESCON
  • 1 Gb/s – Fibre Channel 1 Gb/s
  • 2 Gb/s – Fibre Channel 2 Gb/s
  • 4 Gb/s – Fibre Channel 4 Gb/s
  • 8 Gb/s – Fibre Channel 8 Gb/s
  • 16 Gb/s – Fibre Channel 16 Gb/s
  • 32 Gb/s - Fibre Channel 32 Gb/s
Note: A dash (-) specifies that data was not available.
FECStatus
The Forward Error Correction (FEC) process status on the link:
Active
FEC is active on the link.
Inactive
FEC is not active on the link.
UncorrectedBlks(RDP)
The number of bad data blocks that were not corrected by the Forward Error Correction (FEC) process. For more information, see the showioport command.
Note: A dash ( - ) means that the data is not available.
CorrectedBlks(RDP)
The number of bad data blocks that were corrected by forward error correction (FEC) process. For more information, see the showioport command.
Note: A dash ( - ) means that the data is not available.