Commands Reference, Volume 5

svmon Command

Purpose

Captures and analyzes a snapshot of virtual memory.

Syntax

Global Report

svmon -G [ -i Interval [ NumIntervals ] ] [ -z ]

User Report

svmon -U [ LogName1...LogNameN ] [ -r ] [ -n | -s ] [ -w | -f -c ] [ -t Count ] [ -u | -p | -g | -v ] [ -i Interval [ NumIntervals ] ] [ -l ] [ -d ] [ -z ] [ -m ]

Command Report

svmon -C Command1...CommandN [ -r ] [ -n | -s ] [ -w | -f | -c ] [-t Count ] [ -u | -p | -g | -v ] [ -i Interval [ NumIntervals] ] [ -l ] [ -d ] [ -z ] [ -m ]

Workload Management Class Report

svmon -W [ ClassName1...ClassNameN ] [ -e ] [ -r ] [ -n | -s ] [ -w | -f | -c ] [-t Count ] [ -u | -p | -g | -v ] [ -i Interval [ NumIntervals]] [ -l ] [ -d ] [ -z ] [ -m ]

Workload Management Tier Report

svmon -T [ Tier1...TierN ] [ -a SupClassName ] [ -x ] [ -e ] [ -r ] [ -u | -p | -g | -v ] [ -n | -s ] [ -w | -f | -c ] [ -t Count ] [ -i Interval [ NumIntervals ] ] [ -l ] [ -z ] [ -m ]

Process Report

svmon -P [ PID1... PIDN ] [ -r [ -n | -s ] [ -w | -f | -c ] [ -t Count ] [ -u | -p | -g | -v ] [ -i Interval [ NumIntervals] ] [ -l ] [ -z ] [ -m ]

Segment Report

svmon -S [ SID1...SIDN ] [ -r ] [ -n | -s ] [ -w | -f | -c ] [ -t Count ] [ -u | -p | -g | -v ] [ -i Interval [ NumIntervals] ] [ -l ] [ -z ] [ -m ]

Detailed Report

svmon -D SID1..SIDN [ -b ] [ -i Interval [ NumIntervals] ] [ -z ]

Framed Report

svmon -F [ Frame1..FrameN ] [ -i Interval [ NumIntervals] ] [ -z ]

The svmon command displays information about the current state of memory. The displayed information does not constitute a true snapshot of memory, because the svmon command runs at user level with interrupts enabled.

The segment is a set of pages and is the basic object used to report the memory consumption. So the statistics reported by svmon are expressed in terms of pages. A page is a 4K block of virtual memory while a frame is a 4K block of real memory. Unless otherwise noted, all statistics are in units of 4096-byte of memory pages.

The memory consumption is reported using the inuse, free, pin, virtual and paging space counters.

The inuse counter represents the number of used frames.
The free counter represents the number of free frames from all memory pools.
The pin counter represents the number of pinned frames, that is, frames that cannot be swapped.
The virtual counter represents the number of pages allocated in the system virtual space.
The paging space counter represents the number of pages reserved or used on paging spaces.

A segment can be used by multiple processes. Each page from such a segment is accounted for in the inuse, pin, virtual or pgspace fields for each process that uses the segment. Therefore, the total of the inuse, pin, virtual and pgspace fields over all active processes may exceed the total number of pages in memory or on paging space.

VMM manages virtual page counters for statistical purpose only, which means they are not always up-to-date and their values may be less than the corresponding inuse counters.

A segment belongs to one of the five following types:

persistent	Segments used to manipulate files and directories
working	Segments used to implement the data areas of processes and shared memory segments
client	Segments used to implement some virtual file systems like Network File System (NFS) and the CD-ROM file system
mapping	Segments used to implement the mapping of files in memory
real memory mapping	Segments used to access the IO space from the virtual address space.

Implementation Specifics

This command is valid only on the PowerPC platform.

Reports

The svmon command creates nine types of reports:

global
user
command
class
tier
process
segment
detailed segment
frame

Each report type is described here.

Global Report

The global report is printed when the -G flag is specified. The column headings in a global report are:

memory

Specifies statistics describing the use of real memory, including:

size: Number of real memory frames (size of real memory)

Note: This includes any free frames that have been made unusable by the memory sizing tool, the rmss command.
inuse: Number of frames containing pages
free: Number of frames free of all memory pools
pin: Number of frames containing pinned pages
virtual: Number of pages allocated in the system virtual space
stolen: Number of frames stolen by rmss and maked unusable by the VMM

in use

Specifies statistics on the subset of real memory in use, including:

work: Number of frames containing working segment pages
pers: Number of frames containing persistent segment pages
clnt: Number of frames containing client segment pages

pin

Specifies statistics on the subset of real memory containing pinned pages, including:

work: Number of frames containing working segment pinned pages
pers: Number of frames containing persistent segment pinned pages
clnt: Number of frames containing client segment pinned pages

pg space

Specifies statistics describing the use of paging space.

size: Size of paging space
inuse: Number of paging space pages used

User Report

The user report is printed when the -U flag is specified. The column headings in a user login report are:

User

Indicates the user name

Inuse

Indicates the total number of pages in real memory in segments that are used by the user.

Pin

Indicates the total number of pages pinned in segments that are used by the user.

Pgsp

Indicates the total number of pages reserved or used on paging space by segments that are used by the user.

Virtual

Indicates the total number of pages allocated in the process virtual space.

If the -d flag is specified, these statistics are followed by the information about all the processes run by the specified login user name. This information is similar to the one described in Process Report.

Then svmon command displays information about the segments used by those processes. This set of segments is separated into three categories:

Segments that are flagged system by the virtual memory manager
Segments that are only used by the set of processes belonging to the user login name
Segments that are shared between several users

If the -l flag is specified, each segment in the last category is followed by the list of process identifiers that use the segment. Beside the process identifier, the login user name which started it, is also displayed. See the -l flag description for special segments processing.

If the -r flag is specified, each segment is followed by the range(s), within the segment, where pages have been allocated.

Command Report

The command report is printed when the -C flag is specified. The column headings in a command report are:

Command

Indicates the command name.

Inuse

Indicates the total number of pages in real memory in segments that are used by the command (for all process running the command).

Pin

Indicates the total number of pages pinned in segments that are used by the command (for all process running the command).

Pgsp

Indicates the total number of pages reserved or used on paging space by segments that are used by the command.

Virtual

Indicates the total number of pages allocated in the virtual space of the command.

If the -d flag is specified, these statistics are followed by the information about all the processes running the specified command. This information is similar to the one described in Process Report.

Next svmon displays information about the segments used by those processes. This set of segments is separated into three categories:

Segments flagged system by the virtual memory manager
Segments only used by the set of processes running the command
Segments shared between several command names

If the -l flag is specified, each segment in the last category is followed by the list of process identifiers that use the segment. Beside the process identifier, the command name it runs is also displayed. See the -l flag description for special segments processing.

If the -r flag is specified, each segment is followed by the range(s), within the segment, where pages have been allocated.

Workload Management Reports

svmon provides the ability to report workload management related activity with the following 2 types of report:

class report
tier report

These reports are available when the workload manager is running. Otherwise, the message WLM must be started displays and no statistics are reported. When the workload manager is running in passive mode, svmon displays the following message: WLM is running in passive mode before displaying the statistics.

Refer to (Workload Management) in AIX 5L Version 5.1 System Management Guide: Operating System and Devices.

Class Report

The class report prints when the -W flag is specified. The column headings in a class report are:

Class or Superclass: Indicates the class or superclass name.
Inuse: Indicates the total number of pages in real memory from segments belonging to the class.
Pin: Indicates the total number of pages pinned from segments belonging to the class.
Pgsp: Indicates the total number of pages reserved or used on paging space by segments belonging to the class.
Virtual: Indicates the total number of pages allocated in the virtual space of the class.

After these statistics are displayed, svmon displays information about the segments belonging to the class.

If the -e flag is specified, the statistics of the subclasses of the class are displayed and the segments statistics are reported per subclass. In this case, the class parameter must be a superclass name.

If the -l flag is specified, each segment is followed by the list of process identifiers which are using it. Besides the process identifier, the workload class which the process belongs to is also displayed. See the -l flag description for special segments processing.

If the -r flag is specified, each segment is followed by the range(s), within the segment, where pages have been allocated.

Tier Report

The tier report prints when the -T flag is specified. The column headings in a tier report are:

Tier: Indicates the tier number.
Superclass: Optional column heading. Indicates the superclass name when tier applies to a superclass (when the -a flag is used).
Inuse: Indicates the total number of pages in real memory from segments belonging to the tier.
Pin: Indicates the total number of pages pinned from segments belonging to the tier.
Pgsp: Indicates the total number of pages reserved or used on paging space by segments belonging to the tier.
Virtual: Indicates the total number of pages allocated in the virtual space of the tier.

After these statistics are displayed, svmon displays information about the classes belonging to the tier.

If the -e flag is specified, the statistics of the subclasses of each superclass belonging to the tier, are reported.

If the -x flag is specified, svmon displays information about the segments belonging to each class.

The -r and -l flags can only be used in conjunction with -x.

If the -l flag is specified, each segment is followed by the list of process identifiers which are using it. Besides the process identifier, the tier number and class which the process belongs to are also displayed. See the -l flag description for special segments processing.

If the -r flag is specified, each segment is followed by the range(s), within the segment, where pages have been allocated.

Process Report

The process report is printed when the -P flag is specified. The column headings in a process report are:

Pid: Indicates the process ID.
Command: Indicates the command the process is running.
Inuse: Indicates the total number of pages in real memory in segments that are used by the process.
Pin: Indicates the total number of pages pinned in segments that are used by the process.
Pgsp: Indicates the total number of pages reserved or used on paging space by segments that are used by the process.
Virtual: Indicates the total number of pages allocated in the process virtual space.
64-bit: Indicates if the process is a 64 bit process (Y) or a 32 bit process (N).
Mthrd: Indicates if the process is multi-threaded (Y) or not (N).
Once process information are displayed, svmon displays information about all the segments the process uses. Information about segment are described in the paragraph Segment Report

Segment Report

The segment report is printed when the -S flag is specified. The column headings in a segment report are:

Vsid

Indicates the virtual segment ID. Identifies a uniq segment in the VMM.

Esid

Indicates the effective segment ID. The Esid is only valid when the segment belongs to the address space of the process. When provided, it indicates how the segment is used by the process. If the vsid segment is mapped by several processes but with different esid values, then this field contains '-'. In that case, the exact esid values can be obtained through the -P flag applied on each of the process identifiers using the segment. A '-' also displays for segments used to manage open files or multi-threaded structures because these segments are not part of the user address space of the process.

Type

Identifies the type of the segment:

pers indicates a persistent segment
work indicates a working segment
clnt indicates a client segment
map indicates a mapped segment
rmap indicates a real memory mapping segment

Description

Gives a textual description of the segment. The content of this column depends on the segment type and usage (see the segment tables).

If the segment is a persistent segment and is not associated with a log, then the device name and i-node number of the associated file are displayed, separated by a colon. (The device name and i-node can be translated into a file name with the ncheck command.) If the segment is the primary segment of a large file, then the words large file are prepended to the description.

If the segment is a persistent segment and is associated with a log, then the string log displays. If the segment is a working segment, then the svmon command attempts to determine the role of the segment. For instance, special working segments such as the kernel and shared library are recognized by the svmon command. If the segment is the private data segment for a process, then private prints out. If the segment is the code segment for a process, and the segment report prints out in response to the -P flag, then the string code is prepended to the description.

If the segment is mapped by several processes and used in a different way (for example, a process private segment mapped as shared memory by another process), then the description is empty. The exact description can be obtained through -P flag applied on each process identifier using the segment.

If a segment description is too large to fit in the description space, then the description is truncated. The truncated part can be obtained through the -S flag (without -l) on a given segment.

Segment Tables

Description Table

type of segment	segment usage	description
persistent	log files	log
persistent	files and directories	device name : inode number
persistent	large files	large file device name : inode number
mapping	files mapping	mapped to sid source sid
working	data areas of processes and shared memory segments	dependent on the role of the segment based on the VSID and ESID
client	NFS and CD-ROM files	dependent on the role of the segment based on the VSID and ESID
rmapping	IO space mapping	dependent on the role of the segment based on the VSID and ESID

Description Table Based on vsid for a 32-bit Kernel

Segment Type	Description
segment table	segment table
kernel segment	kernel seg
kernel extension segment	kernel ext seg
software page frame segments	page frame table
ram disk segment	ram disk
user's shadow of kernel segment	kernel shadow
paging space disk map segment	page space disk map
base config segment	base config seg
software hat segment	software hat
file structures segment	misc kernel tables
kernel pinned heap segment	kernel pinned heap
address map entry segment	ame segment
page table area segment	page table area

Description Table Based on vsid for a 64-bit Kernel

Segment Type	Description
kernel segment	kernel seg
VMMs private segment	vmm data segment
segment table segments	vmm scb segment
page table area segment	page table area
paging space disk map segment	page space disk map
software hat segments	software hat
software page frame segments	page frame table
real memory heap segment	rmalloc heap
address map entry segments	ame segment

Description Table Based on esid for 32-bit Processes on a 32-bit Kernel

ESID value or ranges	Description
0x0	kernel
0x1	code
0x2	process private
0x3-0xC	shmat/mmap
0xD	shared library text
0xE	shared library ovfl
0xF	shared library data

Description Table Based on esid for 64-bit Processes on a 32-bit Kernel

ESID value or ranges	Description
0x0	kernel
0x2	process private
0xD	shared library text
0x10 - 0x6FFFFFFF	text data BSS heap
0x70000000 -0 x7FFFFFFF	default shmat/mmap
0x80000000 - 0x8FFFFFFF	private load
0x90000000 - 0x90010009	shared library text
0x9001000A - 0x90020013	shared library data
0x90020014 - 0x9FFFFFFE	shared library
0x9FFFFFFF	USLA
0xA0000000 - 0xEFFFFFFF	rsvd for system use
0xF0000000 - 0xFFFFFFFF	application stack

Description Table Based on esid for 32-bit Processes on a 64-bit Kernel

ESID value or ranges	description
0x0	kernel
0x1	code
0x2	process private
0x3-0xC	shmat/mmap
0xD	shared library text
0xE	shmat/mmap
0xF	shared library data
0x9FFFFFD0-0x9FFFFFDF	32 bit user alias
0x9FFFFFF0-0x9FFFFFFF	32bit loader alias

Description Table Based on esid for 64-bit Processes on a 64-bit Kernel

ESID value or ranges	Description
0x0	kernel
0x2	process private
0x3-0xC	shmat/mmap
0xE	shmat/mmap
0x10-0x6FFFFFFF	text data BSS heap
0x70000000-0x7FFFFFFF	default shmat/mmap
0x80000000-0x8FFFFFFF	private load
0x90000000-0x9FFFFFFF	shared library text
0xF0000000-0xFFFFFFFF	application stack

Inuse

Indicates the number of pages in real memory in this segment.

Pin

Indicates the number of pages pinned in this segment.

Pgsp

Indicates the number of pages used on paging space by this segment. This field is relevant only for working segments.

Virtual

Indicates the number of pages allocated for the virtual space of the segment. (Only for working segments).

If the -r flag is specified, the range(s) within the segment pages which have been allocated. A working segment may have two ranges because pages are allocated by starting from both ends and moving towards the middle.

If the -l flag is specified, the list of process identifiers which use that segment is displayed. See the -l flag description for special segments processing.

Detailed Report

The detailed report is printed when the -D flag is specified. The column headings in a detailed report are:

Same segment information as described in the segment report and additionally for each frame:

Page: Relative page number to the virtual space. This page number can be higher than the number of frame in a segment (65535) if the virtual space is larger than a single segment (large file).
Frame: Frame number in the real memory
Pin: Indicates if the frame is pinned or not
Ref: Indicates if the frame has been referenced by a process (-b flag only).
Mod: Indicates if the frame has been modified by a process (-b flag only).
ExtSegid: Extended segment identifier. This field is only set when the page number is higher than the maximum number of frames in a segment.
ExtPage: Extended page number. This field is only set when the page number is higher than the maximum number of frames in a segment and indicates the page number within the extended segment.

Frame Report

The frame report prints when the -F flag is specified.

When no argument is specified, the frame report returns the percentage of real memory used.

When frame numbers are specified, the column headings in the report are:

Frame: Frame number in real memory.
Segid: Indicates the virtual segment ID that the frame belongs to.
Ref
Mod: Indicates if the frame has been modified by a process.
Pincount: Indicates the long term pincount and the short term pincount for the frame.
State: Indicates the state of the frame (Bad, In-Use, Free, I/O, PgAhead, Hidden).
Swbits: Indicates the status of the frame in the Software Page Frame Table.

Flags

If no command line flag is given, then the -G flag is implicit.

-a SupClassName	Restricts the scope to the subclasses of the SupClassName class parameter (in the Tier report -T). The parameter is a superclass name. No list of class is supported.
-b	Shows the status of the reference and modified bits of all the displayed frames (detailed report -D). Once shown the reference bit of the frame is reset. When used with the -i flag it detects which frames are accessed between each interval. Note: This flag should be used with caution because of its performance impacts.
-c	Indicates that only client segments are to be included in the statistics. By default all segments are analyzed.
-C Command1...CommandN	Displays memory usage statistics for the processes running the command name Commandnm1...CommandnmN. Commandnm is a string. It is the exact basename of an executable file.
-d	Displays for a given entity, the memory statistics of the processes belonging to the entity (user name or command name).
-D SID1...SIDN	Displays memory-usage statistics for segments SID1...SIDN, and a detail status of all frames of each segment.
-e	Displays the memory usage statistics of the subclasses of the Class parameter in the Workload Class report -W and in the Tier report -T. The class parameter of -W or -a need to be a superclass name.
-f	Indicates that only persistent segments (files) are to be included in the statistics. By default all segments are analyzed.
-F [ Frame1...FrameN ]	Displays the status of frames Frame1...FrameN including the segments that they belong to. If no list of frames is supplied, the percentage of memory used displays.
-g	Indicates that the information to be displayed is sorted in decreasing order by the total number of pages reserved or used on paging space. This flag in conjunction with the segment report shifts the non-working segment at the end of the sorted list.
-G	Displays a global report.
-i Interval [ NumIntervals]	Instructs the svmon command to display statistics repetitively. Statistics are collected and printed every Interval seconds. NumIntervals is the number of repetitions; if not specified, svmon runs until user interruption, Ctrl-C. Notes: Because it may take a few seconds to collect statistics for some options, the observed interval may be larger than the specified interval.
-l	Shows, for each displayed segment, the list of process identifiers that use the segment and, according to the type of report, the entity name (login, command, tier, or class) the process belongs to. For special segments a label is displayed instead of the list of process identifiers. System segment This label is displayed for segments that are flagged system Unused segment This label is displayed for segments which are not used by any existing processes. For example, persistent segments relative to files no longer in usage. Shared library text This label is displayed for segments that contain text of shared library, and that may be used by most of the processes (for example, libc.a). This is to prevent the display of a long list of process.
-m	Displays information about source segment and mapping segment when a segment is mapping a source segment. The default is to display only information about the mapping segment.
-n	Indicates that only non-system segments are to be included in the statistics. By default all segments are analyzed.
-p	Indicates that the information to be displayed is sorted in decreasing order by the total number of pages pinned.
-P [ PID1... PIDN]	Displays memory usage statistics for process PID1...PIDN. PID is a decimal value. If no list of process IDs (PIDs) is supplied memory usage statistics are displayed for all active processes.
-r	Displays the range(s) within the segment pages which have been allocated. A working segment may have two ranges because pages are allocated by starting from both ends and moving towards the middle.
-s	Indicates that only system segments are to be included in the statistics. By default all segments are analyzed.
-S [ SID1...SIDN ]	Displays memory-usage statistics for segments SID1...SIDN. SID is a hexadecimal value. If no list of segment IDs (SIDs) is supplied memory usage statistics are displayed for all defined segments.
-t Count	Displays memory usage statistics for the top Count object to be printed
-T [ Tier1...TierN ]	Displays memory usage statistics of all the classes of the tier numbers Tier1...TierN. If no list of tier is supplied, memory usage statistics displayd for all the defined tiers.
-u	Indicates that the information to be displayed is sorted in decreasing order by the total number of pages in real memory. It is the default sorting criteria if none of the following flags are present: -p, -g and -v.
-U [ LogName1...LogNameN ]	Displays memory usage statistics for the login name LogName1...LogNameN. LogName is a string, it is an exact login name. If no list of login identifier is supplied, memory usage statistics are displayed for all defined login identifiers.
-v	Indicates that the information to be displayed is sorted in decreasing order by the total number of pages in virtual space. This flag in conjunction with the segment report shifts the non-working segment at the end of the sorted list.
-w	Indicates that only working segments are to be included in the statistics. By default all segments are analyzed.
-W [ Clnm1...ClnmN ]	Displays memory usage statistics for the workload management class Clnm1...ClnmN. Clnm is a string. It is the exact name of a class. For a subclass, the name is should have the form superclassname.subclassname. If no list of class name is supplied, memory usage statistics display for all defined class names.
-x	Displays memory usage statistics for the segments for every class of a tier in the Tier report -T.
-z	Displays the maximum memory size dynamically allocated by svmon during its execution.

Security

Access Control: You must have root authority to run this command.

Examples

To print out global statistics, type:

svmon -G

                size        inuse      free      pin    virtual    
memory         81896        79947      1949     5231     261903
pg space      204800       188717
 
               work         pers       clnt
pin            5239            0          0
in use        77333         2423        191

The memory size of the system is 81896 frames i.e. 81896*4*1024 bytes (320 MB).
This size is split into the inuse frames (79947 frames) and the free frames
(1949 frames).
5231 frames are pinned in memory.
The number of pages allocated in the system virtual space is 261903.
The size of the paging space is 204800 pages i.e. 204800*4*1024 bytes (800 MB).
The number of paging space pages used is 188717.

The pinned frames (5231 frames) is only composed of working segment pinned pages
(5239 frames).
The number of frames containing pages (79947 frames) is composed of working
segment pages (77333 frames), persistent segment pages (2423 frames) and client
segment pages (191 frames).
The sum of the pinned counters (work, pers, clnt) may be different
from the memory pin counter and the sum of in use counters (work, pers, clnt)
may be different from the memory inuse counter due to the statistical purpose
of these counters.

To print out global statistics each minute during 1/2 hour, type:
```
svmon -G -i 60 30
```

To print out the memory statistics for the user steve, type:

svmon -U steve

===============================================================================
User steve              Inuse      Pin     Pgsp  Virtual
                         1975     1203     1059     3985
 
...............................................................................
SYSTEM segments         Inuse      Pin     Pgsp  Virtual
                         1438     1202     1033     2140
 
  Vsid     Esid Type Description           Inuse    Pin Pgsp Virtual
     0        0 work kernel seg             1438   1202 1033  2140
 
 
...............................................................................
EXCLUSIVE segments      Inuse      Pin     Pgsp  Virtual
                          100        1        0       88
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  a771        2 work process private          76     1    0    74   
  cf7c        f work shared library data      23     0    0    14   
  3783        - pers /dev/hd1:6194             1     0    -     -   
 
...............................................................................
SHARED segments         Inuse      Pin     Pgsp  Virtual
                          437        0       26     1757
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  8811        d work shared library text     377     0   26  1757   
  8050        1 pers code,/dev/hd2:4204       58     0    -     -   
  1863        - pers /dev/hd2:12837            2     0    -     -

The user steve has 1975 pages in real memory. 1203 frames are pinned.
The number of pages reserved or used in paging space is 1059.
The number of pages allocated in the virtual space is 3985.

The segments used by the processes run by the user steve are separated into
three categories: 
    SYSTEM   : segments shared by all processes
    EXCLUSIVE: segments used by the set of processes belonging to steve
    SHARED   : segments shared by several users
The global statistics for the user steve is the sum of each field 
(Inuse, Pin, Pgsp, Virtual) of these three categories (SYSTEM, EXCLUSIVE, SHARED).

To print out the memory usage statistics for the users root and steve taking into account only working segments, type:
```
svmon -U root steve -w
```
To print out the top 10 users of the paging space, type:
```
svmon -U -g -t 10
```

To print out the memory usage statistics for the user steve, including the list of the process identifiers, type:

svmon -U steve -l

===============================================================================
User steve              Inuse      Pin     Pgsp  Virtual
                         1977     1203     1059     3985
 
...............................................................................
SYSTEM segments         Inuse      Pin     Pgsp  Virtual
                         1438     1202     1033     2140
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
     0        0 work kernel seg             1438  1202 1033  2140   
                                                                    
 
...............................................................................
EXCLUSIVE segments      Inuse      Pin     Pgsp  Virtual
                          100        1        0       88
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  a771        2 work process private          76     1    0    74   
  cf7c        f work shared library data      23     0    0    14   
  3783        - pers /dev/hd1:6194             1     0    -     -   
 
...............................................................................
SHARED segments         Inuse      Pin     Pgsp  Virtual
                          439        0       26     1757
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  8811        d work shared library text     379     0   26  1757   
                                           Shared library text segment
  8050        1 pers code,/dev/hd2:4204       58     0    -     -   
                     pid:12374    user: steve
                     pid:11194    user: root
                     pid:10870    user: root
                     pid:10574    user: root
                     pid:10000    user: root
                     pid:6544     user: root
  1863        - pers /dev/hd2:12837            2     0    -     -   
                     pid:12374    user: steve
                     pid:11194    user: root
                     pid:10870    user: root
                     pid:10574    user: root
                     pid:10000    user: root
                     pid:6544     user: root

Since the -l flag is specified, each segment of the SHARED segments category
is followed by the list of process identifiers and user names which are 
using it.

To print out the memory usage statistics for the user steve including the processes belonging to steve, type:

svmon -U steve -d

===============================================================================
User steve              Inuse      Pin     Pgsp  Virtual
                         1977     1203     1059     3985
 
-------------------------------------------------------------------------------
     Pid Command        Inuse      Pin     Pgsp  Virtual   64-bit    Mthrd
   12374 -ksh            1977     1203     1059     3985        N        N
 
...............................................................................
SYSTEM segments         Inuse      Pin     Pgsp  Virtual
                         1438     1202     1033     2140
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
     0        0 work kernel seg             1438  1202 1033  2140   
                                                                    
 
...............................................................................
EXCLUSIVE segments      Inuse      Pin     Pgsp  Virtual
                          100        1        0       88
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  a771        2 work process private          76     1    0    74   
  cf7c        f work shared library data      23     0    0    14   
  3783        - pers /dev/hd1:6194             1     0    -     -   
 
...............................................................................
SHARED segments         Inuse      Pin     Pgsp  Virtual
                          439        0       26     1757
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  8811        d work shared library text     379     0   26  1757   
  8050        1 pers code,/dev/hd2:4204       58     0    -     -   
  1863        - pers /dev/hd2:12837            2     0    -     -

Since the -d flag is specified, the global statistics are followed by the 
information about all the processes run by steve.(In this case, only the ksh).

To print out the memory usage statistics for the command login, including the address ranges, type:

svmon -C login -r

===============================================================================
Command                              Inuse      Pin     Pgsp  Virtual
login                                 5065     2402     1245     2906
 
...............................................................................
SYSTEM segments                      Inuse      Pin     Pgsp  Virtual
                                      4057     2400     1245     2783
 
    Vsid     Esid Type Description                   Inuse   Pin Pgsp Virtual
       0        0 work kernel seg                     4057  2400 1245  2783 
                  Addr Range: 0..22694
 
...............................................................................
EXCLUSIVE segments                   Inuse      Pin     Pgsp  Virtual
                                       184        2        0       92
 
    Vsid     Esid Type Description                   Inuse   Pin Pgsp Virtual
    3fe7        2 work process private                  56     2    0    56 
                  Addr Range: 0..37 : 65310..65535
    d8bb        - pers /dev/hd2:8298                    52     0    -     - 
                  Addr Range: 0..249
     ac1        f work shared library data              47     0    0    36 
                  Addr Range: 0..907
    69ed        1 pers code,/dev/hd2:245                15     0    -     - 
                  Addr Range: 0..14
    1863        - pers /dev/hd2:8299                    11     0    -     - 
                  Addr Range: 0..10
    d85b        - pers /dev/hd4:45                       2     0    -     - 
                  Addr Range: 0..1
    c1f8        - pers /dev/hd2:15216                    1     0    -     - 
                  Addr Range: 0..0
 
...............................................................................
SHARED segments                      Inuse      Pin     Pgsp  Virtual
                                       824        0        0       31
 
    Vsid     Esid Type Description                   Inuse   Pin Pgsp Virtual
    b016        d work shared library text             824     0    0    31 
                  Addr Range: 0..1148

The commands login use 5065 pages in real memory. 2402 frames are pinned.
The number of pages reserved or used in paging space is 1245.
The number of pages allocated in the virtual space is 2906.

The segments used by the processes running the command login are separated into
three categories: 
    SYSTEM   : segments shared by all processes
    EXCLUSIVE: segments used by the set of processes running the command login
    SHARED   : segments shared by several users
The global statistics for the user steve is the sum of each field 
(Inuse, Pin, Pgsp, Virtual) of these three categories (SYSTEM, EXCLUSIVE, SHARED).

The address range for each segment is displayed after its statistics.

To print out memory usage statistics for the commands oracle, xemacs and cc, type:
```
svmon -C oracle xemacs cc
```

To print out the memory usage statistics for the superclass System, type:

svmon -W System

===============================================================================
Superclass                           Inuse      Pin     Pgsp  Virtual
System                                2111      465     1128     2394
 
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  700e        - work kernel pinned heap     1235   460 1128  1638   
  af90        - work                         391     1    0   391   
  9f76        - work                         223     0    0   214   
  a771        - work                          67     1    0    67   
    80        - pers /dev/hd2:3               61     0    -     -   
  cf7c        - work                          47     0    0    35   
  f79b        - work                          21     0    0    14   
  9052        - pers /dev/hd3:4               17     0    -     -   
  37a3        - work                          15     2    0    15   
   7a5        - work                          15     0    0     8   
  9797        - work                          12     1    0    12   
  52aa        - pers /dev/hd2:4196             3     0    -     -   
  786f        - pers log                       2     0    -     -   
  ca1a        - pers /dev/hd2:12817            1     0    -     -   
  89b1        - pers /dev/hd4:761              1     0    -     -

The class System uses 2111 pages in real memory. 465 frames are pinned.
The number of pages reserved or used in paging space is 1128.
The number of pages allocated in the virtual space is 2394.

Information about each segment belonging to the class System is then displayed.

To print out the memory usage statistics for the superclass default and developer, type:
```
svmon -W default developer
```

To print out the memory usage for the superclass Mysupclass with its subclasses, type:

svmon -W Mysupclass -e
 
===============================================================================
Superclass                           Inuse      Pin     Pgsp  Virtual
Mysupclass                            1128       14        0      596
 
===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.Default                    1128       14        0      596
 
    Vsid     Esid Type Description                   Inuse   Pin Pgsp Virtual
    f9bf        - pers /dev/hd2:6386                   123     0    -     - 
    6fcd        - work                                  81     2    0    79 
    d1da        - work                                  79     2    0    77 
     260        - work                                  77     2    0    75 
    ea5d        - work                                  77     2    0    75 
    3fe7        - work                                  66     2    0    64 
    d7da        - work                                  66     2    0    64 
    87d0        - work                                  66     2    0    64 
    3867        - pers /dev/hd2:4205                    57     0    -     - 
    522a        - pers /dev/hd2:4392                    47     0    -     - 
    1a23        - pers /dev/hd2:24764                   42     0    -     -

 ===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.Shared                        0        0        0        0
 
===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.subclass                      0        0        0        0
 
As -e flag is specified, the statistics of the superclass Mysupclass are reported with 
the statistics of its subclasses.

To print out the memory usage for all defined tiers, type:

svmon -T

===============================================================================
Tier                                 Inuse      Pin     Pgsp  Virtual
   0                                 23591     5977     1348    11201
 
===============================================================================
Superclass                           Inuse      Pin     Pgsp  Virtual
System                               18274     5965     1348    10405
Unclassified                          3763        8        0       46
Shared                                1237        0        0      496
Default                                317        4        0      254
Unmanaged                                0        0        0        0
 
===============================================================================
Tier                                 Inuse      Pin     Pgsp  Virtual
   1                                  1128       14        0      596
 
===============================================================================
Superclass                           Inuse      Pin     Pgsp  Virtual
Mysupclass                            1128       14        0      596

All the superclasses of all the defined tiers are reported.

To print out the memory usage for the tier 0, type:

svmon -T 0

===============================================================================
Tier                                 Inuse      Pin     Pgsp  Virtual
   0                                 23591     5977     1348    11201
 
===============================================================================
Superclass                           Inuse      Pin     Pgsp  Virtual
System                               18274     5965     1348    10405
Unclassified                          3763        8        0       46
Shared                                1237        0        0      496
Default                                317        4        0      254
Unmanaged                                0        0        0        0

To print out the memory usage for the tier 0 subclasses of the superclass Mysupclass, type:

svmon -T 0 -a Mysupclass

===============================================================================
Tier Superclass                      Inuse      Pin     Pgsp  Virtual
   0 Mysupclass                       1129       14        0      596
 
===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.Default                    1129       14        0      596
Mysupclass.Shared                        0        0        0        0
Mysupclass.subclass                      0        0        0        0
 
All the subclasses, belonging to the tier 0, of the superclass Mysupclass, are reported.

To print out the memory usage for the tiers 0 and 1, including the segment statistics, type:
```
svmon -T 0 1 -x
```

To print out the memory usage for the tier 1, including the subclasses statistics, type:

svmon -T 1 -e

===============================================================================
Tier                                 Inuse      Pin     Pgsp  Virtual
   1                                  1129       14        0      596
 
===============================================================================
Superclass                           Inuse      Pin     Pgsp  Virtual
Mysupclass                            1129       14        0      596
 
===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.Default                    1129       14        0      596
Mysupclass.Shared                        0        0        0        0
Mysupclass.subclass                      0        0        0        0

Each superclass belonging to the tier 1 is reported with its subclass statistics.

To print out the memory usage for the subclasses, in the tier 0, of the superclass Mysupclass, including the segment statistics and the list of process identifiers, type:

svmon -T 0 -a Mysupclass -x -l

===============================================================================
Tier Superclass                      Inuse      Pin     Pgsp  Virtual
   0 Mysupclass                       1129       14        0      596
 
===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.Default                    1129       14        0      596
 
    Vsid     Esid Type Description                   Inuse   Pin Pgsp Virtual
    f9bf        - pers /dev/hd2:6386                   123     0    -     - 
                  Unused segment
    6fcd        2 work process private                  81     2    0    79 
                  pid:13176    tier:0 class:Mysupclass.Default
    d1da        2 work process private                  79     2    0    77 
                  pid:6492     tier:0 class:Mysupclass.Default
     260        2 work process private                  77     2    0    75 
                  pid:10594    tier:0 class:Mysupclass.Default
    3867        1 pers code,/dev/hd2:4205               58     0    -     - 
                  pid:13176    tier:0 class:Mysupclass.Default
                  pid:13000    tier:0 class:Mysupclass.Default
                  pid:12310    tier:0 class:Mysupclass.Default
    6a2d        - pers /dev/hd4:705                      0     0    -     - 
                  Unused segment
 
===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.Shared                        0        0        0        0
 
===============================================================================
Class                                Inuse      Pin     Pgsp  Virtual
Mysupclass.subclass                      0        0        0        0
 
The statistics of all the subclasses, in the tier 0, of the superclass Mysupclass are reported.
Then, as -x is specified, the subclass statistics are followed by its segments statistics. 
Finally, as -l is specified, for each segment, the list of process which uses it, is displayed.
In this list, the process identifier followed by its tier number and its class name are given.

To print out the memory usage statistics for the process 13130, type:

 svmon -P 13130
 
-------------------------------------------------------------------------------
     Pid Command        Inuse      Pin     Pgsp  Virtual   64-bit    Mthrd
   13130 rlogin          1857     1203     1060     3908        N        N
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
     0        0 work kernel seg             1438  1202 1033  2140   
  8811        d work shared library text     379     0   26  1757   
  2741        1 pers code,/dev/hd2:4485       27     0    -     -   
  4f6c        2 work process private           9     1    1     9   
  2701        f work shared library data       4     0    0     2

The process 13130 is running the rlogin command. It is neither a 64 process nor
a multi-threaded process.
This process uses 1857 pages in real memory. 1203 frames are pinned.
The number of pages reserved or used in paging space is 1060.
The number of pages allocated in the virtual space is 3908.

Information about each segment belonging to the process is then displayed.

To print out the memory usage statistics for processes 6746 and 10078 taking into account only working and persistent segments, type:
```
svmon -P 6746 10078 -wf
```
To print out the memory usage statistics of the top 10 process according to the number of pinned pages, enter
```
svmon -P -t 10 -p
```
To print out the memory usage statistics of all the process taking into account only non-system working segments and sorting the process by the number of virtual pages, type:
```
svmon -P -n -w -v
```

To print out the memory usage statistics of segments 700e 8811 and bed7, type:

svmon -S 700e 8811 bed7
 
  Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual 
  700e        - work kernel pinned heap     1236   460 1128  1638  
  8811        - work                         379     0   26  1757  
  bed7        - pers /dev/hd2:41146            0     0    -     -

Information about each segment of the list is displayed.

Esid is not provided because this field is valid only when the segment belongs 
to address space of the process.
The segment 700e is the kernel pinned heap. The segment bed7 is relative to
a file whose device is /dev/hd2 and whose inode number is 41146. The segment 
8811 has no special characteristics.
The Paging space and Virtual fields of the segment bed7 are not meaningful
(persistent segment).

To print out the memory usage statistic of segments e00e and 15015, result sorted by the number of reserved paging space blocks, type:
```
svmon -S e00e 15015 -g
```
To print out the memory usage statistics of the top 5 working segment according to the number of virtual pages , type:
```
svmon -S -t 5 -w -v
```
To sort system segments by the number of pages in real memory, and print out the top 10 system segments of the resulting list, type:
```
svmon -S -s -u -t 10
```

To display the address ranges of the segment 101, type:

svmon -S 101 -r

    Vsid     Esid Type Description           Inuse   Pin Pgsp Virtual
     101        - work                           2     0    0     2 
                       Addr Range: 65534..65535

To print out the frames belonging to the segment 6ec8 type:

svmon -D 6ec8
 
Segid: 6ec8
Type:  persistent
Address Range: 0..6
 
           Page      Frame    Pin  ExtSegid       ExtPage
              0      13852     N          -            - 
              1      14121     N          -            -  
              2      13124     N          -            -  
              3      14179     N          -            -  
              4      13070     N          -            -  
              5      13927     N          -            -  
         122070      78191     N     208831         dcd6

The segment 6ec8 is a persistent segment with 7 pages. None of them is pinned.
The page 122070 is physically the page dcd6 in the extended segment 208831.

To print out the frames belonging to the segment 6ec8 with the status bit of each frame, type:

svmon -D 6ec8 -b
 
Segid: 6ec8
Type:  persistent
Address Range: 0..6
 
           Page      Frame    Pin        Ref        Mod  ExtSegid      ExtPage
              0      13852     N          Y          N          -            - 
              1      14121     N          Y          N          -            - 
              2      13124     N          Y          N          -            - 
              3      14179     N          Y          N          -            - 
              4      13070     N          Y          N          -            - 
              5      13927     N          Y          N          -            - 
              6      13600     N          N          N

As the -b flag is specified, the referenced and modified bits of each frame
of the segment 6ec8 are displayed.

To print out the frames belonging to the segment 6ec8 including the maximum memory size dynamically allocated by svmon during its execution, type:

svmon -D 6ec8 -z

Segid: 6ec8
Type:  persistent
Address Range: 0..6
 
           Page      Frame    Pin  ExtSegid      ExtPage
              0      13852     N          -            -  
              1      14121     N          -            -  
              2      13124     N          -            -  
              3      14179     N          -            -  
              4      13070     N          -            -  
              5      13927     N          -            -  
              6      13600     N          -            -  
Maximum memory allocated = 836

To print out the percentage of memory used, type:

svmon -F

 Processing.. 100%
 percentage of memory used:  85.10%

The percentage of analyzed memory is provided in order to keep the user aware of the processing.
The percentage of memory used (that's mean frames with the reference flag set) is 85,1%.

To print out the status of the frame 49473, type:

svmon -F 49473
 
      Frame  Segid Ref Mod    Pincount   State   Swbits
      49473   f71e   N   N     0/0      In-Use 88000004

The frame 49473 belongs to the segment f71e. The frame is neither referenced nor modified.
It is in the In-use state.

Related Information

The ncheck command, rmss command.

Logical Volume Storage Overview, Paging Space Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

Workload Management in AIX 5L Version 5.1 System Management Guide: Operating System and Devices.