mkhostconnect

Parameters

Open-systems host port attachments to Fibre Channel ports are configured for identified access mode and SCSI protocol.

-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 WWPN, 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.

-wwpn wwpn

(Required) The worldwide port name (WWPN). The WWPN is a 16-character hexadecimal ID or a colon-separated string. The names are host attachment specific, for example, 12341234000A000F or 12:34:12:34:00:0A:00:0F.

Note: Do not create more than one host connection per WWPN, except for SUN hosts. Creating more than one host connection per WWPN (each with a different volume group) is only supported for SUN.

-lbs 512 | 520

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

Notes:

1. Do not use the -lbs parameter if you specify the -hosttype parameter.
2. If you do not use the -hosttype parameter, use the lsportprof command to determine the block size that you need to specify.

-addrdiscovery reportlun | lunpolling

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

• The reportlun method specifies that the host system can access up to 64 000 LUNs.
  Note: Use the reportlun method only with volume groups that are designated as mask type. (This designation is assigned when you use the mkvolgrp command to create the volume group.) However, you can use the reportlun method for a map type, but more considerations exist if you are using an HP-UX operating system.

  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.

• The lunpolling method specifies that the host system can access up to 256 LUNs. For Sun, Linux®, and Windows operating systems, the lunpolling method is typically selected.

Notes:

1. Use the lunpolling method only with volume groups that are designated as map type. (This designation is assigned when you use the mkvolgrp command to create the volume group.)
2. Do not use the -addrdiscovery parameter if you specify the -hosttype parameter.

-profile port_profile_name

(Optional. If you specify the -hosttype parameter, this parameter is not used.) 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 - AIX®”.

Notes:

1. Do not use the -profile parameter if you specify the -hosttype parameter.
2. If you do not use the -hosttype parameter, use the lsportprof command to obtain a list of available profiles.

-hosttype host_type

(Optional) Information about the following three parameters:

• -profile
• -addrdiscovery
• -lbs

Notes:

1. When the -hosttype parameter is specified, do not use the -profile, -addrdiscovery, or -lbs parameters.
2. Use the lshosttype command to obtain a list of known host types.

-portgrp port_grp_number

(Optional) The identifier 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

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

A host connection uses only one volume group per storage image; that is, a single WWPN can access only one volume group per storage image.

Note: If you do not specify a volume group when a host connection is created, the value for volume group is displayed as a "-" when you enter a lshostconnect or showhostconnect command.

-ioport port_ID port_ID_list |all|none

(Optional) All, none, one, or more I/O port IDs that allow host connection access to volumes. I/O ports cannot share WWPN. Ensure that no conflicts exist with the I/O ports of existing SCSI host connections.

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.

Note: To specify a range of port IDs, separate the port IDs with a hyphen. You must separate multiple port IDs or ranges of port IDs with a comma between each ID or range of IDs.

all

Add all I/O port IDs to allow 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. You can use any I/O port that is configured for SCSI-FCP topology. A port ID is 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).

This number is prefixed with the letter I.

-desc description

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

-host host_name

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

Note:

• If the host name includes a blank space, enclose the name with double quotation marks.
• You cannot use the -host_name parameter with the -lbs, -addrdiscovery, -profile, -hosttype, -portgrp, -volgrp, or -ioport parameters.

host_connection_name | -

(Required) The name that you assigned to the host port. The name you assign is limited to 32 byte or 16 double byte characters.

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.