addvolumecopy

Parameters

-poolstorage_pool_id | storage_pool_name

(Required) Specifies the storage pool in which to create the new volume copy.

Remember: For hyperswap topology systems, the site of storage pool must not be the same as the site of the existing volume copy.

-iogrpiogroup_id | iogroup_name

(Optional) Specifies the I/O group that the new volume copy is cached in.

Note: This parameter applies only when you are creating a hyperswap volume and requires that the system topology be hyperswap. The I/O group must be in a different site from the current copy.

The I/O group must be in the same site as the storage pool that is being specified.

-cachenone | readonly | readwrite

(Optional) Specifies the caching options for the volume copy. Valid entries are:

• readwrite enables the cache for the volume *
• readonly disables write caching but allows read caching for a volume
• none disables the cache mode for the volume

Note: This parameter applies only when you are creating a hyperswap volume and requires that the system topology be hyperswap.

-imagemdisk_id | mdisk_name

(Optional) Specifies that the volume copy is to be created in image mode and it specifies which currently unused MDisk to use.

Note: For a hyperswap topology system the MDisk site must match the storage pool site. If the storage pool is empty, the MDisk site must be 1 or 2, and the MDisk site cannot be the same as the site of the existing volume copy.

-thin

(Optional) Specifies that the volume copy is to be created with thin-provisioning. You cannot specify this parameter with -compressed.

Note: If you do not specify either -thin or -compressed the volume copy is created as one that is fully allocated.

-compressed

(Optional) Specifies that the volume copy is to be created compressed. You cannot specify this parameter with -thin.

-buffersizebuffer_size | buffer_percentage%

(Optional) Specifies the pool capacity the volume attempts to reserve as a buffer for thin-provisioned and compressed volumes. You must specify either -thin or -compressed with this parameter.

-warningwarning_capacity | warning_percentage%

(Optional) Specifies a threshold at which a warning error log is generated for the volume copy. A warning is generated when the used disk capacity on the thin-provisioned or compressed copy exceeds the specified threshold. You can specify the threshold by using warning_capacity to specify a size, which defaults to MB unless the -unit parameter is specified.

Note: You can also specify a warning_percentage%, to use a percentage of the volume size. If you do not specify a warning threshold, a default value of 80% is used. To disable warnings, specify 0.

You must specify either -thin or -compressed with this parameter.

-unitb | kb | mb | gb | tb | pb

(Optional) Specifies the data units for the -buffersize and -warning parameters.

-import

(Optional) Imports an image mode disk that contains a thin-provisioned volume into the clustered system (system). Requires that the -rsize and -vtypeimage parameters also be specified.

-noautoexpand

(Optional) Specifies that the volume copy not automatically expand as it is written to; the available buffer capacity decreases as the used capacity increases. The copy goes offline if the buffer capacity is consumed.

The buffer capacity can be increased by specifying expandvdisksize -rsize. You must specify either -thin or -compressed with this parameter. If you do not specify this keyword the copy automatically expands as it is written to.

-grainsize32 | 64 | 128 | 256

(Optional) Sets the grain size (KB) for a thin-provisioned volume. If you are using the thin-provisioned volume in a FlashCopy map, use the same grain size as the map grain size for best performance. If you are using the thin-provisioned volume directly with a host system, use a small grain size. The grain size value must be 32, 64, 128, or 256 KB. The default is 256 KB.

volume_id | volume_name

(Required) Specifies the volume to add the volume copy to.