mkvolgrp

The mkvolgrp command creates a volume group in a storage image.

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

>--+-----------------------+--+------------------------+-------->
   '- -hosttype--host_type-'  '- -type--+-scsimask---+-'   
                                        +-scsimap256-+     
                                        '-os400mask--'     

>--+----------------------------+--+---------------+------------>
   '- -volume--volume_ID--. . .-'  '- -lun--lun_ID-'   

>--+-Volume_Group_Name-+---------------------------------------><
   '-" - "-------------'   

Parameters

Notes:
  1. It is highly recommended that you use the -hosttype parameter when you issue this command.
  2. When you create DS6000 volume groups for (RedHat) Linux using the mkvolgrp command, the -type parameter must be set to scsimap256.
  3. When you create DS6000 volume groups for AIX5L, the -type parameter must be set to scsimap.

If you are using an HP-UX operating system, the number of volumes in the volume group must not exceed 7 volumes. This restriction only applies when the hostconnect attribute for the -addrdiscovery parameter is set to reportlun and the associated volume group is of type scsimap256.

-dev storage_image_ID
(Optional). Specifies the storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified volume group name.
Example: IBM.1750-68FA120
-hosttype host_type
(Optional) Use this parameter as an alternative method for specifying the type of Volume Group.
Note: You cannot use this parameter with the -type parameter.
-type | scsimask | scsimap256 | os400mask |
(Optional). Specifies the type of the volume group.
scsimask (default)
Creates a SCSI mask volume group. This option is available if the host adapter supports four-byte LUN addresses.
scsimap256
Creates a SCSI-MAP 256 volume group.
os400mask
Creates an OS400 mask volume group. The IBM iSeries host system typically uses fixed block volumes of 520-byte logical block size. This option is available only if the host adapter supports four-byte LUN addresses.
Note: This volume group is also referred to as SCSI520-MASK. When an error message is displayed for the OS400 MASK, SCSI520-MASK is referenced instead.
Note: You cannot use this parameter with the -type parameter.
-volume volume_ID | . . .
(Optional). Specifies the array of volume IDs to include in the volume group. For the -type scsimap256 parameter, the array cannot exceed 256 volume ID entries. Otherwise, up to 64 384 entries are allowed.
The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E (for 1750) , and ZZ is the volume number (00 - FF).
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 comma between each ID or range of IDs.
Example: 0100-010F,0180-018F,0120
-lun lun_ID
(Optional)Specifies the LUN ID in hexadecimal value (00 - FF) which is mapped to the specified volume ID for a SCSI-MAP256 type volume group. If multiple volume IDs are specified by the -volume parameter, LUN IDs are assigned consecutively in incremental order.
Note: This parameter is only valid for a SCSI-MAP 256 type volume group. If this parameter is specified for any other type of volume group, the command fails.
Volume_Group_Name | -
(Required). Specifies the volume group name, not to exceed 16 characters. Ensure that the name is unique within the scope of the storage image. Accepts a fully qualified volume group name or a shortened version, if the -dev parameter is specified.
If you specify the dash (-), this parameter information is automatically supplied.

Example (1750)

Invoking the mkvolgrp command
dscli>mkvolgrp -dev IBM.1750-68FA120 
	-volume 0000-000F host_xyz_volumes
The resulting output
Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.1750-68FA120  

Volume group V0 successfully created.
Related tasks
Configuring new fixed block storage
Creating fixed block volume groups using the DS CLI
Related reference
chlss
lslss
showlss
mkfbvol
chfbvol
rmfbvol
lsfbvol
showfbvol
chvolgrp
rmvolgrp
lsvolgrp
showvolgrp
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.