mkimagevolume

Parameters

-name name

(Optional) Specifies the name that is used for the volume that is created. This value must be an alphanumeric string 1 - 63 characters.

Remember: If you do not specify -name, a unique default name such as volume1 is used.

-size disk_size

(Required if -thin or -compressed is specified) Specifies the capacity of the volume, which is used with the value of the unit. The default capacity is in MB. When the unit of bytes is used, all capacities must be in multiples of 512 bytes. An entire extent is reserved even if it is only partially used.

Remember: This parameter is optional if -thin or -compressed are not specified. If this parameter is not specified, the volume is standard-provisioned.

For thin and compressed volumes, the real capacity is set from the MDisk size.

-unit b | kb | mb | gb | tb | pb

(Optional) Specifies the data units to use with the capacity that is specified by the -size parameter. The default unit type is mb.

-thin

(Optional) Specifies that the volume is to be created with thin provisioning. You cannot specify this parameter with -compressed. If you do not specify -thin or -compressed, the volume that is created is standard-provisioned.

-compressed

(Optional) Specifies that the volume is to be created compressed. If the -iogrp parameter is not specified, the least used I/O group is used for compressed copies (considering the subset of I/O groups that support compression).

Remember: This command fails if no I/O groups support compression.

You cannot specify this parameter with -thin. If you do not specify -thin or -compressed, the volume that is created is standard-provisioned.

-iogrp iogroup_id | iogroup_name

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

-mdisk mdisk_idmdisk_name

(Required) Specifies which currently unused MDisk to use to create the image mode volume.

-pool storage_pool_id | storage_pool_name

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

-cache none | readonly | readwrite

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

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

-warning warning_capacity | warning_percentage

(Optional) Specifies a threshold at which a warning error log is generated for volume copies. A warning is generated when the used disk capacity on the thin-provisioned volume exceeds the specified threshold. You must specify either -thin or -compressed with this parameter. The default value is 80%.

-udid udid

(Optional) Specifies the unit number udid for the disk. The udid is an identifier that is required to support OpenVMS hosts; no other systems use this parameter. Valid options are a decimal number from 0 through 32767, or a hexadecimal number from 0 through 0x7FFF. A hexadecimal number must be preceded by 0x (for example, 0x1234).

-volumegroup volumegroup_name | volumegroup_id

(Optional) Specifies the volume group that the volume should be added to.

Note: This command is not permitted for a volume group with a replication policy.