The showvolgrp command displays detailed properties of a volume group.
>>-showvolgrp--+-------------------------+--+----------+--+-Volume_Group_ID-+->< '- -dev--storage_image_ID-' '- -lunmap-' '-" - "-----------'
Parameters
- -dev storage_image_ID
- (Optional). Specifies the storage image ID, which consists of manufacturer,
machine type, and serial number. Note: 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.
- -lunmap
- (Optional). Specifies that a LUN mapping table be displayed that shows the volume ID and LUN ID relationship. This parameter is valid for all scsi and os400 type volume groups.
- Volume_Group_ID | -
- (Required). Specifies that the properties be displayed for the specified
volume group. This parameter accepts a fully qualified volume group ID, which
consists of the storage image ID, or a shortened version without the storage
image ID if the -dev parameter is specified. The shortened version
is a four-digit decimal number with no leading zeros, prefixed with the letter V.
Examples of -dev parameter use
If you specify the -dev parameter, you can use the shortened version of the Volume_Group_ID parameter as follows:dscli>showvolgrp -dev IBM.1750-68FA120 V11
where V11 represents value for the volume group ID.If you do not specify the -dev parameter, and you specify the Volume_Group_ID parameter, you must specify the fully qualified version of the Volume_Group_ID parameter as follows:dscli>showvolgrp IBM.1750-68FA120/V11
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.
The
following tables represent the headers that are displayed on the output reports
that are associated with the showvolgrp command. A separate example
is not shown for the 1750 because the information is the same for both. The
only difference is the machine type designation, 2107 versus 1750.
Note: The
volume group type determines the format of the LUN ID that is reported. The
following examples demonstrate these differences.
Invoking the showvolgrp command where the volume group
type is SCSI MAP 256
dscli>showvolgrp -lunmap IBM.2107-1300861/V2
The resulting output
Date/Time: May 17, 2006 8:33:58 AM GMT IBM DS CLI Version: 5.0.0.0 DS: IBM.2107-1300861
| Name | ID | Type | Vols |
|---|---|---|---|
My_host_ |
V2 | SCSI- |
1000 1001 |
============================LUN Mapping===========================
| Vol | LUN |
|---|---|
| 1000 | 00 |
| 1001 | 01 |
| 1002 | 02 |
| 1003 | 03 |
| 1004 | 04 |
| 1005 | 05 |
| 1006 | 06 |
| 1007 | 07 |
Invoking the showvolgrp
command where the volume group type is SCSI Mask
dscli>showvolgrp -lunmap IBM.2107-1300861/V18
The resulting output
Date/Time: May 17, 2006 8:38:08 AM GMT IBM DS CLI Version: 5.0.0.0 DS: IBM.2107-1300861
| Name | ID | Type | Vols |
|---|---|---|---|
| myVG1 | V18 | SCSI- |
1000 1001 |
============================LUN Mapping===========================
| Vol | LUN |
|---|---|
| 1000 | 40104000 |
| 1001 | 40104001 |
| 1002 | 40104002 |
| 1003 | 40104003 |
| 1004 | 40104004 |
| 1005 | 40104005 |
| 1006 | 40104006 |
| 1007 | 40104007 |
Report field definitions
- Name
- Specifies the name that you assigned for the designated volume group ID.
- ID
- Specifies the volume group ID. The volume group identifier is a four-digit decimal number having no leading zeros, and prefixed by a V.
- Type
- Specifies the configured volume group type. Any one of the following volume
group types can be queried: SCSI all | SCSI Mask | SCSI MAP 256 | os400 all
| os400 Mask Note: os400 all and os400 Mask are sometimes referred to as SCSI520 all and SCSI520 Mask.
- Vols
- Identifies the complement of accessible volume numbers within the designated volume group.
- Vol (part of LUN mapping table)
- Specifies the volume ID.
- LUNS (part of LUN mapping table)
- Specifies the LUN ID that is mapped to the designated volume ID. As noted in the examples, the LUN IDs can be different based on volume group type.