lsvolgrp

The lsvolgrp command displays a list of volume groups in a storage image and status information for each volume group in the list.


>>-lsvolgrp--+-------------------------+--+-----+--------------->
             '- -dev--storage_image_ID-'  +- -s-+   
                                          '- -l-'   

>--+------------------------+--+---------------------+---------->
   '- -type--+-scsimask---+-'  '- -volume--volume_ID-'   
             +-scsimap256-+                              
             '-os400mask--'                              

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

Parameters

-dev storage_image_ID: (Optional). Specifies the storage image ID, which includes manufacturer, machine type, and serial number. Displays only the objects for the storage unit that is specified. This parameter is required if you do not specify a fully qualified volume group ID and you do not specify a value for the devid variable in your profile file.; Example: IBM.1750-68FA120
-s: (Optional). Displays volume group IDs only. You cannot use the -l and the -s parameters together.
-l: (Optional). Displays the default output plus users. You cannot use the -l and the -s parameters together.
-type | scsimask | scsimap256 | os400mask: (Optional). Displays only volume groups that are configured as the specified volume group type.
-volume volume_ID: (Optional). Displays volume groups that contain the specified volume ID. 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).
Volume_Group_ID . . . | –: (Optional). Displays volume groups with the specified IDs. A volume group ID is a four-digit decimal number with no leading zeroes, prefixed with the letter V.; This parameter accepts a fully qualified volume group ID or a shortened version, if the -dev parameter is specified.; To specify a range of volume group IDs, separate the volume group IDs with a hyphen. You must separate multiple volume group IDs or ranges of volume group IDs with a blank space between each ID or range of IDs.; If you specify a dash (-), this parameter information is automatically supplied.

Example

For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

The following table represents the headers that are displayed on the output report that is associated with the lsvolgrp command using the -l parameter. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the lsvolgrp command

dscli>lsvolgrp -dev IBM.2107-75FA120 -l

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Device: IBM.2107-75FA120

Name	ID	Type
Host_xxx _volumes	1011	OS400 Mask
Host_yyy _volumes	1111	OS400 Map 256
Host_zzz _volumes	1211	SCSI Mask

Report field definitions

Name: Specifies the name you assigned for this volume group ID.
ID: Specifies the storage unit ID followed by the volume group ID. The volume group identifier is a four-digit decimal number, with no leading zeros, prefixed by the letter V.
Type: Specifies the type of the volume group.