chhostconnect

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 host connection ID.

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

-lbs   512 | 520

(Optional) Specifies 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 iSeries systems (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) Specifies 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 one separately.
2. For HP-UX operating systems, the number of volumes in the volume group must not exceed seven volumes. This restriction only applies when the -addrdiscovery parameter is set to reportlun and the associated volume group is of type scsimap256.

-profile port_profile_name

(Optional) Specifies 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 one separately.
2. If you do not use the -hosttype parameter, use the lsportprof command to obtain a list of available profiles.

-hosttype host_type

(Optional) Specifies information about the following three parameters:

• -profile
• -addrdiscovery
• -lbs

Notes:

1. You cannot use the -hosttype parameter with the -profile, addrdiscovery, or -lbs parameters.
2. Use the lshosttype command to obtain a list of known host types.

-portgrp port_grp_number

(Optional) Specifies 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 have not been associated with a port group.

-volgrp volume_group_ID | none

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

Examples of -dev parameter use

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

dscli>chhostconnect -dev IBM.1750-68FA120 V11 1

where 1 represents the required parameter, host_connection_ID.

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

dscli>chhostconnect -volgrp IBM.1750-68FA120/V11 IBM.1750-68FA120/1

where IBM.1750-68FA120/1 or IBM.2107-75FA120/1 represents the required parameter, host_connection_ID

A host connection can use only one volume group per storage image. In other words, 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 all|none| . . .

(Optional) Specifies all, none, 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.

all

Specifies that you want to add all I/O port IDs. This allows the specified host connection access to the designated volume group through all the associated I/O port IDs.

none

Specifies that you do not want to add any I/O ports. If you do not specify I/O ports, the storage unit is configured to allow host connection access to the specified volume group using any I/O port that is configured for FC-AL or SCSI-FCP topology.

… (ellipsis)

Specifies that you can 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 using only the designated list of port IDs.

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.1750-68FA120 -ioport I0102 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.1750-68FA120/I0102 IBM.1750-68FA120/1

where IBM.1750-68FA120/1 or 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 is an I/O port enclosure number in the range of 00 - 01 (1750 machine types).
• A is the adapter number and is specified as 0, 1, 2, or 3 (1750 machine types).
• P is the port number (0 - 3).

To specify a range of port IDs, separate the port IDs with a hyphen.

Separate multiple port IDs or ranges of port IDs with a comma between each ID or range of IDs.

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

-desc description

(Optional) Specifies 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) Specifies the user-assigned host system or port name. The name is limited to 32-byte or 16 double-byte characters.

host_connection_ID | -

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

Examples of -dev parameter use

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

dscli>chhostconnect -dev IBM.1750-68FA120  -desc newdescription 1 

where 1 represents the value for the host_connection_ID.

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.1750-68FA120/1

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

Attention: Use caution when you work with connection IDs to ensure that you have specified the correct connection that you want to change. For example, if you intend to make a change to connection ID 0005 and type 000, the system makes the change to connection ID 0. Or, if you want to make a change to connection ID 0020 and type 002, the system makes the change to 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.