showhostconnect

The showhostconnect command displays detailed properties of a storage image host connection.

Read syntax diagramSkip visual syntax diagram
>>-showhostconnect--+-------------------------+----------------->
                    '- -dev--storage_image_ID-'   

>--+-host_connection_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 host connection.
host_connection_ID | -
(Required) Specifies a fully qualified host connection ID, which includes the manufacturer, type, and sequence number if the -dev parameter is not used. The host connection ID is a unique identifier (0 - FFFE) within the scope of a storage image.
If you specify the dash (-), this parameter information is automatically supplied.

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

Invoking the showhostconnect command
dscli>showhostconnect -dev IBM.2107–75FA120 
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
Profile Portgrp VolgrpID Achtopo ESSIOport Desc

IBM
pSeries
- AIX

0 100

SCSI
-FCP

I0111,I0121
I0211,I0221

SCSI1

Report field definitions

Name
Specifies the host connection SCSI port nickname.
The name is limited to 32 byte or 16 double-byte characters.
ID
Specifies a fully qualified host connection ID.
The value that is represented by the host_connection_ID parameter is a unique identifier (0 - FFFE) within the scope of a storage unit.
WWPN
Specifies the worldwide port name (WWPN) for the designated host system port.
HostType
Specifies the name of the host type.
"Unknown" is displayed when the information is not available. This 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 this host system and the 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 that is used by this host system and the 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. The 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 the 1750, A is the adapter number 0 - 3 for the 1750, and P is the port number (0 - 3). The number is prefixed with the letter I.
Desc
Specifies the description you defined for the SCSI host port. The description is limited to 256 byte or 128 double-byte characters.
Related reference
setioport
lsioport
showioport
mkhostconnect
chhostconnect
managehostconnect
rmhostconnect
lshostconnect
lshosttype
lsportprof
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.