lsioport

The lsioport command displays a list of I/O ports on a specified storage image and optionally provides performance metrics for each I/O port that is listed.


>>-lsioport--+-------------------------+--+-----+--------------->
             '- -dev--storage_image_ID-'  +- -s-+   
                                          '- -l-'   

>--+----------------+--+--------------------------+------------->
   '- -type----fc---'  '- -topology--+-fc-al----+-'   
                                     +-scsi-fcp-+     
                                     '-ficon----'     

>--+---------------------------+--+-----------+----------------->
   '- -state--+-online-------+-'  '- -metrics-'   
              +-offline------+                    
              +-fenced-------+                    
              '-deconfigured-'                    

>--+--------------------+--------------------------------------><
   +-port_ID--+-------+-+   
   |          '-. . .-' |   
   '-" - "--------------'

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which consists of manufacturer, type, and serial number.

Note: This parameter is required if you do not specify a fully qualified port ID and you do not specify a value for the devid variable in your profile file.

-s

(Optional) Displays fully qualified port IDs. You cannot use the -l and -s parameters together.

-l

(Optional) Displays default output plus the maximum login limit and the number of current logins. You cannot use the -l and -s parameters together.

-type fc

(Optional) Displays I/O ports of the specified port type.

-topology fc-al | scsi-fcp | ficon

(Optional) Displays fibre-channel I/O ports with the specified topology.

-state online | offline | fenced | deconfigured

(Optional) Displays I/O ports of the specified state.

-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 unit 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, or 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 - 01 (1750 machine types).
A is the adapter number and is specified as 0, 1, 2, or 3 (1750 machine types).
P is the port number (0 - 3).

To specify a range of port IDs, separate the port IDs with a hyphen.

You must separate multiple port IDs or ranges of port IDs by a blank space between each ID or range of IDs.

If you specify the dash (-), this parameter information is automatically supplied.

Example

For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

The following tables represent the headers that are displayed on the output reports that are associated with the lsioport command. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the lsioport command

dscli>lsioport –dev IBM.2107-75FA120 -l

The resulting output

Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0
DS: IBM.2107-75FA120

ID	WWPN	State	Type	Topo	Portgrp
IBM.2107 -75FA120 /I0111	307BCF30 A3299E0	Online	Fibre Channel-LW	SCSI-FCP	0

Report field definitions (without the -metrics parameter)

ID

Specifies the fully qualified port ID, which includes the storage image ID.

WWPN

Specifies the fibre channel worldwide port number. If the port type is not fibre channel, the value displayed is null (-).

State

Specifies the current I/O port status. One of the following values can be displayed:

Online: Indicates that the storage unit is capable of processing all functions (default).
Offline: Indicates that the storage unit is not capable of processing any functions.
Resuming: Indicates that the storage unit is in the process of coming online.
Quiescing: Indicates that the storage unit is in the process of going offline.
Fenced: Indicates that the storage unit has failed and is offline.
Deconfigured: Indicates that the I/O port is in the process of being deleted.

Type

Specifies the port type. The following values can be displayed:

Fibre Channel-SW - (SW stands for short wave)
Fibre Channel-LW - (LW stands for long wave)

Topo

Specifies the I/O port topology. The following values can be displayed:

FC-AL
SCSI-FCP
FICON
Null (-) This value is displayed when the port type is not fibre channel.

Portgrp

Specifies 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.

Report field definitions (with -metrics parameter)

When you use the -metrics parameter and do not specify a port type, two reports are displayed. One report is for the FICON I/O port type and the other report is for the SCSI-FCP I/O port type. A banner is displayed (for example: ===FICON-Enabled I/O Ports===) before each report. A report is not displayed for a port type that has no ports that are enabled.

FICON ports: Each of the following headers and value types are displayed:

ID: Specifies the fully qualified port ID.
Date: Specifies 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.
byteread: Specifies the number of bytes that are read in 128 KB increments.
bytewrit: Specifies the number of bytes that are written in 128 KB increments.
Reads: Specifies a value that is based on extended count-key-data (ECKD) data received operations.
Writes: Specifies a value that is based on ECKD data transferred operations.
Timeread: Specifies 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.
Timewrite: Specifies 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.

SCSI-FCP ports: Each of the following headers and value types are displayed:

ID: Specifies the fully qualified port ID.
Date: Specifies the current time stamp for the I/O port performance counters. For example, 08/11/05 02:23:49 is the format used to report this value.
Bytewrit: Specifies a value for the remote mirror and copy data transferred operations in increments of 128 KB.
Byteread: Specifies a value for the remote mirror and copy data received operations in increments of 128 KB.
Writes: Specifies a value for the remote mirror and copy data transferred operations.
Reads: Specifies a value for the remote mirror and copy data received operations.
Timewrite: Specifies 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: Specifies 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: Specifies a value that is based on the SCSI data received operations. The displayed value is based on increments of 128 KB.
Reads: Specifies a value that is based on the SCSI data transferred operations.
Writes: Specifies a value that is based on the SCSI data transferred operations.
Timeread: Specifies 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: Specifies 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.