rpm(1) UX/RPM 3.10 rpm(1)
NAME
rpm - real-time performance monitor
SYNOPSIS
rpm [-b beginning_snapshot] [-c seconds]
[-C conversion_format [field_delimiter]]
[-d disk_exclude_file] [-e ending_snapshot] [-E]
[-f log_file] [-F conversion_output] [-g f|l] [-h]
[-l 0|1|2|3] [-n n_cycles] [-o option] [-s screen]
[-t] [-L]
DESCRIPTION
UX/RPM is a system performance monitor for Data General's DG/UX
operating system. It may be used by a DG/UX System Administrator
to view and measure various performance statistics including:
- CPU Utilization
- Memory Utilization
- Physical and Virtual Disk I/O
- Process Statistics
- Block and Character I/O
- Network Statistics
- System Call Rates
- Virtual Memory Statistics
UX/RPM allows the following options on startup:
b Specifies the beginning snapshot for conversion of a log
file to some other format such as DIF. The snapshot may
be specified by either a simple count [nnn,], or a time
and optional date [HH:MM:SS [MM/DD/YY]]. Note that if
a date is also specified, that this argument will need
to be quoted since it will include spaces.
c Specifies the initial cycle time in seconds. Note that
seconds must be a positive integer between 0 and 999. If
a cycle time of 0 is used, then UX/RPM must be manually
advanced to a new cycle.
C Specifies that a log file is to be converted to a given
format. Supported formats are:
d - Data Interchange Format (DIF)
a - Delimited ASCII. Default field delimiter is a
comma. An optional user-specified field
delimiter may follow the 'a'.
The default format is DIF.
d Indicates a disk file containing a list of physical disk
numbers that are to be excluded from data collection. This
is useful if the disks have been included in your system
build, but either do not physically exist or are off-line
for some reason. File should be a text file containing
simply the disk numbers to be excluded. The disk numbers
should be entered one per line. The numbers coincide with
the numeric entries in /dev/pdsk.
e Specifies the ending snapshot for conversion of a log
file to some other format such as DIF. The snapshot may
be specified by either a simple count [nnn,], or a time
and optional date [HH:MM:SS [MM/DD/YY]]. Note that if
a date is also specified, that this argument will need
to be quoted since it will include spaces.
E Specifies that an express conversion is to be performed.
The log file is converted and no other actions are possible.
This results in a non-interactive run of RPM. This is the
recommended way to convert log files.
f Indicates the name of the log file to use. If used without
the -l switch, then indicates UX/RPM should playback the
specified log.
F Specifies the first part of the output filenames generated
during a conversion. If this argument is kept to five or
fewer characters, the resulting filenames should be
compatible with DOS naming conventions.
g Indicates character graphics should be used according to the
supplied argument. Possible arguments are:
l - limited graphics, use line drawing characters for
pop up boxes.
f - full graphics, use line drawing characters for pop
up boxes and bar charts for cpu utilization display.
h Display a usage message and exit.
l Specifies that logging is to be performed and the level
of information to record. If the -f switch is not used,
then the log name will be rpm.mm.dd, where mm is the
current month and dd is the current date. Valid log
levels are:
0 - no logging is done. Same as not using the -l switch.
1 - log system information
2 - log system and disk information
3 - log system and disk and process information
L Specifies that the just before exiting, UX/RPM should
write each of the information screens in turn to a file
named rpm.lst. This file will be appended to if it
already exists.
n Indicates that UX/RPM should terminate after collecting
n_cycles of data.
o Specifies optional behavior for UX/RPM. Valid options
are:
nops - Suppress collection of all process data.
novm_ps - Suppress collection of per-process virtual
memory data.
s Start UX/RPM running the screen specified by screen. The
screen is specified using the same letter codes that are
used to switch to a particular screen while UX/RPM is
running. The valid letter codes are:
d - Disk screen - Incremental
D - Disk screen - Accumulated
h - Help screen
i - I/O screen
I - I/O History screen
m - Menu screen
n - Network Screen
N - Network History screen
o - System Overview screen
p - Process screen - Incremental
P - Process screen - Accumulated
s - Scheduling screen
S - Scheduling History screen
v - Virtual memory screen
V - Virtual memory History screen
x - Virtual disk screen - Incremental
X - Virtual disk screen - Accumulated
t Resolve TTY names for process screens. By default, UX/RPM
shows the major and minor device numbers for each process'
TTY. Addition of the -t switch causes UX/RPM to scan all
of the devices in /dev and create a table for translating
the device numbers into device names. The scan takes extra
time during UX/RPM initialization. Omitting this switch
will cause the program to start faster, especially on
large systems with a large number of TTYs and pseudo-TTYs.
EXAMPLES
To collect data every thirty (30) seconds in the background for
one hour, call the log file logging.example:
rpm -l 3 -c 30 -n 120 -f logging.example &
To run rpm interactively with a disk exclusion file and a 5
second cycle time:
rpm -c 5 -d disks.not
To convert a log file (logging.example.log and logging.example.idx)
to DIF for use by a spreadsheet:
rpm -E -f logging.example
FILES
/usr/opt/rpm
directory where UX/RPM should be installed. If UX/RPM is
not installed in this directory, then the environment
variable RPM_PATH must be set to the install directory.
$RPM_PATH/sbin/rpm_license
program to allow user to enter license key. All users must
obtain a valid license key from Data General SEPAC.
$RPM_PATH/.rpm.license
file containing the license key.
$RPM_PATH/rpm.hlp
file containing help indices and text.
.rpmrc
runtime initialization file for UX/RPM. This file can be
in the following directories.
$RPM_PATH/.rpmrc
$HOME/.rpmrc
./.rpmrc
If multiple copies are found then entries in $HOME/.rpmrc
override entries in $RPM_PATH/.rpmrc and entries in
./.rpmrc override all other entries.
uxrpmhdr.dif|txt
Default DIF or ASCII output file for unchanging system information.
uxrpmsin.dif|txt
Default DIF or ASCII output file for incremental system information.
uxrpmsum.dif|txt
Default DIF or ASCII output file for cumulative system information.
uxrpmdnm.txt
Default ASCII output file for physical disk names.
uxrpmXXdin.dif|txt
Default DIF or ASCII output file for incremental disk information,
where XX is the disk number.
uxrpmXXdum.dif|txt
Default DIF or ASCII output file for cumulative disk information,
where XX is the disk number.
uxrpmvnm.txt
Default ASCII output file for virtual disk names.
uxrpmXXvin.dif|txt
Default DIF or ASCII output file for incremental virtual disk
information, where XX is the virtual disk number.
uxrpmXXvum.dif|txt
Default DIF or ASCII output file for cumulative virtual disk
information, where XX is the virtual disk number.
uxrpmjp.dif|txt
Default DIF or ASCII output file for per-Job Processor information.
uxrpmpin.dif|txt
Default DIF or ASCII output file for process information.