chhostconnect

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 connection ID. It is also required if you 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 includes IBM.2107-75FA120.

-lbs 512 | 520

(Optional) The logical block size that is used by the host system. The block size must be compatible with the volume group type and the volume type configurations that apply to the host port connection. The 520 logical block size is typically used by the IBM System i models (OS/400).

Notes:

1. You cannot use the -lbs parameter and -hosttype parameter together, but you can use each one separately.
2. If you do not use the -hosttype parameter, use the lsportprof command to determine the block size that you need to specify for the -lbs parameter.

-addrdiscovery reportlun | lunpolling

(Optional) The method for identifying logical unit number (LUN) addresses.

• The reportlun method specifies that the host system can access up to 64 000 LUNs.
• The lunpolling method specifies that the host system can access up to 256 LUNs.

Notes:

1. You cannot use the -addrdiscovery parameter and -hosttype parameter together, but you can use each one separately.
2. For HP-UX operating systems, the number of volumes in the volume group must not exceed seven volumes. This restriction applies only when the -addrdiscovery parameter is set to reportlun and the associated volume group is of type scsimap256.

-profile port_profile_name

(Optional) The name of the host connection behavior profile. If the name includes a blank space, enclose the name with double quotation marks. For example, -profile “IBM pSeries - Sun”.

Notes:

1. You cannot use the -profile parameter and the -hosttype parameter together, but you can use each one separately.
2. If you do not use the -hosttype parameter, use the lsportprof command to obtain a list of available profiles.

-portgrp port_grp_number

(Optional) A user-assigned number that associates two or more host ports with access to a common volume group. Port group zero is reserved for ports that are not associated with a port group.

-volgrp volume_group_ID | none

(Optional) An available volume group or no volume group if the none subparameter is used. This command accepts a fully qualified volume group ID including the storage image ID or a shortened version if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter V.

A host connection can use only one volume group per storage image. (A single WWPN can access only one volume group per storage image.) Host operations cannot be initiated until a volume group ID is assigned.

If none is specified, the volume group ID assignment is removed from a SCSI host port object.

-ioport port_ID port_ID_list |all|none

(Optional) All, none, or, one or more I/O port IDs that allow host connection access to volumes. This command accepts a fully qualified port ID including the storage image ID or a shortened version if the -dev parameter is specified.

port_ID port_ID_list

Designate up to 128 ports for an open systems host attachment assignment. If you enter a list of I/O port IDs, access from the specified host connection to the specified volume group is allowed by using only the designated list of port IDs.

To specify a range of port IDs, separate the port IDs with a hyphen. You can list one or more port IDs or ranges of port IDs separated by commas with no spaces.

all

Add all I/O port IDs. This setting allows the specified host connection access to the designated volume group through all the associated I/O port IDs.

none

Do not add any I/O ports. If you do not specify I/O ports, the storage system is configured to allow host connection access to the specified volume group. The access is made by using any I/O port that is configured for SCSI-FCP topology.

Examples of -dev parameter use

If you specify the -dev parameter, you can use the shortened version of the -ioport parameter as follows:

dscli> chhostconnect -dev IBM.2107-75FA120 -ioport I0222 1

Where 1 represents the required parameter, host_connection_ID.

If you do not specify the -dev parameter and you specify the -ioport parameter, you must use the fully qualified version of the port ID with the -ioport parameter specified as follows:

dscli> chhostconnect -ioport IBM.2107-75FA120/I0222
 IBM.2107-75FA120/1

Where IBM.2107-75FA120/1 represents the required parameter, host_connection_ID.

A port ID is prefixed with the letter I and consists of four hexadecimal characters in the format EEAP, where:

EE

The 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).

Note: Changing the I/O port values can result in a disruption of current logins by the host systems.

-desc new_description

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

-name new_host_name

(Optional) The name that you assigned for host system or port. The name is limited to 32 characters.

-quiet

(Optional) Turns off the confirmation prompt for this command.

-host host_name

(Optional) The name of the host to which the host connection is assigned.

host_connection_ID | -

(Required) The host connection ID, which is a unique identifier that uses any number from 0 - FFFE within the scope of a storage image. This parameter accepts a fully qualified ID or a shortened version if the -dev parameter is specified.

If you do not specify the -dev parameter and you specify the host_connection_ID parameter, you must use the fully qualified version of the host connection ID as follows:

dscli> chhostconnect -desc newdescription IBM.2107-75FA120/1

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.

Attention: Use caution when you work with connection IDs to ensure that you specified the correct connection that you want to change. For example, if you intend to change connection ID 0005 and type 000, the system changes connection ID 0. Or, if you want to change connection ID 0020 and type 002, the system changes connection ID 2. The system does not recognize the leading zeros, and 000 is interpreted as connection ID 0 and 002 is interpreted as connection ID 2.