chckdvol

The chckdvol command modifies the attributes that are associated with a count key data (CKD) base volume.

Read syntax diagramSkip visual syntax diagramchckdvol  -dev   storage_image_ID  -name  new_volume_name   -cap   new_capacity  -captype  cyl  mod1 -datatype 3380 3390 3390-A  -quiet  -perfgrp  performance_group_ID  -resgrp  resource_group_ID  volume_ID   ...   "-"

Parameters

-dev storage_image_ID
(Optional) The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.
-name new_volume_name
(Optional) User specified nickname for this CKD base volume. This nickname should not exceed 16 characters. It can contain one of the following wildcards:
  • (#d) - insert volume_ID (decimal format)
  • (#h) - insert volume_ID (hexadecimal format)
-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.

Notes:
  1. You can specify the data type 3390–A for storage system models only.
  2. You must ensure that the volume data type is compatible with the host systems that access this volume.
  3. You cannot use the -datatype parameter and the -cap parameter in the same command.
-cap new_capacity
(Optional) The quantity of CKD cylinders that you want to allocate to the specified volume. You can also use the -captype parameter to change the unit type of the capacity to mod1 units.
  • 3380 volumes cannot be expanded.
  • For 3390 volumes, the new_capacity value 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, new_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 storage system model and type.
Notes:
  1. Check your operating system documentation to ensure that volume expansion is supported before proceeding with the expansion.
  2. If you expand a 3390 volume to an Extended Addressing Volume (EAV), the data type is changed to 3390-A.
  3. Attempting to reduce the size returns an error and causes the transaction to fail.
  4. You cannot use the -datatype parameter and the -cap parameter in the same command.
-captype cyl | mod1
(Optional) The unit type of the capacity 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. You must specify the -cap parameter to specify the -captype.
-quiet
(Optional) Turns off the CKD volume modification confirmation prompt for this command.
-perfgrp performance_group_ID
(Optional) The performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG, and valid performance groups numbers are 0, and 16-31. 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.
volume_ID ... | -
(Required) An array of one or more CKD base volume IDs or volume ID ranges to modify.
A volume ID range is defined by two volume IDs that are separated by a dash. Multiple volume IDs or volume ID ranges must be separated with a blank space between each ID.
Example: 0100-010F 0180-018F 0120
The volume ID format is four hexadecimal characters LLVV that represent the following values:
LL
The logical control unit number, 00 - FE
VV
The volume number, 00 - FF
You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter.
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.

Example: Modifying CKD base volume attributes

dscli> chckdvol -dev IBM.2107-75FA120  -perfgrp PG18 0100 
Output
CKD volume 0100 successfully modified.