initckdvol

The initckdvol command initializes a logical volume and releases extents from a space-efficient logical volume.

For space efficient logical volumes, this command is used to release space. For TSE volumes, it releases tracks in the repository, reducing the repository allocated space. For ESE volumes, it releases extents in the extent pool being used, reducing the allocated extents.

For example, if a space-efficient logical volume has data that is stored on it that is no longer needed, use the initfbvol command to free the extents/tracks that were assigned to this logical volume. This allows the extents/tracks to be reused by other space-efficient logical volumes.

For example, if a space-efficient logical volume is used as a FlashCopy target volume and the data that is stored on these tracks are no longer needed, use the initckdvol command to free the extents that were assigned to this logical volume. This allows the extents to be reused by other space-efficient logical volumes.

Parameters

-dev storage_image_ID

(Optional) The storage image ID, which consists of a value for 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.

-action releasespace

(Optional) Specifies that you want the system to release the repository space held by the designated space-efficient volume back to the repository. (The repository is the physical extents that provision the virtual extents for virtual space volumes.)

-quiet

(Optional) Turns off the confirmation prompt for the -action parameter.

-force

(Optional) Forces the action.

Note: For release 8.3 or later, if -force is not specified, the request fails when the volume is in a path group or in any kind of Copy Services relationship.

volume_ID ... | -

(Required) 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.

To specify a range of volume IDs, separate the volume IDs with a dash.

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

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

Example: Releasing extents from a space-efficient logical volume

dscli> initckdvol -dev IBM.2107-75FA120 -action releasespace 0101

Output

CMUC00338W initckdvol: Are you sure that you want to submit the command 
releasespace for the CKD volume 0101?[Y/N]:y 
CMUC00341I initckdvol:: 0101: The command releasespace has 
completed successfully.