mkckdvol
The mkckdvol command creates IBM® Z count key data (CKD) base or CKD alias volumes in a storage image.
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
- -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:- You can specify the data type 3390–A for DS8000® storage system models only.
- You must ensure that the volume data type is compatible with the host systems that access this volume.
- The -datatype parameter is ignored when the -base parameter is specified.
- 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.
- -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.
Example: Creating CKD base volumes
dscli> mkckdvol -dev IBM.2107-75FA120
-extpool P1 -name my_volume_#d -cap 3339
-perfgrp PG17 -sam ese 0100 0101 0102 0103
Output
CKD volume 0100 successfully created.
CKD volume 0101 successfully created.
CKD volume 0102 successfully created.
CKD volume 0103 successfully created.