Segment details and -O options

Review the segment details and -O options for the svmon command.

Segment details can be added to the user, command, process, and class reports after the summary when the -O segment=on or -O segment=category option is set to:
  • -O segment=on, the list of segments is displayed for each entity.
  • -O segment=category, the segments are grouped into the following three categories for each entity:
    • system: used by the system
    • exclusive: used only by one entity, except for shared memory (shm) segments
    • shared: used by two or more entities, except for shared memory (shm) segments
The following table contains the description of the items that the svmon reports for segment information.
Table 1. Description table
Segment type Segment usage Description
persistent log files IO space mapping
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 no longer mapped
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
client JFS2 files device name: inode number
rmapping I/O space mapping dependent on the role of the segment based on the VSID and ESID

When -O segment=on or -O segment=category is set, additional details can be added:

  • -O range=on: each segment is followed by the ranges, within the segment, where pages have been allocated.

    Example:

    # svmon -P 1 -O range=on
    Unit: page
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
           1 init             16874     8052        0    16858
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
           0         0 work kernel segment               m    576   503    0     576
                       Addr Range: 0..3945
       d802d         d work shared library text          m    467     0    0     467
                       Addr Range: 0..562
        1001         2 work process private              s     98     4    0      98
                       Addr Range: 0..179 : 65309..65535
      1c101d         f work shared library data          s     72     0    0      72
                       Addr Range: 0..545
      1a101b         1 clnt code,/dev/hd2:531            s     11     0    -       -
                       Addr Range: 0..10
       21023         - clnt /dev/hd4:1236                s      5     0    -       -
                       Addr Range: 0..4
  • -O pidlist=on and -O pidlist=number: adds either the list of PIDs of processes or the number of processes using this segment. It also adds either the user name or the command name corresponding to each PID. When the -@ flag is added, the WPAR name is also added.

    Example:

    # svmon -C yes -O pidlist=on
    Unit: page
    ===============================================================================
    Command                              Inuse      Pin     Pgsp  Virtual
    yes                                  16893     8112        0    16892
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
           0         0 work kernel segment               m    579   506    0     579
                       System segment
       d802d         d work shared library text          m    468     0    0     468
                       Shared library text segment
      111750         2 work process private              s     18     4    0      18
                       pid(s)=348386
       e174f         2 work process private              s     18     4    0      18
                       pid(s)=340154
      131752         2 work process private              s     18     4    0      18
                       pid(s)=389352
      1c171d         2 work process private              s     18     4    0      18
                       pid(s)=360640
       81749         f work shared library data          s     17     0    0      17
                       pid(s)=340154
       71726         f work shared library data          s     17     0    0      17
                       pid(s)=360640
      101751         f work shared library data          s     17     0    0      17
                       pid(s)=348386
      121753         f work shared library data          s     17     0    0      17
                       pid(s)=389352
       a172b         1 clnt code,/dev/hd2:338            s      1     0    -       -
                       pid(s)=389352, 360640, 348386, 340154
    
    
    # svmon -C yes -O pidlist=number
    Unit: page
    ===============================================================================
    Command                              Inuse      Pin     Pgsp  Virtual
    yes                                  16893     8112        0    16892
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
           0         0 work kernel segment               m    579   506    0     579
                       System segment
       d802d         d work shared library text          m    468     0    0     468
                       Shared library text segment
      111750         2 work process private              s     18     4    0      18
                       pid number=1
       e174f         2 work process private              s     18     4    0      18
                       pid number=1
      131752         2 work process private              s     18     4    0      18
                       pid number=1
      1c171d         2 work process private              s     18     4    0      18
                       pid number=1
       81749         f work shared library data          s     17     0    0      17
                       pid number=1
       71726         f work shared library data          s     17     0    0      17
                       pid number=1
      101751         f work shared library data          s     17     0    0      17
                       pid number=1
      121753         f work shared library data          s     17     0    0      17
                       pid number=1
       a172b         1 clnt code,/dev/hd2:338            s      1     0    -       -
                       pid number=4
  • -O filename=on: Each persistent segment's complete, corresponding file name is shown. Note that because files can be deeply nested, running the svmon command with this flag, or with the -S and -i flags, can take significantly more time.

    Example:

    # svmon -P 266414 -O filename=on,format=nolimit
    Unit: page
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
      266414 IBM.ServiceRMd    17227     8116        0    17174
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
           0         0 work kernel segment               m    579   506    0     579
       d802d         d work shared library text          m    468     0    0     468
       31322         2 work process private              s    202     4    0     202
      171316         f work shared library data          s    167     0    0     167
      1e133f         - work                              s     52    16    0      52
       11320         1 clnt code,/dev/hd2:9929           s     51     0    -       -
                            /opt/rsct/bin/IBM.ServiceRMd
       b134a         - clnt /dev/hd9var:368              s      1     0    -       -
                            /var/ct/3394394444/registry/local_tree/IBM,ServiceEvent,Class
       a134b         - clnt /dev/hd9var:372              s      1     0    -       -
                            /var/ct/3394394444/registry/local_tree/IBM,ServiceEvent,Resources
        1341         4 work shared memory segment        s      1     0    0       1
      121333         3 mmap maps 2 source(s)             s      0     0    -       -
      131312         - clnt /dev/hd9var:360              s      0     0    -       -
                            /var/ct/IBM.ServiceRM.stderr
      111310         - clnt /dev/hd9var:418              s      0     0    -       -
                            /var/ct/3394394444/lck/mc/RMIBM.ServiceRM
  • -O mapping=on: adds information about the source segment and the mapping segment when a segment is used to map another segment. If this option is used, source segments not belonging to the process address space are listed in the report and marked with an asterisk (*). Note that they are also taken into account in the process-level summary's number calculations.

    Example:

    # svmon -P 266414 -O mapping=off
    Unit: page
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
      266414 IBM.ServiceRM    17227     8116        0    17174
    
    # svmon -P 266414 -O mapping=on
    Unit: page
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
      266414 IBM.ServiceRM    17231     8116        0    17174
    
    # svmon -P 266414 -O mapping=on,segment=on
    Unit: page
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
      266414 IBM.ServiceRM    17231     8116        0    17174
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
           0         0 work kernel segment               m    579   506    0     579
       d802d         d work shared library text          m    468     0    0     468
       31322         2 work process private              s    202     4    0     202
      171316         f work shared library data          s    167     0    0     167
      1e133f         - work                              s     52    16    0      52
       11320         1 clnt code,/dev/hd2:9929           s     51     0    -       -
      191338 *       - clnt /dev/hd9var:363              s      3     0    -       -
      131332 *       - clnt /dev/hd9var:361              s      1     0    -       -
       b134a         - clnt /dev/hd9var:368              s      1     0    -       -
       a134b         - clnt /dev/hd9var:372              s      1     0    -       -
        1341         4 work shared memory segment        s      1     0    0       1
      131312         - clnt /dev/hd9var:360              s      0     0    -       -
      121333         3 mmap maps 2 source(s)             s      0     0    -       -
                       source(s)=131332, 191338
      111310         - clnt /dev/hd9var:418              s      0     0    -       -

In these examples, the mapping option adds or removes the mapping source segments which are not in the address space of the process number 266414. There is a difference of four pages (three pages from segment 191338, and one page from segment 131332) in the Inuse consumption between -O mapping=off and -O mapping=on.

  • -O sortseg=[inuse | pin | pgsp | virtual]: by default, , all segments are sorted in decreasing order of real memory usage (the Inuse metric) for each entity (user, process, command, segment). Sorting options for the report include the following:
    • Inuse: real memory used
    • Pin: pinned memory used
    • Pgsp: paging space memory used
    • Virtual: virtual memory used

    Examples:

    # svmon -P 1 -O unit=KB,segment=on
    Unit: KB
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
           1 init             67752    32400        0    67688
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
           0         0 work kernel segment               m  37056 32384    0   37056
       d802d         d work shared library text          m  29952     0    0   29952
        1001         2 work process private              s    392    16    0     392
      1c101d         f work shared library data          s    288     0    0     288
      1a101b         1 clnt code,/dev/hd2:531            s     44     0    -       -
       21023         - clnt /dev/hd4:1236                s     20     0    -       -
    
    # svmon -P 1 -O unit=KB,segment=on,sortseg=pin
    Unit: KB
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
           1 init             67752    32400        0    67688
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
           0         0 work kernel segment               m  37056 32384    0   37056
        1001         2 work process private              s    392    16    0     392
       21023         - clnt /dev/hd4:1236                s     20     0    -       -
       d802d         d work shared library text          m  29952     0    0   29952
      1a101b         1 clnt code,/dev/hd2:531            s     44     0    -       -
      1c101d         f work shared library data          s    288     0    0     288
  • -O mpss=[on | off]: breaks down the metrics for multiple page size segments, by page size.

    Examples:

    # svmon -P 1 -O segment=on,mpss=on
    Unit: page
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
           1 init             14557     5492        0    14541
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
        502d         d work shared library text          m    502     0    0     502
        2002         0 work kernel segment               m    396   343    0     396
       10001         2 work process private              s    100     4    0     100
                                                         m      0     0    0       0
        8019         f work shared library data          s     73     0    0      73
                                                         m      0     0    0       0
        6017         1 clnt code,/dev/hd2:532            s     11     0    -       -
        e01f         - clnt /dev/hd4:893                 s      5     0    -       -

    sm pages are separated into s and m pages. The metrics reported are in the unit of the page size: s pages are 4 KB and m pages are 64 KB.

  • -O shmid=[on | off]: displays shared memory IDs associated with shared memory segments. This option does not work you run it in inside a WPAR.

    Examples:

    # svmon -P 221326 -O commandline=on,segment=on,shmid=on,filterprop=notempty 
    Command line : svmon -P 221326 -O commandline=on,segment=on,shmid=on,filterprop=notempty 
    
    Unit: page
    -------------------------------------------------------------------------------
         Pid Command          Inuse      Pin     Pgsp  Virtual
      221326 java             20619     6326     9612    27584
    
        Vsid      Esid Type Description              PSize  Inuse   Pin Pgsp Virtual
        502d         d work text or shared-lib code seg  m    585     0    1     585
           0         0 work kernel segment               m    443   393    4     444
       14345         3 work working storage             sm   2877     0 7865    9064
       15364         e work shared memory segment       sm   1082     0 1473    1641
                            shmid:3                                                
       1b36a         f work working storage             sm    105     0  106     238
       17386         - work                              s    100    34   64     146              
       1a38b         2 work process private             sm      7     4   24      31