gmvgstat Command

The gmvgstat command man page provides reference information for the gmvgstat command.

Purpose

Displays GMVG statistics.

Syntax

gmvgstat [-h] | [-r] [-t] [-i Interval [-c Count] [-w]]
[gmvg_name . . .]

Description

The gmvgstat command displays status information for one or more GMVGs including:

Number of Physical Volumes
Number of Remote Physical Volumes
Total Number of Volumes (PVs and RPVs)
Number of Stale Volumes
Total Number of Physical Partitions (PPs)
Number of Stale PPs
Percentage GMVG is synchronized

The gmvgstat command can optionally be invoked in monitor mode by specifying the -i and -c flags.

If one or more GMVG names are supplied on the command line, then the gmvgstat command verifies that each listed GMVG name is a valid, available, online GMVG. In monitor mode, the user-supplied list of GMVGs is verified during each loop.

If no GMVG names are supplied on the command line the gmvgstat command reports information on all valid, available, online GMVGs. In monitor mode the list of GMVGs to report on is regenerated during each loop.

Flags

Table 1. gmvgstat command flags
Flag	Description
-h	Display command syntax and help.
-r	Include information for each individual RPV Client associated with the displayed GMVGs.
-t	Display header with date and time.
-i Interval	Automatically redisplay status every <Interval> seconds. The value of the <Interval> parameter must be an integer greater than zero and less than or equal to 3600. If the <Interval> parameter is not specified, then display the status information once. The -i interval is the time, in seconds, between each successive gathering and display of GMVG statistics in monitor mode. This interval is not a precise measure of the elapsed time between each successive updated display. The gmvgstat command obtains some of the information it displays by calling other commands and has no control over the amount of time these commands take to complete their processing. Larger numbers of GMVGs will result in the gmvgtstat command taking longer to gather information and will elongate the time between successive displays in monitor mode. In some cases, an underlying command may take excessively long to complete and will result in the gmvgstat command taking much longer than the -i interval between displays.
-c Count	Redisplay information at the indicated interval <Count> times. The value of the <Count> parameter must be an integer greater than zero and less than or equal to 999999. If the <Interval> parameter is specified, but the <Count> parameter is not, then redisplay indefinitely.
-w	Clear the screen between each redisplay.

Operands

Table 2. Operand field
Field	Value
gmvg_name	Name of one or more GMVGs for which to display information. If no GMVG names are specified, then information for all valid, available, online GMVGs is displayed.

Exit Status

Table 3. Exit status
Value	Description
0	No errors.
>0	An error occurred.

Examples

To display statistical information for all GMVGs, enter:
```
gmvgstat
```
To display statistical information for the GMVG named red_gmvg7, enter:
```
gmvgstat red_gmvg7
```
To display statistical information for the GMVG named red_gmvg7 with statistics for all the RPVs associated with that volume group, enter:
```
gmvgstat -r red_gmvg7
```
To display detailed information for GMVG red_gmvg7 that is automatically redisplayed every 10 seconds, enter:
```
gmvgstat red_gmvg7 -i 10
```
To display detailed information for GMVG red_gmvg7 that is automatically redisplayed every 10 seconds for 20 intervals and clears the screen between each redisplay, enter:
```
gmvgstat red_gmvg7 -i 10 -c 20 -w
```

Files

/usr/sbin/gmvgstat contains the gmvgstat command.