mkhostconnect

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which includes the manufacturer, type, and serial number.

-wwname wwpn

(Required) Specifies the worldwide port name (WWPN). The WWPN is a 16-character hexadecimal ID. The names are host attachment specific; for example, 12341234000A000F.

 -lbs 512 | 520

(Optional) Specifies 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^® iSeries™ systems (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) Specifies 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 there are additional considerations 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 only applies 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.) 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 – 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) Specifies 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) Specifies the identifier 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

(Optional) Specifies 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 zeroes, 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 null (-) when you issue a lshostconnect or showhostconnect command.

-ioport port_ID . . .

(Optional) Specifies all, none, one, or more I/O port IDs that allow host connection access to volumes.

Enter all to specify that you want all I/O ports added.

Enter none to specify that you do not want to add I/O ports. If you do not specify I/O ports, the image 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.

I/O ports cannot share the same WWPN. Ensure that there are no conflicts with the I/O ports of existing SCSI host connections.

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

A port ID is 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).

This number is prefixed with the letter I.

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.

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

host_name | -

(Required) Specifies your host system or port name, limited to 16 characters.

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