monparam(8) CLIX monparam(8)
NAME
monparam - Runs CRM utility for monitoring system parameters
SYNOPSIS
/usr/ip32/crm/monparam [-U boot_image] [-I interval] [-S snap_file] [-i
input_file] [-o output_file]
FLAGS
-U boot_image Lists the file specification of the CLIX image which was
booted. This flag is required only if the boot image has
been moved since the system was booted. (The default boot
image used is set on the Operating System Parameters menu
of the workstation Utility Pages; usually, the image is
the /unix file. However, if the user moves the boot image
to a different directory, the -U flag must be used to tell
the CRM utilities where to find the boot image.)
-I interval Specifies how frequently the monitor samples and displays
information. The interval is the number of seconds. The
default interval is 2 seconds.
-S snap_file Specifies a name for the snapshot file. (The default
filename is /tmp/CRM.snapshot.)
-i input-file Reads the data from input_file every interval seconds.
The input_file must have been created as an output_file
using the -o flag. A hyphen (-) for input_file reads
input from stdin.
-o output_file Directs output to output_file. A hyphen (-) for
output_file directs output to stdout.
DESCRIPTION
The monparam command monitors the parameters of a running system. For
example, monparam can show whether the user is running out of a resource.
This monitor is a complement to the UNIXCFG tility. (UNIXCFG allows the
user to change system parameters.)
The following describes each monparam field:
Sample time Displays how frequently (in seconds) the monitor gathers and
displays information. The default setting is two seconds.
This time interval can be changed by pressing the up arrow
key (to increment) and the down arrow key (to decrement).
Name Displays the name of the parameter being monitored.
2/94 - Intergraph Corporation 1
monparam(8) CLIX monparam(8)
Current Displays the current value of the parameter being monitored.
Max Displays the maximum value of the parameter since the system
was last booted.
Configured Displays the value specified for the parameter under UNIXCFG.
A parameter line will be highlighted when the maximum value is 90 percent
or more of the configured value.
To take a snapshot of the statistics, type S (press <Shift> <S> ). The
statistics shown at that instant are saved to the file /tmp/CRM.snapshot,
or to the file specified with the -S flag.
EXAMPLES
The following example takes a sample every five seconds.
/usr/ip32/crm/monparam -I 5
FILES
/dev/kmem Allows monparam access to kernel virtual memory
space.
/dev/mem Allows monparam access to kernel physical memory
space.
/unix The default CLIX image. The monparam command looks
up offsets into the kernel using symbols from the
boot_image.
/usr/src/uts/clipper/master.d/32c/*
These files are used to find the descriptions of the
parameters. If the UNIXCFG product has not been
loaded, the files will not be found and no
description will be available.
/tmp/CRM.snapshot The default filename of a snapshot.
NOTES
Read permission is required to access some files used by this command. If
the user is denied permission to access the required files, then superuser
privileges are required to run this command.
CAUTIONS
Sending raw data to a file can create a very large file, which can result
in unexplained ``disk full'' messages.
2 Intergraph Corporation - 2/94
monparam(8) CLIX monparam(8)
EXIT VALUES
The exit values are not valid.
RELATED INFORMATION
Commands: crm(1)
2/94 - Intergraph Corporation 3