svmon Command

Edit online

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. However, the displayed information does not constitute a true snapshot of memory 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:

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:
Item Description
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:
Item Description
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.
Note: Pinned memory pages in the Global report of the svmon command includes kernel locked pages when the kernal lock (vmm_klock_mode option) is enabled. For more information about the kernal lock option, refer to the vmo -h vmm_klock_mode command documentation.

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:
Item Description
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.
Note: The svmon command does not show the decrease in the count for the memory usage when the application releases the memory. When the memory is released from the application, it goes back to the memory free list of the per-process. The svmon command accounts for the memory that is released as the allocated memory for that application.

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:
Item Description
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:
Item Description
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.

Item Description
-@ [ ALL | wparnames ]

Displays report for the workload partitions.

The -@ ALL option specifies to display the report for all of the WPAR starting with the global report, and to process all of the available WPAR, sorting them by the 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 WPAR, 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 specify 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

Item Description
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:
    1. Use the -O affinity = detail argument with caution.
    2. The summary argument with the value of longreal or longname is not supported with the affinity argument.
  • 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).

  • file_mem_scan = [ on | off ]

    If the segment information for some files, such as remote files is not updated by the file system, by default, value of the svmon command does not collect the segment information for those files. By turning file_mem_scan=on, the svmon command scans the entire system's segment table to gather segment information of those files.

    • 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 ), global report when affinity is on ( -G -O affinity = on)
    You can specify the following values for the file_mem_scan option:
    on
    Displays the report with client segments for all files including the files for which the segment information is not updated by the file system.
    off
    Displays the report with client segments for all files excluding the files for which the segment information is not updated by the file system.
Note: If you use the value of file_mem_scan = on, the performance might be impacted based on the number of files opened while running the command and the number of segments in the system.
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 shared 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:
    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.
  • maxbufsize=size[KB | MB | GB]

    The maxbufsize argument modifies the memory buffer size to store the data related to the segment identifiers.

    When you run the svmon command with the -P flag and when the process has more segments, the svm (snapshot of virtual memory) process might fail because of less buffer size. In such cases, use the -O maxbufsize flag to increase the buffer size. The maxbufsize argument overrides the default buffer size value and uses the specified value. In AIX® 7.2.4, or later, the default buffer size is 2 MB. In AIX 7.2.3, or earlier, the default buffer size 512 KB.

  • 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).
    Note: The summary argument with the value of longreal is supported along with the -G flag only.
    ame
    Displays the Active Memory Expansion information (in an Active Memory Expansion enabled system).
    longame
    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
  • threadaffinity= [ on | off ]
    The threadaffinity argument specifies that the svmon command displays the home SRADIDs (Scheduler Resource Allocation Domain Identifier) and the thread SRAD (Scheduler Resource Allocation Domain) affinity statistics for the threads of a process.
    • Default value: off
    • Scope: Process report (-P)
    You can specify the following values to the threadaffinity option:
    on
    Displays the home SRADIDs and thread SRAD affinity statistics for the threads of a process.
    off
    Does not display the home SRADIDs and thread SRAD affinity statistics for the threads of a process.
  • 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.
    Note: The summary argument must have the value of ame.
  • unit = [ auto | page | KB | MB | GB | TB ]

    The unit argument modifies the metrics unit of the report.

    • Default value: page
    • 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 WPAR starting with the global report, and then process all of the available WPAR, 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 WPAR 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 for the Mysupclass superclass with its subclasses, enter the following command: 
    # svmon -W Mysupclass -O subclass=on
  14. To display the memory use for the 0 tier subclasses of the Mysupclass superclass, enter the following command: 
    # svmon -T 0 -a Mysupclass
  15. To display the frames that belong to the 36cfb segment with frame level details, enter the following command: 
    # svmon -D 36cfb -O frame=on
  16. To generate an XML report in the lpar01.svm file, enter the following command: 
    # svmon -X -o lpar01.svm
# svmon -X -o lpar01
  17. To generate an XML report with affinity domain details, enter the following command: 
    # svmon -X -o lpar_affinity -O affinity=on
  18. 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
  19. 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
  20. 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
  21. 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
  22. To display the home SRADIDs and thread SRAD affinity statistics for the threads of a process, enter:
    # svmon -P 1 -O threadaffinity=on