mkvolumehostclustermap

Edit online

Use the mkvolumehostclustermap command to generate a new mapping between a volume and a host cluster on a clustered system. This volume is then accessible for input or output (I/O) operations to the specified host cluster.

Syntax

Parameters

-scsi scsi_num_arg: (Optional) Specifies the Small Computer System Interface (SCSI) logical unit number (LUN) ID to assign to a volume on the specified host cluster. The SCSI LUN ID is assigned to the volume on the host cluster for all I/O groups that provide access to the volume.
Note: You must use the next available SCSI LUN ID for each host in the host cluster.

The -scsi parameter is not supported for NVMe hosts. When a volume is mapped to a host that uses the NVMe protocol, the volume namespace ID (NSID) is assigned by the system. This parameter is mutually exclusive with -allowmismatchedscsiids. This parameter cannot be used with the -scsi parameter and is not supported for NVMe hosts.
-allowmismatchedscsiids: (Optional) When you create a new host cluster mapping, this parameter allows the system to allocate non-identical SCSI LUN IDs in the access I/O groups for the volume. This parameter is mutually exclusive with -scsi.
-force: (Optional) Forces a new mapping. Specify this parameter to map a volume to a host cluster and that volume is already mapped to at least one host in a different host cluster.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of IBM® support personnel.
-hostcluster hostcluster_id | hostcluster_name: (Required) Specifies the host cluster (by ID or name) to map to the volume. The value for the ID must be a number and the value for the name must be an alphanumeric string.
volume_id | volume_name: (Optional) Specifies the volume by ID or name. The value for the ID must be a number and the value for the name must be an alphanumeric string.

Description

This command generates a new mapping between a volume and a host cluster on a system. This volume is then accessible for input or output (I/O) operations to the specified host cluster. The protocol of the host cluster must be compatible with that of the volume.

If you do not specify a SCSI LUN ID, the system attempts to assign the lowest common SCSI LUN ID in all access I/O groups. The returned ID is the same for all I/O groups to which the volume is mapped. If an identical SCSI LUN ID is not available in all of the access I/O groups, the command fails.

Use the -allowmismatchedscsiids parameter to allow the system to allocate non-identical SCSI LUN IDs in the access I/O groups. The lowest value available in each access I/O group is used. It might not be the same in all access I/O groups. Make sure that the host supports this configuration. This parameter cannot be used with the -scsi parameter and is not supported for NVMe hosts. If a volume is mapped to a host that uses the NVMe protocol, the volume namespace ID (NSID) is assigned by the system.

An invocation example that maps volume `0` to host cluster `0`

 mkvolumehostclustermap -hostcluster 0 0

The detailed resulting output:

No feedback

An invocation example that maps volume `myvolume1` to host cluster `myhostcluster` and specifies SCSI LUN ID `7`

mkvolumehostclustermap -hostcluster myhostcluster -scsi 7 myvolume1