lshostport

Edit online

The lshostport command displays a list of host ports for a specified storage image and status information for each host port in the list.

Read syntax diagramSkip visual syntax diagram lshostport  -dev   storage_image_ID  -s -l -unknown  -login  -host host_name  -unassigned   WWPN  [ ...]   "-"

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 host port. It is also required if you did 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 the worldwide port name (WWPN) of the host ports. You cannot use the -l and the -s parameters together.
-l
(Optional) Displays the default output and user-defined description for each host port in the list. You cannot use the -l and the -s parameters together.
-unknown
(Optional) Displays a list of logged in host ports (WWPNs) that are not recognized as being associated with the designated storage system.
Note: You cannot use the -unknown parameter with the -login, -host, -unassigned, or WWPN parameters.
-login
(Optional) Displays a list of host ports (WWPNs) that are logged in and sorted by the ESS I/O port IDs for known connections. The report displays one line of information per connection. However, no information is displayed for a FICON® connection.
Notes:
  1. Known logins are logins that you created for host connections, Remote Mirror and Copy paths, and anonymous connections.
  2. You cannot use the -login parameter with the -unknown, -host, -unassigned, or WWPN parameters.
-host host_name
(Optional) Displays host port information that is associated with the specified host.
Notes:
  1. If you specify a host name with a blank space, enclose the name with double quotation marks.
  2. The -host parameter is not compatible with the -unassigned parameter.
-unassigned
(Optional) Displays host port information that is not associated with other hosts.
Note: The -unassigned parameter is not compatible with the -host, -unknown, or -login parameters.
WWPN [...] | -
(Optional) Displays host port information for one or more specified host ports (WWPNs). If you specify multiple WWPNs, separate each one with a blank space. You can specify the fully qualified WWPN or the shortened version of the WWPN.

If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example 1: Displaying a list of host ports
dscli> lshostport -l
Output
WWPN Name Type State Volumes AddrMode I/O ports Host
210100E08B
295F86
 Name_1 VMWare logged in 8 scsimap256 32 (all) host_1
310106E04
B2D5E45
 - VMWare logged out 6 scsimap256 3 -
310106E04B
2D5F10
 - - - 0 - 0 -

Output definitions

WWPN*
WWPN for the specified host port.
Name
Name of the host port.
Type
Host type that is defined by the operating system and platform of the host.

When information is not available, the output displays "Unknown".

State
Login state of the host. One of the following values displays.
Logged in
A host port is created for an available physical connection.
Logged out
A host port is created but a physical connection is not established and the connection is not available.
unknown
A host port is created but the state is invalid (not logged in or logged out).
"-"
A physical connection is established but a host port is not created.
Volumes+
Number of volumes that are mapped to this host port.
AddrMode+
Method that is used by the host to discover the LUNs that are available to its host ports. One of the following values display.
scsimask
SCSI mask volume group. This option is available if the host adapter supports 4-byte LUN addresses.
scsimap256
Indicates a SCSI-MAP 256 volume group.
os400mask
OS/400® mask volume group. The IBM® i host system typically uses fixed block volumes of 520-byte logical block size. This option is available only if the host adapter supports 4-byte LUN addresses.
Note: This volume group is also referred to as SCSI520-MASK. When an error message is displayed for the os400mask, SCSI520-MASK is referenced instead.
I/O ports+
Number of I/O ports that this host is allowed to log into. The value of "all" indicates that this SCSI host is allowed to log into any I/O port.
Host+
Nname of the host that the specified host port is assigned to. The value of "-" indicates that the host port is not assigned to any host.
Key:
*
Displayed when the -s parameter is specified.
+
Displayed only when the -l parameter is specified.
Example 2: Displaying a list of logged in host ports (WWPNs) that are not associated with the storage system
dscli> lshostport -dev IBM.2107-75FA120 -unknown

Output

WWNN WWPN ESSIOport
5005076306FFD341 5005076306FFD341 I0221

Output definitions

When you specify the -unknown parameter, the WWPN and WWPN identifiers and ESSIOport IDs also display.
WWNN
WWNN for the specified host system.
WWPN
WWPN for the specified host port.
ESSIOport
Port ID to which the designated host port is logged in to. A port ID is prefixed with the letter I and consists of four hexadecimal characters in the format EEAP, where:
EE
An I/O port enclosure number in the range of 00 - 17.
A
The adapter number and is specified as 1, 2, 4, or 5.
P
The port number (0 - 3).
Example 3: Displaying a list of logged in host ports (WWPNs) that are associated with the storage system 
dscli> lshostport IBM.2107-75FA120 -login

Output

WWNN WWPN Host I/O ports ESSIOport
5005076306FFD341 5005076306FFD341 - 32 (all) I0221
When you specify the -login parameter, the WWPN and WWPN identifiers, host, I/O ports and ESSIOport IDs also display.

Output definitions

WWNN
WWNN for the specified host system.
WWPN
WWPN for the specified host port.
Host
Name of the host that the specified host port is assigned to. A hyphen (-) displays if the host port is not associated with a host.
I/O ports
Number of I/O ports that this host is allowed to log into. All displays if the specified SCSI host is allowed to log into any I/O port.
ESSIOport
Port ID to which the designated host port is logged in to. A port ID is prefixed with the letter I and consists of four hexadecimal characters in the format EEAP, where:
EE
An I/O port enclosure number in the range of 00 - 17.
A
The adapter number and is specified as 1, 2, 4, or 5.
P
The port number (0 - 3).