chvolgrp

Parameters

-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 fully qualified IDs or do not set the devid variable in your profile or through the setenv command. The storage image ID is also required if the HMC is aware of more than one storage image. The -dev parameter temporarily overrides any defined value for devid for the current command.

Example: IBM.2107-75FA120

-name new_Volume_Group_name

(Optional). A new name for the volume group. The name is limited to 16 characters. The name must be unique across volume groups that are contained by a storage unit.

-safe

(Optional). Enables checks for the safe removal of the volume from the volume group.

-action add | remove | replace

(Optional, unless the -volume parameter is specified). Specify one of the following values with this parameter:

add

The volumes be added to the volume group.

remove

The volumes be removed from the volume group.

replace

The existing volumes be replaced by the specified volumes.

Note: The chvolgrp command fails if you specify the -volume parameter and not included the -action parameter.

-safe

(Optional). Valid for the remove and replace actions, only. Enables checks for the safe removal or replacement of the volume from the volume group. The checked conditions that give a failed result include: an open host reservation, a Copy Services relationship, or an I/O received within the last 5 minutes.

-volume volume_ID ...

(Optional unless you are specifying the -action or the -lun parameter, then the -volume parameter is required.) An array of one or more volume IDs or volume ID ranges to be included in the volume group when the -action parameter is specified.

The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ where:

X

The address group, 0–F.

XY

The logical subsystem number, 00 - FE.

ZZ

The volume number, 00 - FF.

To specify a range of volume IDs, separate the volume IDs with a dash (-).

You must separate multiple volume IDs or ranges of volume IDs with a comma between each ID or range of IDs.

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 chvolgrp command fails if you specify the -volume parameter and do not specify the -action parameter.

Example: 0100-010F,0180-018F,0120

-lun lun_ID

(Optional - SCSI MAP 256 only). The LUN ID in hexadecimal value (00 - FF), which is mapped to the specified volume ID when the -action add or -action replace parameter is specified. If multiple volume IDs are specified by the -volume parameter, the LUN ID is consecutively assigned in incremental order. If the specified LUN ID is not valid, the command is rejected.

Note: This parameter is only valid when the target volume group type is SCSI MAP 256. Otherwise, this command fails.

If the -action add parameter is specified and the specified LUN ID is already mapped to the other volume in the specified volume group, the command fails.

If the -action add parameter is specified without the -lun parameter, an unused LUN ID is assigned to the volume ID. In this case, the unused LUN ID is selected from a smaller number.

The following example shows how this process works:

A volume group of "SCSI Map 256" type has Volume 0000 and 0001. 
Their LUNs are the members of the following volume group: 
(showvolgrp displays the current mapping.)
0000 : 10
0001 : 11
Because the range of LUN IDs is 00-FF, the unused LUN IDs 
are 00,01,...,0F,12,13,...,FF.

If you add volume 0002 and 0003 to this volume group without 
the -lun parameter, the mapping results in the following 
because 00 and 01 are "smaller" unused LUN IDs:
0002 : 00
0003 : 01
0000 : 10
0001 : 11

If the -action replace parameter is specified without specifying the -lun parameter, lun_ID=00 is assumed.

Volume_Group_ID | –

(Required). The ID of the volume group that being changed. The volume group ID is made up of the storage image ID followed by the volume group ID. This parameter also 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.

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.