Report formatting options

Review the report formatting options for the svmon command.

The svmon configuration file can generate two types of reports for the -G, -P, -U, -C, and -W option:
  • Compact report, which is a one-line-per-entity report.
  • Long report, which uses several lines per entity.

For the -G option, you can switch from the standard report to the compact report with the option -O summary=longreal. For the -P, -U, -C and -W options, a compact report is reported when the option -O summary=basic is set and the option -O segment=off is set (default value).

The following -O options can be used in both compact or long reports:
  • -O format=[80,160,nolimit]: This option sets the width of the report. The default width of most reports is 80 characters. But, some reports need 160 characters, in which case this option is implicitly set. You can always specify to display the reports with more columns, to eliminate truncated strings.
  • -O timestamp=[on | off]: When this flag is set to on, a timestamp, recorded when the svmon command begins retrieving data, is displayed at the beginning of the report. Because the data collection can take some time, you can use the -O timestamp=on with the -i flag to specify timestamp intervals. The time specified with the -i flag is the interval between the end of one svmon command iteration and the start of the next one.

Example:

In this example, the command line specifies to run svmon 3 times every 5 seconds. The timestamp and command line are set with the .svmonrc file.
  • -O commandline=[on|off]: when set to on, this option adds the command line you use to produce the report in the report header.
# svmon -G -i 5 3
Command line : svmon -G -i 5 3
.svmonrc: -O timestamp=on,commandline=on
Unit: page                                                   Timestamp: 11:23:02
-------------------------------------------------------------------------------
               size       inuse        free         pin     virtual  available
memory       262144      227471       34673      140246      223696      53801
pg space     131072       39091

               work        pers        clnt       other
pin          113676           0           0       10186
in use       189693           0       29586
Unit: page                                                   Timestamp: 11:23:07
-------------------------------------------------------------------------------
               size       inuse        free         pin     virtual  available
memory       262144      227473       34671      140243      223697      53800
pg space     131072       39091

               work        pers        clnt       other
pin          113673           0           0       10186
in use       189694           0       29587
Unit: page                                                   Timestamp: 11:23:12
-------------------------------------------------------------------------------
               size       inuse        free         pin     virtual  available
memory       262144      227475       34670      140244      223699      53799
pg space     131072       39091

               work        pers        clnt       other
pin          113674           0           0       10186
in use       189696           0       29587

Example:

# svmon -G -O commandline=on
Command line : svmon -G -O commandline=on 
Unit: page
-------------------------------------------------------------------------------
               size       inuse        free         pin     virtual  available
memory       262144      227312       34832      140242      223536      53961
pg space     131072       39091

               work        pers        clnt       other
pin          113672           0           0       10186
in use       189533           0       29587
  • -O unit=[auto,page,KB,MB,GB]: this option is set to page by default. In this case, the reported metrics for each segment are in the segment page size:
    • s are 4 KB pages
    • m are 64 KB pages
    • L are 16 MB pages
    • S are 16 GB pages

When auto,KB, MB, or GB are used, only the 3 most significant digits are displayed. You should be careful when interpreting the results with a unit other than page. When the auto setting is selected, the abbreviated units are specified immediately after each metric (K for kilobytes, M for megabytes, or G for gigabytes).

Examples:

This is the same report using different unit options:

# svmon -G -O unit=page
Unit: page
==============================================================================
               size       inuse        free         pin     virtual  available
memory      1048576      220617      827959      113371      194382     819969
pg space     131072        1280

               work        pers        clnt       other
pin           78124           0           0       35247
in use       194382           0       26235

# svmon -G -O unit=GB  
Unit: GB
==============================================================================
               size       inuse        free         pin     virtual  available
memory         4.00        0.84        3.16        0.43        0.74       3.13
pg space       0.50           0

               work        pers        clnt       other
pin            0.30           0           0        0.13
in use         0.74           0        0.10

# svmon -G -O unit=auto
Unit: auto
==============================================================================
               size       inuse        free         pin     virtual  available
memory        4.00G     860.78M       3.16G     442.86M     758.29M      3.13G
pg space    512.00M       5.00M

               work        pers        clnt       other
pin         305.17M          0K          0K     137.68M
in use      758.29M          0K     102.49M