lshostconnect

The lshostconnect command displays a list of host connections for a storage image and the status information for each host connection in the list.

You can also use this command to obtain a list of worldwide port numbers (WWPNs) from a system-detected-unknown host port. You can use these WWPNs to create a host connection by using the mkhostconnect command.

Read syntax diagramSkip visual syntax diagramlshostconnect  -dev  storage_image_ID  -s  -l  -portgrp  port_grp_number  -volgrp  volume_group_ID  -unknown  -login  -wwpn  wwpn  host_connection_ID  ...   "-"

Parameters

-dev storage_image_ID
(Optional) The host connections for the specified storage image. A storage image ID consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified host connection ID, 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.
An example of a fully qualified storage image ID: IBM.2107-75FA120.
-s
(Optional) The host connection IDs. You cannot use the -l and the -s parameters together.
-l
(Optional) The default output and your description for each host connection in the list. You cannot use the -l and the -s parameters together.
-portgrp port_grp_number
(Optional) The host connections that have an associated group number.
Note: You cannot use the -portgrp parameter with the -unknown or -login parameters.
-volgrp volume_group_ID
(Optional) Only the host connections with the specified volume group ID are to be displayed. The volume group ID is a four-digit decimal number with no leading zeros, prefixed with the letter V.
Note: You cannot use the -volgrp parameter with the -unknown or -login parameters.
-unknown
(Optional) A list of logged in host ports (WWPNs), that are not recognized as being associated with the designated storage system, be displayed.
Note: The list of logged in host ports includes all of the host ports that the storage system detects. The list does not account for changes that the storage system did not detect. For example, the storage system cannot detect that a cable is disconnected from the port of the host device or that a fabric zoning change occurred. In these cases, the host might not be able to communicate with the storage device anymore. However, the storage device might not detect this condition and still views the host as logged in.
This parameter generates a list report that contains the following three information fields:
  • WWNN
  • WWPN
  • ESSIOport
Note: You cannot use the -unknown parameter with the -portgrp, -volgrp, -login, or host_connection_ID parameters.
-login
(Optional) A list is to be displayed of host port (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 connection, and Remote Mirror and Copy paths and anonymous connections.
  2. You cannot use the -login parameter with the -unknown, -portgrp, -volgrp, or host_connection_ID parameters.
-wwpn wwpn
(Optional) Only the host connect objects for the specified WWPN are displayed.
host_connection_ID ... | -
(Optional) Host connection information for the specified host connection IDs be displayed. This parameter accepts a fully qualified ID (includes manufacture. machine type, serial number/hostconnectID) or a shortened version if the -dev parameter is specified.
Note: You cannot use the host_connection_ID parameter with the -login or -unknown parameters.
The ellipsis (...) indicates that, optionally, you can specify multiple values.
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.
An example of a fully qualified host connection ID: IBM.2107-75FA120/2.
Example of a shortened version host connection ID: 0002

Example 1: Displaying a list of host connections for a storage image and the status information for each host connection in the list, without the -unknown parameter

Note: You can receive different reports when you use the lshostconnect command, one for the -unknown parameter, one for the -login parameter, one for the -l parameter, and one for the -s parameter. The reports that are associated with the -unknown, -login, and -l parameters are provided in this description.
dscli> lshostconnect -dev IBM.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.

The following tables represent the headers that are displayed on the output reports that are associated with the lshostconnect command.

The following table displays four ports, which is possible when you query a storage system model.
Profile portgrp volgrpID atchtopo
ESSIO
port
Speed Desc host
IBM® pSeries - AIX® 0 V100
-
I0111,I0121
I0211,I0221
Unknown
SCSI1 Production01
IBM pSeries - AIX 0 V100
-
All Unknown SCSI2 Production
IBM pSeries - pLinux 0 V100
-
I0111,I0121
I0211,I0221
Unknown
SCSI3 Production01
IBM pSeries - pLinux 0 V100
-
- Unknown SCSI4 Production01

Report field definitions without the -unknown or -login parameter

Name
Host connection/SCSI port nickname.
The name is limited to 32-byte or 16 double-byte characters.
ID
A fully qualified host connection ID: manufacturer.type-serial number/hostconnectID.
The host connection ID component is a unique identifier (0 - FFFE) within the scope of a storage system.
WWPN
The worldwide port name (WWPN) for this host system port.
HostType
The name of the host type.
Unknown is displayed when the information is not available and indicates that the host type was not specified when the host connection was created or modified.
LBS
The logical block size that is used by the designated host system and host system port.
The logical block setting must be compatible with the volume group type that is configured for volume access. The 520 block size is typically used for IBM i host system attachments.
Addrdiscovery
The LUN address discovery method that is used by the designated host system and host system port.
The LUN Discovery method must be compatible with the volume group type that is configured for volume access.
The Poll LUNs method enables access to a maximum of 256 LUNs. The Report LUNs method enables access to a maximum of 64 000 LUNs.
Profile
The name of the host connection behavior profile.
Portgrp
The host port group ID. This ID ties together a group of SCSI host port objects that are accessing a common volume group. If the port group value is set to zero, the host port is not associated with any port group.
VolgrpID
The volume group ID. This ID is a unique identifier within the storage system for the SCSI volume group that the specified SCSI host port is assigned to.
Atchtopo
The atchtopo is an attribute of the I/O port and, under certain conditions, might display a value that is inconsistent with the value reported by the lsioport command. Because this inconsistency cannot be corrected in all cases, the atchtopo attribute always displays as a " - " value. To obtain the I/O port topology, use the lsioport or showioport commands.
ESSIOport
The array of port IDs that 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 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).
Speed
Speed is an attribute of the I/O port and, under certain conditions, might display a value that is inconsistent with the value reported by the lsioport command. Because this inconsistency cannot be corrected in all cases, the speed attribute always displays a value of "Unknown". To query the speed of an I/O port, use the lsioport or showioport commands.
Desc
The description that you defined for the SCSI host port. The description is limited to 256 byte or 128 double-byte characters.
host
The host name that is used in the Storage Management GUI, which is different from the nickname that is displayed in the Name column. If a name is not available, a value of "-" displays.

Example 2: Displaying a list of host connections for a storage image and the status information for each host connection in the list, with the -unknown parameter

dscli> lshostconnect -dev IBM.2107 75FA120 -unknown  

Output

WWNN WWPN ESSIOport
3007ACF30A239900 3007ACF30A2399E0 I0111, I0121, I0211, I0221
3007ACF30A239900 3007ACF30A2399E1 I0121
3007ACF30A239900 3007ACF30A2399E2 I0111, I0121, I0211, I0221
3007ACF30A239900 3007ACF30A2399E3 I0111

Report field definitions with the -unknown parameter

WWNN
The worldwide node name for the designated host system.
WWPN
The worldwide port name for the designated host system port.
ESSIOport
The array of port IDs that 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 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 3: Displaying a list of host connections for a storage image and the status information for each host connection in the list, with the -login parameter

dscli> lshostconnect -dev IBM.2107-75FA120 -login 

Output

WWNN WWPN ESSIOport LoginType Name ID
3007ACF3
0A239900
3007ACF3
0A2399E0
I0111 SCSI MyHostA 1
3007ACF3
0A239900
3007ACF3
0A2399E1
I0111 SCSI MyHostB 1
3007ACF3
0A239900
3007ACF3
0A2399E2
I0221 SCSI - -

Report field definitions with the -login parameter

WWNN
The worldwide node name (WWNN) for this host system.
WWPN
The worldwide port name (WWPN) for this host system port.
ESSIOport
The port ID that 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 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).
LoginType
The type of login such as SCSI.
Name
The name that you assigned to the host. If a name is not assigned, a " - " value is displayed.
ID
A fully qualified host connection ID: manufacturer, machine type, serial number/hostconnectID.
The host connection ID component is a unique identifier (0 - FFFE) within the scope of a storage system.