mkaliasvol

The mkaliasvol command creates zSeries CKD alias volumes (generally referred to as parallel access volumes or PAVs) in a storage image.

Read syntax diagramSkip visual syntax diagram
>>-mkaliasvol--+-------------------------+---------------------->
               '- -dev--storage_image_ID-'   

>--+-------------------------------------+---------------------->
   '- -base--volume_ID (volume_ID_range)-'   

>--+----------------------------------+--+-----------------+---->
   '- -order--increment--|--decrement-'  '- -qty--quantity-'   

>--+--------+--+-volume_ID-+-----------------------------------><
   '- -wait-'  '-" - "-----'   

Parameters

Note: Volumes are automatically assigned to the FICON/ESCON – ALL volume group ID 10.
-dev storage_image_ID
(Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number.
-base volume_ID (volume_ID_range)
(Required) Specifies an existing base CKD volume ID or a volume ID range.
Note: You cannot use multiple volume IDs separated by commas and multiple ID ranges in combination. This combination is rejected.
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.
The alias volume IDs are assigned consecutively in the order specified by the -order parameter. The following examples show the processing affects of the -order parameter:
dscli>mkaliasvol -base 0000 -order increment -qty 2 0080 creates two alias
volumes 0080 and 0081 for base volume 0000.
dscli>mkaliasvol -base 0000-003F -order increment -qty 2 0080
creates two alias volumes for each base volume as follows:
0080,0081 for base volume 0000
0082,0083 for base volume 0001
...
00FE,00FF for base volume 003F
-order increment | decrement
(Optional) Specifies the order in which alias volume IDs are assigned. For example:
dscli>mkaliasvol -base 0000-003F -order decrement -qty 2 00FF
creates two alias volumes for each base volume as follows:
00FF,00FE for base volume 0000
00FD,00FC for base volume 0001
...
0081,0080 for base volume 003F
Note: If the -order parameter is not specified the default value is decrement.
-qty quantity
(Optional) Specifies the number of alias volumes that will be assigned to each specified CKD base volume.
-wait
(Optional) Delays the command response until the volume configuration processes complete.
volume_ID -
(Required) Identifies the starting alias volume ID in a sequence of volume IDs to be created
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).
If you specify the dash (-), this parameter information is automatically supplied.

Example (1750)

Invoking the mkaliasvol command
dscli> mkaliasvol –dev IBM.1750-68FA120 –base 0100-010F -order
decrement -qty 2 01FF
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 
5.0.0.0 DS: IBM.1750-68FA120
CKD Volume 01FF successfully created. 
CKD Volume 01FE successfully created.
...
CKD Volume 01E1 successfully created. 
CKD Volume 01E0 successfully created.
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.