La commande 'svmon' permet de suivre les consommations mémoire pour une LPAR ou un processus donné.
Une vue globale est donnée par 'svmon -G' :
# svmon -G
memory 962560 929931 32629 357653 669572 Ded
pg space 1572864 189294
pin 321832 0 0 35821
in use 519489 0 410442
Pour suivre un processus en particulier, taper :
# svmon -P process_pid
------------------------------------------------------------------------------
Pid Command Inuse Pin Pgsp Virtual 64-bit Mthrd 16MB
39452744 ksh 17361 9104 1011 26110 N N N
Vsid Esid Type Description PSize Inuse Pin Pgsp Virtual
8002 0 work kernel segment s 9678 9101 869 10394
3000c d work shared library text s 7471 0 142 15576
83a8ab 2 work process private s 112 3 0 112
8100e4 1 clnt code,/dev/hd2:4992 s 71 0 - -
860291 f work shared library data s 28 0 0 28
84a7d5 - clnt /dev/hd1:57430 s 1 0 - -
La syntaxe officielle pour AIX V6.1 est donnée ci-dessous, en anglais:
svmon Command
Purpose
Captures and analyzes a snapshot of virtual memory.
Syntax
Command report
svmon -C commands [ -O options ] [ -t count ] [ -i interval [ numintervals ] ] [ -@ [ ALL | wparnames ] ]
Detailed segment report
svmon -D sids [ -O options ] [ -i interval [ numintervals ] ]
Global report
svmon -G [ -O options ] [ -i interval [ numintervals ] ] [ -@ [ ALL | wparnames ] ]
Process report
svmon -P [ pids ] [ -O options ] [ [ -t count ] [ -i interval [ numintervals ] ] [ -@ [ ALL | wparnames ] ]
Segment report
svmon -S [ sids ] [ -O options ] [ -t count ] [ -i interval [ numintervals ] ] [ -@ [ ALL | wparnames ] ]
User report
svmon -U [ lognames ] [ -O options ] [ -t count ] [ -i interval [ numintervals ] ] [ -@ [ ALL | wparnames ] ]
Workload management class report
svmon -W [ classnames ] [ -O options ] [ -t count ] [ -i interval [ numintervals ] ] [ -@ [ ALL | wparnames ] ]
Workload management tier report
svmon -T [ tiers ] [ -O options ] [ -a supclassname ] [ -t count ] [ -i interval [ numintervals ] ] [ -@ [ ALL | wparnames ] ]
XML report
svmon X [ -o filename ] [ -i interval [ numintervals ] ] [ -c < comment > ] [ -O options ]
Description
The svmon command displays information about the current state of memory. The displayed information does not constitute a true
snapshot of memory, however, because the svmon command runs at user level with interrupts enabled.
If you specify no flag, the svmon command, by default, reports real memory at the system level.
You can see memory consumption details and generate the following types of reports. To see more information about a type of report,
select one of the following links:
* Command report
* Detailed segment report
* Global report
* Process report
* Segment report
* User report
* Workload management class report
* Workload management tier report
* XML report
The output of these reports can be in compact format or long format. To generate compact format report, specify the -O flag. If you do
not specify the -O flag, the report is in long format.
Command report
The command report displays the statistics of memory use for the specified command. To print this report, specify the -C flag. The
command report can be in compact format or in long format:
Compact report
A one line summary for each command. To set compact report as the default format, specify the -O flag.
Long report
A multiple lines report for each command that contains a summary, a size-per-page report, and the details of the segments. To set
long report as the default format, do not specify the -O flag.
Detailed segment report
The detailed segment report displays detailed information about the primary segments that are specified. To print the detailed segment
report, specify the -D flag.
The detailed segment report is in long report format only.
Global report
The global report displays the statistics of the real memory and paging space that are in use for the whole system. If you do not
specify any flag, the global report is the default format of report that the svmon command generates.
To print the global report, specify the -G flag.
The global report can be in compact format or long format:
Compact report
A report on only the main metrics of the system. This report is one line with a maximum of 160 characters.
Long report
A summary of memory, page size, and affinity domain. The report is multiple lines, which is the default format of global report.
By default, the following metrics are displayed:
* The memory metric displays the memory consumption of the machine.
* The Page Size metric displays the memory consumption of the Page Size.
* The Affinity Domain metric reports the memory affinity by affinity domain.
Process report
The process report displays the memory use for the specified active process. If you do not specify a list of processes, the svmon
command displays the memory use statistics for all active processes.
To print the process report, specify the -P flag.
The process report can be in compact format or long format:
Compact report
A one line report for each process. To set the compact report as the default format, specify the -O flag.
Long report
A multiple lines summary for each process. To set the long report as the default format, do not specify the -O flag. This report
contains a summary for each process, a per-page-size report, and the details of the segments.
Segment report
The segment report displays the statistics of memory use for the specified segments. To display the statistics for all of the defined
segments, do not specify any list.
To print the segment report, specify the -S flag.
The segment report includes metrics for each specified segment. The report contains several lines of metrics for each segment.
User report
The user report displays the statistics of memory use for the specified users (login names). To display the statistics for all of the
users, do not specify any list of login names.
To print the user report, specify the -U flag.
The user report can be in compact format or long format:
Compact report
A one line report for each user. To set the compact report as the default format, specify the -O flag.
Long report
A multiple lines summary for each user. To set the long report as the default format, do not specify the -O flag. This report
contains a summary for each user, a per-page-size report, and the details of the segments.
Workload management class report
The workload management class report displays statistics of memory use for the specified workload management classes. To display the
statistics for all of the defined classes, do not specify any class.
To print the workload management class report, specify the -W flag.
Restriction: This report is available only when the Workload Manager is running. If the Workload Manager is not running, the following
message is displayed and no statistics are reported:
WLM must be started
If the Workload Manager is running in passive mode, the svmon command displays the following message before displaying the statistics:
WLM is running in passive mode
The workload management class report can be in compact format or long format:
Compact report
A one line report for each class. To set the compact report as the default format, specify the -O flag.
Long report
A multiple lines summary for each class. To set the long report as the default format, do not specify the -O flag. This report
contains a summary for each class, a per-page size report, and the details of the segments.
Workload management tier report
The workload management tier report displays information about the tiers, such as the tier number, the superclass name, and the total
number of pages in real memory from segments belonging to the tier.
To print the tier report, specify the -T flag. Only the long report format is supported.
Restriction: This report is available only when the Workload Manager is running. If the Workload Manager is not running, the following
message is displayed and no statistics are reported:
WLM must be started
If the Workload Manager is running in passive mode, the svmon command displays the following message before displaying the statistics:
WLM is running in passive mode
XML report
You can use the svmon command with an -X flag to generate a report in XML format. The XML report contains data of the global
environment, the processes, the segments, the users, the workload management classes, and the commands running on the system.
The report is by default printed to the standard output. To print the output to a file named filename, specify the -O filename flag.
The extension of the output file will be .svm.
The .svm file uses an XML Schema Definition (XSD) that the /usr/lib/perf/svmon_schema.xsd file defines. You can use the XML data in
the XML reports to build custom applications because the schema is self-documented.
In the XML report, if you do not specify the -O affinity argument, or set it to the off value, only the domain affinity at system
level is reported.
Flags
If no command line flag is given, then the -G flag is the default.
-@ [ ALL | wparnames ]
Displays report for the workload partitions.
The -@ ALL option specifies to display the report for all of the WPARs starting with the global report, and to process all of the
available WPARs, sorting them by the WPAR name.
When you specify a list of WPAR names in the wparnames parameter, the WPAR information is displayed in a header, and the report
is displayed without adding WPAR information. All information displayed is restricted to the WPAR that was processed and has
meaning only inside the WPAR. For example, the pid displayed is virtual pid, which is the pid inside the WPAR. The same rule
applies to the svmon options. Each WPAR name in the list is processed in the given order and each svmon report is separated by
the WPARname header.
When you do not specify a list, the svmon command adds WPAR information to existing reports. The pid section and segments section
of the report contain the WPAR name when one is available. Virtual pid information might also be displayed.
When all of the keywords are used, the svmon command processes all of the available WPARs, sorting them by the WPAR name. Note:
The -@ flag is not supported when executed within a workload partition.
-a supclassname
Restricts the scope to the subclasses of the supclassname parameter (in the Tier report that is returned with the -T flag).
-c < comment >
Adds a comment, specified by the comment parameter, into the XML report. Use the -c flag with the -X flag.
-C commands
Displays memory use statistics for the processes running the commands that are specified by the commands parameter.
-D sids
Displays memory use statistics for the segments that the sids parameter specifies, and a detail status of all of the frames of
each segment.
-G
Displays a global report.
-i interval [ numintervals ]
Displays statistics repetitively.
The svmon command collects and prints statistics in the interval that the interval parameter specifies.
The numintervals parameter specifies the number of repetitions. If the numintervals parameter is not specified, the svmon command
runs until you interrupt it (Ctrl+C). Tip: The observed interval might be larger than the specified interval because it might
take a few seconds to collect statistics for some options.
-o filename
Specifies the output file with the filename parameter for XML reports. Use this flag with the -X flag.
-O options
Changes the content and presentation of the reports that the svmon command generates. You can specifies values to the options
parameter to modify the output. Tip: To overwrite the default values that are defined previously by the -O options flag, you can
define the .svmonrc configuration file in the directory where the svmon command is launched.
-P [ pids ]
Displays the memory-usage statistics for the processes that the pids parameter specifies.
-S [ sids ]
Displays the memory-usage statistics for segments that the sids parameter specifies. The sids parameter is a hexadecimal value.
The segment IDs (SIDs) that are specified must be of primary segments. If you do not specify a list of SIDs, the statistics of
memory use are displayed for all of the defined segments.
-t count
Displays the top object in the count parameter to be printed.
-T [ tiers ]
Displays the memory-usage statistics of all of the classes of the tier numbers that the tiers parameter specifies. If you do not
specify a list of tiers, the statistics of memory use are displayed for all of the defined tiers.
-U [ lognames ]
Displays the memory-usage statistics for the login name that the lognames parameter specifies. If you do not specify a list of
login identifiers, the statistics of the memory use are displayed for all of the defined login identifiers.
-W [ classnames ]
Displays the memory-usage statistics for the Workload Manager class that the classnames parameter specifies. If you do not
specify a list of class names, the statistics of memory usage are displayed for all of the defined class names.
-X
Generates the XML report.
Parameters
commands
Specifies the commands to be reported in the command report ( -C ). The value of the commands parameter is a string. You can
specify more than one command. The value of the commands parameter is the exact base name of an executable file.
options
Specifies the content and presentation of each report. Use this parameter with the -O flag.
The values of the options parameter must be separated by commas, or enclosed in quotation marks (“ ”) and separated
by commas or spaces. The following values are valid to the options parameter. Tip: The scope specifies the reports that support
the value.
* activeuser = [ on | off ]
The activeuser argument specifies that the svmon command displays only the active user.
* Default value: off
* Scope: User report ( - U )
You can specify the following values to the activeuser option:
on
Displays only the active user.
off
Displays all of the user.
* affinity = [ on | detail | off ]
The affinity argument specifies that the svmon command displays the memory affinity at process level or segment level.
* Default value: off
* Scope: Global report ( -G ), process report ( -P ), and segment report ( -S )
You can specify the following values to the affinity option:
on
Displays memory affinity at process level
detail
Displays memory affinity at segment level
off
Does not display the memory affinity
In the XML report, if you do not specify the -O affinity argument, or set it to the off value, only the domain affinity at
system level is reported. Note: Use the -O affinity = detail argument with caution.
* commandline = [ on | off ]
The commandline argument specifies that the svmon command displays the command that is used for the current report.
* Default value: off
* Scope: All reports
You can specify the following values to the commandline option:
on
Displays the command that is used for the current report
off
Does not display the command that is used for the current report
options
( Continued description of the valid values for the options parameter).
* filename = [ on | off ]
The filename argument specifies that the svmon command displays the file names of each file segment.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the filename option:
on
Displays the file names of each file segment
off
Does not displays the file name of each file segment
Note: Use the filename argument with caution.
* filtercat = [ off exclusive kernel shared unused unattached ]
The filtercat argument specifies that the svmon command filters the segments by category.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the filtercat option to filter the segments by category:
kernel
Filters the kernel segments.
exclusive
Filters the exclusive segments. The exclusive segments are used by only one process, except the shared-memory
segments that are always reported as either shared or unattached.
shared
Filters the shared segments. The shared segments are used by more than one process, or shared-memory segments used
by at least one process.
unused
Filters the unused segments. The unused segments are not used by any processes.
unattached
Filters the unused shared-memory segments. The unattached segments are shared-memory segments that are not used by
any process.
off
Deactivates the filter. The off option is the same as the command -O filtercat = "kernel exclusive share unused".
Note: The filtercat option changes the value of the reported basic metrics in the summary header because it adds or
removes segments from the report.
options
( Continued description of the valid values for the options parameter).
* filterpgsz = [ off s m L S ]
The filterpgsz argument specifies that the svmon command filters the segments by page size.
* Default value: off
* Scope: Command report ( -C ), detailed segment report ( -D ), process report ( -P ), segment report ( -S ),
workload management tier report ( -T ), user report ( -U ), and workload management class report ( -W )
You can specify the following values to the filterpgsz option to filter the segments by page size:
s
Filters the segments that are 4 KB (small) in page size
m
Filters the segments that are 64 KB (medium) in page size
L
Filters the segments that are 16 MB (large) in page size
S
Filters the segments that are 16 GB (supreme) in page size
off
Deactivates the filterpgsz option
Note: The filterpgsz argument changes the values of the reported metrics in the summary header, because it adds or removes
segments from the report.
To filter segments of different page sizes, you can specify various parameters in the form of <min_size><max_size>.
For example, to filter the segments with small page size and the segments with small and medium page sizes, enter the
following command:
svmon -O filterpgsz="sm s"
* filterprop = [ off notempty data text ]
The filterprop argument specifies that the svmon command filters the segments report by property.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the filterprop option to filter the segments by property:
notempty
Filters the segments with value that is in use and is not equal to zero
data
Filters the data segments, which are computational
text
Filters the text segments, which are not computational
off
Deactivates the filterprop option
Note: The filterprop argument changes the value of the reported basic metrics in the summary header because it adds or
removes segments from the report.
options
( Continued description of the valid values for the options parameter).
* filtertype = [ off working persistent client ]
The filtertype argument specifies that the svmon command filters the segments by type.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the filtertype option to filter the segments by type:
working
Filters the working segments
persistent
Filters the persistent segments, such as the segments on journaled file system (JFS)
client
Filters the client segments, such as the segments on enhance journaled file system (JFS2) or network file system
(NFS)
off
Deactivates the filtertype option, which is the same as the -O filtertype = "working persistent client" command
Note: The filtertype argument changes the value of the reported basic metrics in the summary header, because it adds or
removes segments from the report.
* format = [ 80 | 160 | nolimit ]
The format argument specifies the maximum width, in characters, for the output of the svmon command.
* Default value: 80
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the format option:
80
Limits the width of the output to 80 characters. In a process report, some fields are truncated. In a segment
report, some fields are displayed on separate lines.
160
Limits the width of the output to 160 characters. In a process report, some fields are truncated. In a segment
report, some fields are displayed on separate lines.
nolimit
Does not limit the width in character. Does not truncate fields or display them in separate lines. Some columns of
the report might be shifted.
Tip: You can use the summary argument to force the value of the format option to 160 characters.
* frame = [ on | off ]
The frame argument specifies that the svmon command displays the information per frame.
* Default value: off
* Scope: Detailed segment report ( -D )
You can specify the following values to the frame option:
on
Displays the information per frame
off
Displays the report automatically
options
( Continued description of the valid values for the options parameter).
* mapping = [ on | off ]
The mapping argument specifies that the svmon command displays the source segments that are associated with the segments
that are created by the mmap subroutine (also known as the mmap segments). When the source segments do not pertain to the
process address space and the mapping = on value is specified, the source segments are integrated into the report and are
flagged with an asterisk (*).
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the mapping option:
on
Displays the source segments that are associated to the segments created by the mmap subroutine
off
Does not display the source segments that are associated with the segments created by the mmap subroutine
Note: The mapping argument changes the values of the reported metrics in the summary header because it adds or removes
segments from the report.
* mpss = [ on | off ]
The mpss argument breaks down the value of the mixed page size segment into individual page sizes.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the mpss option:
on
Breaks down the value of the mixed page size segment into individual page sizes
off
Does not break down the value of the mixed page size segment
* overwrite = [ on | off ]
The overwrite argument overwrites the XML file that the svmon command produced.
* Default value: on
* Scope: XML report ( -X )
You can specify the following values to the overwrite option:
on
Overwrites the XML file that the svmon command generated
off
Does not overwrite the XML file
options
( Continued description of the valid values for the options parameter).
* pgsz = [ on | off ]
The pgsz argument specifies that the svmon command displays the sections per page size.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), workload management tier report ( -T ), user report ( -U ),
and workload management class report ( -W )
You can specify the following values to the pgsz option:
on
Displays the sections per page size
off
Displays the report automatically
* pidlist = [ on | number | off ]
The pidlist argument specifies that the svmon command displays a list of process IDs (PIDs) or the number of different
PIDs for each segment.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the filename option:
on
Displays a list of process IDs for each segment.
For special segments, a label is displayed instead a list of process IDs. The following labels are displayed:
* System segment: Labels the segments that are flagged as system segments
* Unused segment: Labels the segments that are not used by any existing processes. For example, persistent
segments that are relative to the files that are no longer in use.
* Unattached segment: Labels the shared-memory segments that are not used by any existing processes.
* Shared-library text: Labels the segments that contain a shared library. The shared library can be used by
most of the processes. This label prevents the display of a long list of processes.
number
Displays the number of different process IDs for each segment.
off
Does not displays the list or number of process IDs for each segment.
options
( Continued description of the valid values for the options parameter).
* process = [ on | off ]
The process argument specifies that the svmon command displays the list of the processes that belong to the entity.
* Default value: off
* Scope: Command report ( -C ), user report ( -U ), and workload management class report ( -W )
You can specify the following values to the process option:
on
Displays the list of the processes that belong to the entity
off
Does not display the list of processes that belong to the entity
* range = [ on | off ]
The range argument specifies that the svmon command displays the ranges of pages within the segments that have been
allocated.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the range option:
on
Displays the ranges of pages within the allocated segments
off
Does not display the ranges of pages within the allocated segments
* segment = [ on | category | off ]
The segment argument specifies that the svmon command displays the segment statistics for entities.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), workload management tier report ( -T ), user report ( -U ),
and workload management class report ( -W )
You can specify the following values to the segment option:
on
Displays a unique segment list. The segments are sorted by the values of the sortseg argument.
category
Groups the segments in three categories: system, exclusive, and shared. The segments in each category are sorted by
the values of the sortseg argument.
off
Does not display the segment lists.
* shmid = [ on | off ]
The shmid argument displays the shared-memory ID that is associated with a shared-memory segment. Restriction: The shmid
argument cannot work with a workload partition.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the shmid option:
on
Displays the shared-memory ID associated to a shared-memory segment
off
Does not display the shared-memory ID associated to a shared-memory segment
Note: Use the shmid argument with caution.
options
( Continued description of the valid values for the options parameter).
* sortentity = [ inuse | pin | pgsp | virtual ]
The sortentity argument specifies the method for the svmon command in sorting the reports.
* Default value: inuse
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W
You can specify the following values to the sortentity option to sort the reports:
inuse
Sorts the reports in decreasing order of real memory consumption
pin
Sorts the reports in decreasing order of pinned memory consumption
pgsp
Sorts the reports in decreasing order of paging space consumption
virtual
Sorts the reports in decreasing order of virtual memory consumption
* sortseg = [ inuse | pin | pgsp | virtual ]
The sortseg argument specifies the method for the svmon command in sorting the segment reports.
* Default value: inuse
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the sortseg option to sort the segment reports:
inuse
Sorts the segments in decreasing order of real memory consumption
pin
Sorts the segments in decreasing order of pinned memory consumption
pgsp
Sorts the segments in decreasing order of paging space consumption
virtual
Sorts the segments in decreasing order of virtual memory consumption
* subclass = [ on | off ]
The subclass specifies that the svmon command displays the statistics of memory use for the subclass of the workload
management classes.
* Default value: off
* Scope: Workload management tier report ( -T ) and workload management class report ( -W )
You can specify the following values to the subclass options:
on
Displays the statistics of memory use of the workload management classes' subclasses
off
Does not display the statistics of memory use of the workload management classes' subclasses
options
( Continued description of the valid values for the options parameter).
* summary = [ basic | longreal | ame | longame ]
The summary argument specifies the format to display the summary for the svmon command.
* Default value: basic
* Scope: Command report ( -C ), global report ( -G ), process report ( -P ), user report ( -U ), and workload
management class report ( -W ) summary = [ ame | longame ] is available only with global report (-G).
You can specify the following values to the summary option:
basic
Displays the basic headers for the svmon command
longreal
Displays the real memory information in a long format (160 columns per line)
ame
Displays the Active Memory Expansion information (in an Active Memory Expansion enabled system).
longreal
Displays the Active Memory Expansion information (in an Active Memory Expansion enabled system) in a long format.
* svmonalloc = [ on | off ]
The svmonalloc argument specifies that the svmon command displays the maximum size of the memory that it dynamically
allocated during its processing.
* Default value: off
* Scope: All reports
You can specify the following values to the svmonalloc options:
on
Displays the maximum size of the allocated memory
off
Does not display the maximum size of the allocated memory
* timestamp = [ on | off ]
The timestamp argument specifies that the svmon command displays the timestamp at the beginning of the report.
* Default value: off
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the timestamp option:
on
Displays the time stamp at the beginning of the report
off
Does not display the time stamp at the beginning of the report
options
( Continued description of the valid values for the options parameter).
* tmem = [ on | off ]
The tmem argument specifies the svmon command to append the true memory details.
* Default value: on
* Scope: Global report (-G).
You can specify the following values to the tmem option.
on
Displays the true memory information at the end of the report
off
Does not display the true memory information.
* unit = [ auto | page | KB | MB | GB | TB ]
The unit argument modifies the metrics unit of the report.
* Default value: auto
* Scope: Command report ( -C ), process report ( -P ), segment report ( -S ), workload management tier report ( -T ),
user report ( -U ), and workload management class report ( -W )
You can specify the following values to the unit option:
auto
Expresses the values in the most appropriate unit with at most three significant digits. The unit used in the
report is specified for each metric.
page
Expresses the values in 4 KB page units. The unit used in the report is specified in the report header.
KB
Expresses the values in kilobytes (KB)
MB
Expresses the values in megabytes (MB)
GB
Expresses the values in gigabytes (GB)
TB
Expresses the values in terabytes (TB)
Tip: To overwrite the default values that are defined previously by the -O options flag, you can define the .svmonrc
configuration file in the directory where the svmon command is launched.
count
Specifies the top object to be printed. Use the count parameter with the -T flag.
interval
Specifies the interval for the svmon command to collect and print statistics. Use the interval parameter with the -i flag.
numintervals
Specifies the number of repetitions for the svmon command to collect and print statistics when the interval parameter is
specified. Use the numintervals parameter with the -i interval option.
If the numintervals parameter is not specified, the svmon command runs until you interrupt it (Ctrl+C).
ALL
Specifies that the -@ flag displays the report for all of the WPARs starting with the global report, and then process all of the
available WPARs, sorting them by the WPAR name.
wparnames
Specifies the workload partitions whose information is to be displayed. When you specify the -@ wparnames option, all of the
information displayed is restricted to the WPAR that the wparnames parameter specifies, and has meaning only inside the WPAR.
Each WPAR name in the list is processed in the given order and each svmon report is separated by the WPARname header.
sids
Specifies the segment IDs (SIDs). The SIDs must be primary segments.
pids
Specifies the process IDs (PIDs). The value of the pids parameter is a decimal value. If you do not supply any list of process
IDs (PIDs), the statistics of memory use are displayed for all active processes. Use the pids parameter with the -P flag.
lognames
Specifies the login names. The value of the lognames parameter is a string. It is an exact login name. If you do not specify any
lists of login identifiers, the statistics of the memory use are displayed for all of the defined login identifiers. Use the
lognames parameter with the -U flag.
classnames
Specifies the Workload Manager class. The value of the classnames parameter is a string. It is the exact name of a class. For a
subclass, the name should be in the form superclassname.subclassname.
tiers
Specifies a tier number for the classes. If you do not specify a list of tiers, the statistics of memory use are displayed for
all of the defined tiers. Use the tiers parameter with the -T flag.
supclassname
Specifies the name of the superclass that the subclasses are restricted to. You cannot specify a list of classes for this flag.
filename
Specifies the name of the output file. It is an alpha-numeric string. The suffix of the output file name is .svm. It is
automatically added to the file name if you do not specify the suffix. Use the filename parameter with the -o flag and the -X
flag.
comment
Specifies the string to add in the <CollectionHeader><Comment> tag of the XML report. Use the comment parameter with the -X flag
and the -c flag.
Security
Any user can run the svmon command. If the user is not a root user, the view will be limited to the user's own processes.
If RBAC is activated and the aix.system.stat role that is attributed to the user, the user can see the same view that the root user
does.
Examples
1 To display global statistics in a one line format every minute for 30 minutes, enter the following command:
# svmon -G -O summary=longreal -i 60 30
2 To display global statics with automatic unit selection, a time stamp, per page size data, and detailed affinity information,
enter the following command:
# svmon -G -O unit=auto,timestamp=on,pgsz=on,affinity=detail
3 To display global statistics for the system and all of its WPARs in a compact format, enter the following command:
# svmon -G -O summary=longreal -@ ALL
4 To display the memory consumption in megabytes (MB) of all processes in a compact report, enter the following command:
# svmon -P -O summary=basic,unit=MB
5 To display the memory consumption of all processes according to the number of virtual pages, and sort the segments for each process by the number of pages in the paging space, enter the following command:
# svmon -P -O segment=on,sortentity=virtual,sortseg=pgsp
6 To display the memory consumption of process 123456 in full detail, enter the following command:
# svmon -P 123456 -O segment=on,pidlist=on,range=on,mapping=on,shmid=on,filename=on,affinity=detail
7 To display the top 10 system segments sorted by the number of pages in real memory, enter the following command:
# svmon -S -t 10 -O filtercat=kernel,sortseg=inuse
8 To display all of the segments that are not attached to a process, enter the following command:
# svmon -S -O filtercat=unattached
9 To display only 16 MB segments with their address ranges, enter the following command:
# svmon -S -O filterpgsz=L -O range=on
10 In the global WPAR, to display the WPAR name that each segment belongs to, enter the following command:
# svmon -S -@
11 To display the memory consumption of all Oracle processes in a compact report for only the shared segments, enter the following command:
# svmon -C oracle -O summary=basic,filtercat=shared
12 To display the top 10 users running the processes that consume the most memory every minute, enter the following command:
# svmon -U -t 10 -O summary=basic -i 60
13 To display the memory use statistics for the pconsole user, including the list of the process identifiers, and with the segments
sorted into categories, enter the following command:
# svmon -U pconsole -O segment=category,pidlist=on
14 To display the memory use for the Mysupclass superclass with its subclasses, enter the following command:
# svmon -W Mysupclass -O subclass=on
15 To display the memory use for the 0 tier subclasses of the Mysupclass superclass, enter the following command:
# svmon -T 0 -a Mysupclass
16 To display the frames that belong to the 36cfb segment with frame level details, enter the following command:
# svmon -D 36cfb -O frame=on
17 To generate an XML report in the lpar01.svm file, enter the following command:
# svmon -X -o lpar01.svm
# svmon -X -o lpar01
18 To generate an XML report with affinity domain details, enter the following command:
# svmon -X -o lpar_affinity -O affinity=on
19 To generate an XML report with affinity domain details at the segment level, enter the following command:
# svmon -X -o lpar_affinitydet -O affinity=detail
20 To display global statistics with memory compression details along with true memory snapshot at the end, enter the following command:
# svmon -G -O summary=ame
21 To display global statistics with memory compression details with true memory details turned-off, enter the following command
# svmon -G -O summary=ame,tmem=off
22 To display global statistics with Active Memory Expansion details (in an Active Memory Expansion enabled system) in a one line format, enter the following command
# svmon -G -O summary=longame
Related information
The rmss Command
The svmon command in AIX Version 6.1 Performance Tools Guide and Reference
Logical volume storage, Paging space, and Workload Manager in CHECK THIS LINK--was AIX 5L(TM) Version 5.3 System Management Concepts:
Operating System and Devices
RBAC in Security