lsvg command

Purpose

Displays information about volume groups.

Syntax

lsvg [-map | -lv | -pv ] [ -field FieldName ...] [ -fmt Delimiter ] [VolumeGroup ...]

Description

The lsvg command displays information about volume groups. If you use the VolumeGroup parameter, only the information for that volume group is displayed. If you do not use the VolumeGroup parameter, a list of the names of all defined volume groups is displayed.

When information from the Device Configuration database is unavailable, some of the fields will contain a question mark (?) in place of the missing data. The lsvg command attempts to obtain as much information as possible from the description area when the command is given a logical volume identifier.

Full scripting support is provided to the lsvg command by using the -field FieldNames and -fmt Delimiter flags. The -field flag will allow the user to select which output fields to display and in what order, while the -fmt flag provides scriptable output. The output fields will be displayed in the order they appear on the command line.

If you do not specify any flags, the following information will be displayed:

Parameter	Description
Volume group	Name of the volume group. Volume group names must be unique and can range from 1 to 15 characters.
Volume group state	State of the volume group. If the volume group is active, the state is either `active/complete` (indicating all physical volumes are active) or `active/partial` (indicating some physical volumes are not active). If the volume group is not active, the state is `inactive`.
Permission	Access permission: `read-only` or `read-write`.
Max LVs	Maximum number of logical volumes allowed in the volume group.
LVs	Number of logical volumes currently in the volume group.
Open LVs	Number of logical volumes within the volume group that are currently open.
Total PVs	Total number of physical volumes within the volume group.
Active PVs	Number of physical volumes that are currently active.
VG identifier	The volume group identifier.
PP size	Size of each physical partition.
Total PPs	Total number of physical partitions within the volume group.
Free PPs	Number of physical partitions not allocated.
Alloc PPs	Number of physical partitions currently allocated to logical volumes.
Quorum	Number of physical volumes needed for a majority.
VGDS	Number of volume group descriptor areas within the volume group.
Auto-on	Automatic activation at IPL (yes or no).
Concurrent	States whether the volume group is Concurrent Capable or Non-Concurrent Capable.
Auto-Concurrent	States whether you should auto activate the Concurrent Capable volume group in concurrent or non-concurrent mode. For volume groups that are Non-Concurrent Capable, this value defaults to Disabled.
VG Mode	The mode of the volume group: Concurrent or Non-Concurrent.
Node ID	Node id of this node if volume group is in concurrent node.
Active Nodes	Node ids of other concurrent nodes that have this volume group active.
Max PPs Per PV	Maximum number of physical partitions per physical volume allowed for this volume group.
Max PVs	Maximum number of physical volumes allowed in this volume group.
LTG size	Logical track group size, in number of kilobytes, of the volume group.
BB POLICY	Bad block relocation policy of the volume group.
SNAPSHOT VG	Snapshot volume group name if the snapshot volume group is active else snapshot volume group identifier.
PRIMARY VG	Original volume group name of a snapshot volume group if the original volume group is active else original volume group identifier.

Flags

Flag name	Description
-field	Specifies the list of fields to display. The following fields are supported if no flags are specified:
	vgname Name of the volume group. Volume group names must be unique systemwide and can range from 1 to 15 characters. vgstate State of the volume group. If the volume group is activated with the activatevg command, the state is either `active/complete` (indicating all physical volumes are active) or `active/partial` (indicating all physical volumes are not active). If the volume group is de-activated with the deactivatevg command, the state is `inactive`. access Access permission: read-only or read-write.
	maxlvs Maximum number of logical volumes allowed in the volume group. numlvs Number of logical volumes currently in the volume group. openlvs Number of logical volumes within the volume group that are currently open.
	totalpvs Total number of physical volumes within the volume group. stalepvs Number of PVs which are not current. The data is stale. stalepps Number of PPs which are not current. The data is stale.
	totalpps Total number of physical partitions within the volume group. freepps Number of physical partitions not allocated. usedpps Number of physical partitions currently allocated to logical volumes.
	quorum Number of physical volumes needed for a majority. vgds Number of volume group descriptor areas within the volume group. auton Automatic activation at IPL (yes or no).
	pppervg Maximum number of physical partitions allowed in this volume group. ppperpv Maximum number of physical partitions per physical volume allowed for this volume group. maxpvs Maximum number of physical volumes allowed in this volume group. This information is displayed only for 32 and 128 PV volume groups.
	ltgsize Logical track group size of the volume group. The maximum amount of data that can be transferred in one I/O request to the disks of the volume group. The LTG size will be displayed in kilobytes unless the LTG size is greater than 1 MB, in which case megabytes will be used. it is capable of dynamically determining the LTG size based-on the disk topology and it is listed as Dynamic. If that capability is disabled by the user with the option, then it will be listed as Static. bbpolicy Bad block relocation policy of the volume group. hotspare autosync
	The following fields are supported if the -lv flag is specified: lvname A logical volume within the volume group. type Logical volume type. lps Number of logical partitions in the logical volume. pvs Number of physical partitions used by the logical volume. lvstate State of the logical volume. `Opened/stale` indicates the logical volume is open but contains partitions that are not current. `Opened/syncd` indicates the logical volume is open and synchronized. `Closed` indicates the logical volume has not been opened. mount File system mount point for the logical volume, if applicable.
	The following fields are supported if the -pv flag is specified: pvname A physical volume within the volume group. pvstate State of the physical volume. totalpps Number of physical partitions on the physical volume. freepps Number of free physical partitions on the physical volume. dist The number of physical partitions allocated within each section of the physical volume: outer edge, outer middle, center, inner middle, and inner edge of the physical volume.
-fmt	Specifies a delimiter character to separate output fields.
-pv	Lists the following information for each physical volume within the group specified by the VolumeGroup parameter: Physical volume A physical volume within the group. PVstate State of the physical volume. Total PPs Total number of physical partitions on the physical volume.
	Free PPs Number of free physical partitions on the physical volume. Distribution The number of physical partitions allocated within each section of the physical volume: outer edge, outer middle, center, inner middle, and inner edge of the physical volume.
-lv	Lists the following information for each logical volume within the group specified by the VolumeGroup parameter: LV A logical volume within the volume group. Type Logical volume type. LPs Number of logical partitions in the logical volume. PPs Number of physical partitions used by the logical volume.
	PVs Number of physical volumes used by the logical volume. Logical volume state State of the logical volume. `Opened/stale` indicates the logical volume is open but contains partitions that are not current. `Opened/syncd` indicates the logical volume is open and synchronized. `Closed` indicates the logical volume has not been opened. Mount Point File system mount point for the logical volume, if applicable.
-map	Lists the following fields for each logical volume on the physical volume: PVname:PPnum [LVname: LPnum [:Copynum] [PPstate]] PVname Name of the physical volume as specified by the system. PPnum Physical partition number. Physical partition numbers can range from 1 to 1016. LVname Name of the logical volume to which the physical partitions are allocated. Logical volume names must be system-wide unique names, and can range from 1 to 64 characters.
	LPnum Logical partition number. Logical partition numbers can range from 1 to 64,000. Copynum Mirror number. PPstate Only the physical partitions on the physical volume that are not current are shown as stale.

Exit Status

See Exit status for Virtual I/O Server commands.

Examples

To display the names of all volume groups within the system, type the following command:
```
lsvg
```
To display information about volume group vg02, type the following command:
```
lsvg vg02
```
The characteristics and status of both the logical and physical partitions of volume group vg02 are displayed.
To display the names, characteristics, and status of all the logical volumes in volume group vg02, type the following command:
```
lsvg -lv vg02
```

Related Information

The mkvg command, the chvg command, the extendvg command, the reducevg command, the mirrorios command, the unmirrorios command, the activatevg command, the deactivatevg command, the importvg command, the exportvg command, and the syncvg command.

Last updated: Wed, November 18, 2020