showvolgrp

The showvolgrp command displays detailed properties of a volume group.

Parameters

-dev storage_image_ID

(Optional). The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.

Example: IBM.2107-75FA120

-lunmap

(Optional). A LUN mapping table be displayed that shows the volume ID and LUN ID for all volumes in the specified volume group. This parameter is valid for all scsi and os400 type volume groups.

-etccmap

(Optional). A LUN mapping table be displayed that shows the volume ID, LUN ID, and the Easy Tier® cooperative caching status for all volumes in the specified volume group. While always valid, this parameter is meaningful only when the volumes in the volume group are managed by a host that has the Easy Tier Server utility installed.

Note: Starting with DS8A00, Release 8, Easy Tier Server is no longer supported.

Volume_Group_ID | -

(Required). 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.2107-75FA120  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.2107-75FA120/V11

If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example 1: Displaying detailed properties of a volume group where the volume group type is SCSI MAP 256

The following tables represent the headers that are displayed on the output reports that are associated with the showvolgrp command.

Note: The volume group type determines the format of the LUN ID that is reported. The following examples demonstrate these differences.

dscli> showvolgrp -lunmap IBM.2107-1300861/V2

Output

Name	ID	Type	Vols
My_host_ system_ volumes	V2	SCSI- MAP 256	1000 1001 1002 1003 1004 1005 1006 1007

============================LUN Mapping===========================

vol	lun
1000	00
1001	01
1002	02
1003	03
1004	04
1005	05
1006	06
1007	07

Example 2: Displaying detailed properties of a volume group where the volume group type is SCSI Mask

dscli> showvolgrp -etccmap IBM.2107-1300861/V18

Output

Name	ID	Type	Vols
myVG1	V18	SCSI- Mask	1000 1001 1002 1003 1004 1005 1006 1007

============================ETCC Mapping===========================

vol	lun	ETCCstatus
1000	40104000	Unmanaged
1001	40104001	Unmanaged
1002	40104002	Managed
1003	40104003	Managed
1004	40104004	Unmanaged
1005	40104005	Unmanaged
1006	40104006	Unmanaged
1007	40104007	Unmanaged

Output definitions

Name

The name that you assigned for the designated volume group ID.

ID

The volume group ID. The volume group identifier is a four-digit decimal number having no leading zeros, and prefixed by a V.

Type

Note: os400 all and os400 Mask are sometimes referred to as SCSI520 all and SCSI520 Mask.

Vols

The complement of accessible volume numbers within the designated volume group.

vol (part of LUN mapping table)

The volume ID.

lun (part of LUN mapping table)

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.

ETCCstatus

The Easy Tier Cooperative Caching status.

Disabled: ETCC has been disabled for the storage system.
Managed: Currently, ETCC is managing the volume.
Unmanaged: Currently, ETCC is not managing the volume.
Unmonitored: Currently, ETCC is not monitoring the volume.
Unsupported: The storage system does not support ETCC.
Unknown: The ETCC status is unknown.