mkckdvol

The mkckdvol command creates zSeries count key data (CKD) base or CKD alias volumes in a storage image.

Read syntax diagramSkip visual syntax diagram
>>-mkckdvol--+-------------------------+--+--------------------------+-->
             '- -dev--storage_image_ID-'  '- -extpool--extentpool_ID-'   

>--+-------------------+--+--------+--+-----------------+------->
   '- -base--volume_ID-'  '- -3380-'  '- -cap--capacity-'   

>--+---------------------+--+--------+-------------------------->
   '- -name--volume_name-'  '- -wait-'   

>--+-volume_ID--+-------+-+------------------------------------><
   |            '-. . .-' |   
   '-" - "----------------'   

Parameters

-dev storage_image_ID
(Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number.
-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 zeroes, prefixed with the letter P.
Note: This parameter is not required and ignored if the -base parameter is specified.
-base volume_ID
(Optional) Specifies an existing base CKD volume ID. The volume ID format is four hexadecimal characters LLVV, where LL is a logical control unit number 00 - 1F (1750 only), and VV is a 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: It is recommended that you use the -mkaliasvol command to create alias volumes.
-3380
(Optional) Specifies the 3380 volume type setting. Otherwise, the 3390 volume type is created. The -3380 parameter is ignored when the -base parameter is specified.
Note: You must ensure that the volume data type is compatible with the host systems that access this volume.
-cap capacity
(Optional) Specifies the quantity of CKD cylinders that are allocated to this volume. The -cap parameter is ignored when the -base parameter is specified.
For a 3380 specification, the -cap parameter value is 2226 (1.59 GB) or 3339 (2.37 GB).
For 3390 volumes (default type), the -cap parameter can be a value in the range of 1 to 65 520 (849KB to 55.68 GB).
Note: This parameter is not required, and it is ignored if the -base parameter is specified.
-name volume_name
(Optional) Specifies 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 wild cards:
  • (#d) insert volume ID (decimal)
  • (#h) insert volume ID (hexadecimal)
Note: The -name parameter is ignored when the -base parameter is specified.
-wait
(Optional) Specifies that the command response be delayed until the volume configuration processes complete.
volume_ID . . . | -
(Required) Specifies 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 hexadecimal LLVV where LL is a logical control unit number 00 - 1F (1750 only), and VV is a 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
If you specify the dash (-), this parameter information is automatically supplied.

Example (1750)

Invoking the mkckdvol command
dscli>mkckdvol -dev IBM.1750-68FA120 
-extpool P1 -name my_volume_#d	-cap 3339 0100 0101 0102 0103
The resulting output
Sun Aug 11 02:23:49 PST 2004 IBM DS IBM.1750-68FA120  

CKD volume 0100 successfully created.
CKD volume 0101 successfully created.
CKD volume 0102 successfully created.
CKD volume 0103 successfully created.
Related tasks
Configuring new count key data storage
Related reference
lsaddressgrp
mklcu
chlcu
rmlcu
lslcu
showlcu
chckdvol
rmckdvol
lsckdvol
showckdvol
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.