prmmonitor(1)prmmonitor(1)NAMEprmmonitor - monitor the Process Resource Manager
SYNOPSIS
[resource] [interval [iterations]]
DESCRIPTION
prints current Process Resource Manager (PRM) configuration and
resource usage statistics by PRM group.
COMMAND AVAILABILITY
Any user can run the command.
OPTIONS
Running without options prints one iteration of memory and CPU resource
information after a one-second wait.
Display version information and exit.
resource Print only the configuration and usage statistics for the
specified resource. Valid resource keywords are:
CPU resource information
memory resource information
additional memory resource information for kernels
with in-kernel memory control
for disk bandwidth information (specify the full
device name with replaced appropriately for a volume
group (LVM) or a disk group (VxVM))
Include parent hierarchical groups in output. For information on
hierarchical groups, see prmconf(4).
Print the PRM group names in wide-column format, exceeding the
30-column default if necessary to avoid clipping any names.
Terse output.
Print statistics without table headers.
Include PRMID 0 in the statistics. By default, PRMID 0 is not included.
interval The time (in seconds) between successive snapshots. The
default is one second.
iterations The number of samples to take before terminating. The
default is to run until the program is terminated by ^C.
RETURN VALUE
returns exit status:
If no errors occurred
If PRM resource managers are not enabled
If any of the arguments are invalid
OUTPUT DESCRIPTIONS
displays various tables based on the argument you supply. (Specifying
no arguments implies the and arguments.)
All the tables include the following data:
PRM Group
Name of the PRM group
If shared memory management is configured for the PRM group,
shared memory information is shown in a line with the group name
followed by "(SHARED)."
PRMID PRM ID of the PRM group
The table for CPU information includes the column headers:
CPU Entitle
The CPU entitlement assigned to the PRM group in the PRM config‐
uration
CPU Max
The cap on the percentage of the system CPU resources that the
PRM group can access (if assigned in the configuration)
CPU Used
Percentage of the system CPU resources that the PRM group is
using
LCPU State
Indicates whether Hyper-Threading is ON or OFF for a PSET, based
on the LCPU setting in the PRM configuration file. (If no value
is set in the PRM configuration, a nondefault PSET inherits the
Hyper-Threading state the system had before PRM was enabled. The
state from before PRM was enabled is used because PRM may change
the Hyper-Threading setting for PSET 0, where FSS PRM groups are
created, to optimize workload performance.)
This column is blank for systems that do not support
Hyper-Threading. It is also blank for FSS PRM groups.
The table for memory information includes the column headers:
Memory Entitlement
The memory entitlement assigned to the PRM group in the PRM con‐
figuration
Memory Max
The cap on the percentage of the system memory resources that
the PRM group can access (if assigned in the configuration)
Usage Percentage of the system CPU resources that the PRM group is
using
Procs Number of processes running in the group (For it is the number
of processes plus the number of shared memory segments)
The table for MRG Information includes the column headers:
MB Entitled
Amount of memory in megabytes to which the group is entitled
MB Max The maximum number of megabytes of system memory resources that
the PRM group can access (In the configuration, this value is
specified as a MAX value or an IMPORT value.)
MB Locked
Amount of locked memory in megabytes the group is using
Total MB Used
Amount of all memory in megabytes that the group is using
Pages VM IO
Indicates whether the virtual memory subsystem is paging out
The table for disk information includes the column headers:
% entitled
Percentage of the disk bandwidth IO assigned to the group in the
PRM configuration
% achieved
The percentage the group is achieving
KB transferred
Number of kilobytes transferred
EXAMPLES
Print memory and CPU resource statistics every five seconds:
Take 10 samples at five-second intervals and pass the output (with ta‐
ble headers removed) through a filter for analysis:
Print memory resource information only every 10 seconds:
Print disk bandwidth information for /dev/vg03:
Compare CPU resource information with and without the option. With we
see the hierarchical group parents. (Output is abbreviated.) In the
bottom example output, the tools hierarchy is using 2.94% of the CPU
resources, with the tools/mail group accounting for the entire usage.
If the tools/compilers/C and tools/compilers/Fortran groups were using
any CPU resources, those values would appear for the groups themselves
and also be used in computing the value for the tools hierarchy.
CPU CPU CPU LCPU
PRM Group PRMID Entitle Max Used State
________________________________________________________________________
OTHERS 1 2.07% 0.00%
payroll 2 41.23% 36.63%
finance 3 41.23% 61.39%
tools/compilers/C 4 6.10% 0.00%
tools/compilers/Fortran 5 6.10% 0.00%
tools/mail 6 3.27% 1.98%
CPU CPU CPU LCPU
PRM Group PRMID Entitle Max Used State
________________________________________________________________________
OTHERS 1 2.07% 0.00%
finance 3 41.23% 61.27%
payroll 2 41.23% 35.78%
tools HIER 15.47% 2.94%
tools/compilers HIER 12.20% 0.00%
tools/compilers/C 4 6.10% 0.00%
tools/compilers/Fortran 5 6.10% 0.00%
tools/mail 6 3.27% 2.94%
WARNINGS
Differences in output from prmmonitor and top
The output shows the MRG for a process, while the output shows the PRM
group for the process. Typically, the MRG and PRM group for a process
match. However, the values may differ temporarily when a process is
first moved to a new PRM group.
Truncation of PRM Group field
The PRM Group field in all tables is truncated to characters unless you
specify the option.
NOTES
If you enable CPU capping, use the option to report accurately on CPU
resource use. Without the -s, PRM_SYS jobs are factored out and the
relative percentages of the groups remaining are computed. Therefore,
heavy usage by root may make jobs in other groups appear to exceed
their caps.
AUTHOR
was developed by HP.
FILES
default PRM configuration file
SEE ALSOprm(1), prmagt(1), prmanalyze(1), prmavail(1), prmconfig(1), prm‐
list(1), prmloadconf(1), prmmove(1), prmrecover(1), prmrun(1), prm‐
conf(4).
HP Process Resource Manager User's Guide (/opt/prm/doc/PRM.ug.pdf)
HP Process Resource Manager homepage (http://www.hp.com/go/prm)
prmmonitor(1)