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 ] [ -T ] [ -a ] [ -w ] [ -v ] [ Interval ] [ Count ]

wlmstat [ -l Class | -t Tier ] [ -c | -m | -b ] [ -u ] [ 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.
-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 is the latter. The units are: CPU The total CPU time, in microseconds, consumed by a class MEM Unused DKIO 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. The following information 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).
-u	Displays per-tier and total unused resources

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

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

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

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.