chcluster

Parameters

-dev storage_image_ID

(Optional) Specifies 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. It is also required if you did 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.

-safe

(Optional) Enables checks for the safe removal of one or more specified volumes from the host.

-action

(Optional) Specifies the type of action for the specified volumes.

map

Specifies that the volumes are added to the cluster.

unmap

Specifies that the volumes are removed from the cluster.

Note: The chcluster command fails if you specify the -volume parameter without the -action parameter.

-volume volume_ID [ ... ]

(Optional) Specifies an array of one or more volume IDs or volume ID ranges to be added or removed from the specified host. A volume ID range is defined by two volume IDs that are separated by a hyphen. Multiple volume IDs or volume ID ranges must be separated by a comma. The volume IDs are entered as hexadecimal numbers in the range 0x0000-0xFEFF. Example: 0100-010F, 0180-018F,0120.

Notes:

1. For SCSI MAP 256, the array or ranges cannot exceed 256 volume ID entries. Otherwise, up to 64,384 entries are allowed.
2. The chcluster command fails if you specify the -volume parameter without the -action parameter.

-lun lun_ID

(Optional) Specifies the LUN ID in hexadecimal value (00 - FF) that is mapped to the specified volume ID for a SCSI-MAP256 type cluster. If you specify multiple volume IDs with the -volume parameter, LUN IDs are assigned consecutively in incremental order.

Note: This parameter is only valid for a SCSI-MAP 256 type cluster. If this parameter is specified for any other type of cluster, the command fails.

-name new_cluster_name

(Optional) Specifies the new name you assign to the cluster system. The name is limited to 32-byte or 16-double byte characters. If you assign a new cluster name with a blank space, enclose the name with double quotation marks.

cluster_name | -

(Required) Specifies the cluster name to be modified. If the cluster name you specify includes a blank space, enclose the name with double quotation marks.

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.