The showioport command displays properties of an I/O port. It optionally displays the performance metrics for a specific I/O port.
>>-showioport--+-------------------------+--+-----------+-------> '- -dev--storage_image_ID-' '- -metrics-' >--+-port_ID-+------------------------------------------------->< '-" - "---'
Parameters
- -dev storage_image_ID
- (Optional) Specifies the storage image ID, which consists of the manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the port.
- -metrics
- (Optional) Specifies that the port ID and the performance metrics for
the specified I/O port be displayed.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 | -
- (Required) Displays the property level details for the specified port IDs. This parameter accepts a fully qualified unique port ID, that is represented in the following format: manufacturer.machine type-serial number/portID.
Example
For this command and all other DS CLI show 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 showioport command. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.
Invoking the showioport command to show port information
dscli>showioport -dev IBM.2107–75FA120 I0112
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 | Loc | Type |
|---|---|---|---|---|
IBM.2107 |
307ACF30 |
Online | U2107– |
Fibre |
| Topo | Portgrp | unkSCSIlog |
|---|---|---|
| SCSI-FCP | 0 | - |
Report field definitions (without the -metrics parameter)
- ID
- Specifies the fully qualified unique port ID.
- WWPN
- Specifies the fibre channel I/O port worldwide port number (WWPN). If the port type is not fibre channel, this value is specified as a null (-).
- State
- Specifies the current state of the I/O port. One of the following values
is 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.
- Loc
- Specifies the storage enclosure location by identifying the storage unit frame that contains the storage enclosure. The location format is Utttt.mmm.ppsssss.
- 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 port topology. If the port type is not fibre channel, then
the displayed value is null (-). One of the following values is displayed:
- FC-AL
- SCSI-FCP
- FICON
- - (null if not fibre channel)
- Portgrp
- Specifies an identifier that associates a subset of the I/O port objects that are operating in anonymous access mode.
- unkSCSIlog
- Specifies a list of unknown SCSI N-port WWPN identifiers that have attempted to login into this I/O port.
Report field definitions (with the -metrics parameter)
- 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 way that this value is reported.
- byteread
- Specifies the number of bytes that are read in increments of 128 KB.
- bytewrit
- Specifies the number of bytes that are written in increments of 128 KB.
- Reads
- Specifies a value that is based on the extended count-key-data (ECKD) architecture data received operations.
- Writes
- Specifies a value that is based on the ECKD architecture data transferred operations.
- Timeread
- Specifies a value that is based on the ECKD 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 ECKD data transferred (write-accumulated time) on a channel. The displayed value is based on increments of 16 milliseconds.
- Bytewrit
- Specifies a value for the remote mirror and copy data transferred operation 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 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 received 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.