[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 6


wlmstat Command

Purpose

Shows WLM per class resource utilization statistics.

Syntax

wlmstat [ -l Class | -t Tier ] [ -S | -s ] [ -c | -m | -b ] [ -B Device ] [ -q ] [ -T ] [ -a ] [ -w ] [ -v ] [ Interval ] [ Count ]

Description

The wlmstat command symbolically displays the contents of WLM data structures retrieved from the kernel. If a Count is specified, wlmstat loops Count times and sleeps Interval seconds after each block is displayed. If Interval and Count are not specified, one output report is produced. If Interval is specified but no Count is given, wlmstat outputs results continuously at the given interval until stopped by a signal (SIGINTR, SIGQUIT, SIGKILL, etc.). By default, wlmstat displays the statistics for all the resources for every superclass and subclass. You can specify flags to narrow the focus of the statistics to a type of resource, tier, superclass or subclass and alter the output format.

Flags


-a Gives absolute figures (relative to the total amount of the resource available to the whole system) for subclasses, with a 0.01% resolution. By default, the figures shown for subclasses are a percentage of the amount of the resource consumed by the superclass, with a 1% resolution. For instance, if a superclass has a CPU target of 7% and the CPU percentage shown by wlmstat without -a for a subclass is 5%, wlmstat with -a shows the CPU percentage for the subclass as 0.35%.
-b Displays only disk I/O statistics.
-B Device Displays disk I/O device statistics.Passing an empty string (-B "") displays the statistics for all the disks accessed by the class.
-c Shows only CPU statistics.
-l Class Displays statistics for Class name. If not specified, all classes display along with a summary for appropriate fields.
-m Shows only physical memory statistics.
-q Suppresses the output of status files of last activation.
-s Displays only subclass statistics.
-S Displays only superclasses statistics.
-t Tier Displays statistics only for the specified Tier.
-T Displays the total numbers for resource utilization since WLM was started or the class was created, whichever happened last. The units are:
  • The total number CPU time, in seconds, that is consumed by a class.
  • The memory*time product consumed by the class expressed as a number of memory pages multiplied by a number of seconds.
  • The total number of 512 byte blocks sent/received by a class for all the disk devices accessed.
-v Specifies verbose mode. This flag, intended for trouble shooting, also displays some class attributes, resource shares and limits and other WLM parameters, including internal parameter values intended for AIX support personnel. Here are the information which can be of interest for users:

Column Header
Description

CLASS
Class name.

tr
tier number (0 to 9)

i
Value of the inheritance attribute: 0 = no, 1 = yes.

#pr
Number of processes in the class. If a class has no (0) process assigned to it, the values shown in the other columns may not be significant.

CPU
CPU utilization of the class (%).

MEM
Physical memory utilization of the class (%).

DKIO
Disk IO bandwidth utilization for the classs (%).

sha
Number of shares ('-' is represented as -1)

min
Resource minimum limit (%)

smx
Resource soft maximum limit (%)

hmx
Resource hard maximum limit (%)

des
(desired): percentage goal (target) calculated by WLM using the shares numbers (%)

npg
Number of memory pages owned by the class.

The other columns are for internal use only and bear no meaning for administrators and end users. This format is better used with a resource selector (-c, -m, or -b) otherwise the lines might be too long to fit into a line of a display terminal.

-w Displays the memory high water mark,that is the maximum number of pages that a class had in memory at any given time since WLM was started or the class was created (whichever happened last).

Display

Results are tabulated, with the following fields:

Name Class name
CPU Percentage of total CPU time consumed by the class.
MEM Percentage of physical memory consumed by the class.
DKIO Percentage of the disk IO bandwidth consumed by the class. This number is the average of the disk bandwidth on all the disk devices accessed by the class, and is usually not very significant. For instance if a class consumes 80% of the bandwidth of one disk and 5% of the bandwidth of two other disks, the DKIO column will show 30%. For details on the per device utilization,, use the -B device option.

Examples

  1. To get a printout of WLM activity right now, type:

    wlmstat
    

    This produces the following output:

                      CLASS CPU MEM DKIO 
               Unclassified   0   0   0 
                  Unmanaged   0   0   0 
                    Default   0   0   0 
                     Shared   0   0   0 
                     System   0   0   0 
                     class1  12   0   0 
           class1.Default     4   0   0 
            class1.Shared     0   0   0 
         class1.subclass1     4   0   0 
         class1.subclass2     4   0   0 
                     class2  12   0   0 
           class2.Default     4   0   0 
            class2.Shared     0   0   0 
         class2.subclass1     4   0   0 
         class2.subclass2     4   0   0 
                
        
    
  2. To get a report for superclass class1, type:

    wlmstat -l class1
    

    This produces the following output:

            
                      CLASS CPU MEM DKIO
     
                     class1  12   0   0 
           class1.Default     4   0   0 
            class1.Shared     0   0   0 
         class1.subclass1     4   0   0 
         class1.subclass2     4   0   0 
           
    
  3. To get a report for subclass sclass1.subclass2 updated every 10 seconds, for one minute, type:

         wlmstat -l class1.subclass2 10 6
    

    This produces the following output:

                      CLASS CPU MEM DKIO 
         class1.subclass2     4   0   0 
         class1.subclass2     4   0   0 
         class1.subclass2     4   0   0 
         class1.subclass2     4   0   0 
         class1.subclass2     4   0   0 
         class1.subclass2     4   0   0 
    

Errors

A warning message is issued by wlmstat if WLM is not started.

Related Information

The wlmcntrl command.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]