mkckdvol

Parameters

-dev storage_image_ID

(Optional) The storage image ID, which includes manufacturer, machine type, and serial number. The -dev parameter temporarily overrides any defined value for devid for the current command.The storage image ID is required for the following situations:

• If you do not specify a fully qualified extent pool ID
• If you do not set the devid variable in your profile or through the setenv command
• If the HMC is aware of more than one storage image

-extpool extentpool_ID

(Optional) Creates the base or alias volumes from data extents that are contained in this extent pool. The extent pool storage type defines the volume storage type. An extent pool ID is a four-digit decimal number with no leading zeros, prefixed with the letter P.

Note: This parameter is ignored if the -base parameter is specified.

-base volume_ID

(Optional) An existing base CKD volume ID. The volume ID format is four hexadecimal characters LLVV, that represents the following values:

LL

The logical control unit number, 00 - FE

VV

The volume number, 00 - FF

Use the -base parameter to create one or more CKD alias volumes that are assigned to the specified base CKD volume ID. The LCU ID component for all volume IDs must be identical.

Note: Ensure that you use the mkaliasvol command rather than mkckdvol command to create alias volumes.

-datatype 3380|3390|3390-A

(Optional) The volume data type.

For Extended Addressing Volumes (EAV), which have a capacity greater than 65520 cylinders, the data type 3390-A must be specified. You can also specify the data type 3390-A for volumes smaller than 65520 cylinders.

If the -datatype or the -3380 parameters are not specified, then the default data type is 3390-A for capacities greater than 65520 cylinders, and 3390 for smaller capacities.

Notes:

1. You can specify the data type 3390–A for DS8000® storage system models only.
2. You must ensure that the volume data type is compatible with the host systems that access this volume.
3. The -datatype parameter is ignored when the -base parameter is specified.
4. You cannot use the -datatype parameter and the -3380 parameter in the same command.

-cap capacity

(Optional) The quantity of CKD cylinders that are allocated to this volume. The capacity can also be specified in mod1 units by using the -captype parameter.

• For 3380 volumes, the capacity value can be 2226 (1.59 GiB) or 3339 (2.37 GiB).
• For 3390 volumes, capacity can be specified in increments of 1 in the range 1 - 65520 (849KiB to 55.68 GiB).
• For 3390–A volumes, for values less than 65520 cylinders, capacity is specified in increments of 1. Capacities greater than 65520 cylinders are specified in increments of 1113. The maximum volume size varies and depends on the DS8000 model and type.

Note: This parameter is ignored if the -base parameter is specified, and this parameter is required if the -base parameter is not specified.

-captype cyl | mod1

(Optional) The unit type of the capacity that is given by using the -cap parameter. The default is cyl. A mod1 unit is equivalent to 1113 cylinders, and 1263.28 cylinders is equivalent to 1 GiB.

-name volume_name

(Optional) Your nickname for the CKD base volumes that are created by this command. Your volume name cannot exceed 16 characters. It can contain one of the following wildcards:

• (#d) insert volume ID (decimal)
• (#h) insert volume ID (hexadecimal)

Note: The -name parameter is ignored when the -base parameter is specified.

-wait

(Optional) The command response is delayed until the volume configuration processes complete.

-sam standard | tse | ese

(Optional) The storage allocation method as follows:

standard

Designates that the system fully allocates the volume with real extents at volume creation time. This value is the default.

tse

Designates that a track space-efficient logical volume contains a set of virtual extents that are associated with the space-efficient storage in the same extent pool. The physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage.

Note: Track space-efficient (TSE) repositories are required to create TSE volumes. However, starting with DS8000 Release 8, TSE repositories can no longer be created.

ese

Designates that an extent space efficient (ESE) logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool. ESE volumes are used for thin provisioning.

-eam rotatevols | rotateexts

(Optional) The extent allocation method as follows:

rotateexts

Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default.

rotatevols

Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on.

-perfgrp performance_group_ID

(Optional) The performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG. The default is PG0.

-resgrp resource_group_ID

(Optional) The resource group that the volumes are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. The default is RG0.

volume_ID ... | -

(Required) An array of one or more CKD base or alias volume IDs or volume ID ranges to be created. The volume IDs must share a common logical control unit ID.

Note: Volumes are automatically assigned to the FICON/ESCON – ALL volume group ID 10.

The volume ID format is four hexadecimal characters LLVV, that represents the following values:

LL

The logical control unit number, 00 - FE

VV

The volume number, 00 - FF

A volume ID range is defined by two volume IDs that are separated by a dash.

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

Note: Multiple volumes can be created with a single request, but all volumes must have the same capacity, extent pool, and data type.

Example: 0100-010F 0180-018F 0120

The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) if you are in the DS CLI interactive mode.