chvolgrp

Parameters

-dev storage_image_ID

(Optional). Specifies the storage image ID, which consists of manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the volume group ID.

Example: IBM.1750-68FA120

-name new_Volume_Group_name

(Optional). Specifies 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.

-action add | remove | replace

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

add

Specifies that the volumes be added to the volume group.

remove

Specifies that the volumes be removed from the volume group.

replace

Specifies that the existing volumes be replaced by the specified volumes.

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

-volume volume_ID . . .

(Optional unless you are specifying the -action or the -lun parameter, then the -volume parameter is required.) Specifies 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 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E (for 1750) , and ZZ is 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). Specifies 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 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). Specifies the ID of the volume group 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 zeroes, prefixed with the letter V.

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

Example: IBM.1750-68FA1243/V1231