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 new host connection using the mkhostconnect command.


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

>--+----------------------------+------------------------------->
   '- -portgrp--port_grp_number-'   

>--+---------------------------+--+-----------+--+---------+---->
   '- -volgrp--volume_group_ID-'  '- -unknown-'  '- -login-'   

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

Parameters

-dev storage_image_ID

(Optional) Displays the host connections for the specified storage image. A storage image ID consists of manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified host connection ID and you do not specify a value for the devid variable in your profile file.

Example of a fully qualified storage image ID: IBM.1750-68FA120

-s

(Optional) Specifies the host connection IDs. You cannot use the -l and -s parameters together.

-l

(Optional) Specifies the default output and your description for each host connection in the list. You cannot use the -l and -s parameters together.

-portgrp port_grp_number

(Optional) Specifies 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) Specifies that only the host connections with the specified volume group ID 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) Specifies that a list of logged in host ports (WWPNs), that are not recognized as being associated with the designated storage unit, be displayed. 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) Specifies that a list 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:

Known logins are those that you have created a host connection for, as well as Remote Mirror and Copy paths and anonymous connections.
You cannot use the -login parameter with the -unknown, -portgrp, -volgrp, or host_connection_ID parameters.

host_connection_ID . . . | -

(Optional) Specifies that 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.

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

Example of a fully qualified host connection ID: IBM.1750-68FA120/2

Example of a shortened version host connection ID: 0002

Example

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.

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 lshostconnect command. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the lshostconnect command without the -unknown parameter

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

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107–75FA120

Name	ID	WWPN	HostType	LBS	Addrdis covery
My host port 1	IBM.2107- 75FA120/1	3007ACF3 0A2399E0	Unknown	512	reportLUN
My host port 2	IBM.2107- 75FA120/2	3007ACF3 0A2399E1	Unknown	512	reportLUN

Profile	portgrp	volgrpID	achtopo	ESSIOport	Desc
IBM pSeries - AIX	0	V100	SCSI -FCP	I0111,I0121 I0211,I0221	SCSI1
IBM pSeries - AIX	0	V100	SCSI -FCP	All	SCSI2

Example of lshostconnect using the -unknown parameter

Invoking the lshostconnect command with the -unknown parameter

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

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107–75FA120

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

Example of lshostconnect using the -login parameter

Invoking the lshostconnect command with the -login parameter

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

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107–75FA120

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 when the -unknown or -login parameter is not used

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

WWPN

Specifies the worldwide port name (WWPN) for this host system port.

HostType

Specifies 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

Specifies 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 iSeries host system attachments.

Addrdiscovery

Specifies the LUN address discovery method 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

Specifies the name of the host connection behavior profile.

Portgrp

Specifies 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

Specifies the volume group ID. This ID is a unique identifier within the DS6000 for the SCSI volume group that the specified SCSI host port is assigned to.

Achtopo

Specifies the topology of the attached unit. This value is used to select which storage facility I/O ports are compatible with the attachment to the specified storage unit. One of the following values is displayed:

Unknown
SCSI-FCP
FC-AL

ESSIOport

Specifies the array of port IDs that the designated host port is logged into.

The port ID component is four hexadecimal characters in the format EEAP, where EE is a port enclosure number 00 - 01 for 1750, A is the adapter number 0 - 3 for 1750, and P is the port number (0 - 3). The number is prefixed with the letter I.

Desc

Specifies the description that you defined for the SCSI host port. The description is limited to 256 byte or 128 double-byte characters.

Report field definitions when the -unknown parameter is used

WWNN: Specifies the worldwide node name for the designated host system.
WWPN: Specifies the worldwide port name for the designated host system port.
ESSIOport: Specifies the array of port IDs that the designated host port is logged into.; The port ID component is four hexadecimal characters in the format EEAP, where EE is a port enclosure number 00 - 01 for 1750, A is the adapter number 0 - 3 for 1750, and P is the port number (0 - 3). The number is prefixed with the letter I.

Report field definitions when the -login parameter is used

WWNN: Specifies the worldwide node name (WWNN) for this host system.
WWPN: Specifies the worldwide port name (WWPN) for this host system port.
ESSIOport: Specifies the port ID that the designated host port is logged into.; The port ID component is four hexadecimal characters in the format EEAP, where EE is a port enclosure number 00 - 01 for 1750, A is the adapter number 0 - 3 for 1750, and P is the port number (0 - 3). The number is prefixed with the letter I.
LoginType: Specifies the type of login such as SCSI.
Name: Specifies the name that you assigned to the host. If a name is not assigned, a null (-) 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 unit.