crm(1) CLIX crm(1)
NAME
crm - Runs CLIX Resource Monitor (CRM)
SYNOPSIS
/usr/ip32/crm/crm.sh
/usr/ip32/crm/crm.server
DESCRIPTION
The crm command invokes a menu-driven fmli interface to the CLIX Resource
Monitor (CRM) for monitoring the CLIX operating system. The CRM monitors
either the system as a whole or individual processes and provides either
alphanumeric displays based on the curses facilities or graphics displays
based on Environ V facilities. The /usr/ip32/crm/crm.sh command creates
an Environ V vterm window and runs CRM in it. The
/usr/ip32/crm/crm.server command runs CRM in the current terminal session,
either in a vterm window or on an alphanumeric terminal.
The initial crm window allows access to online instructions for using crm,
entering the System Monitor and Process Monitor menus, or exiting crm.
Use arrow keys to scroll through the choices and press <Return> to
execute. The following choices are available:
Instructions
Explains how to use the crm labels at the bottom of the crm window,
menus, and forms.
System Monitors
Provides information about the system in areas such as I/O activity
and file, memory, and CPU use. The crm provides the following
system monitors:
⊕ Monitor Parameters (monparam)
⊕ Monitor Disks (mondisk)
⊕ Monitor NFS (monnfs)
⊕ Top Fault Monitor (topfault)
⊕ Top Memory Monitor (topmem)
⊕ Top CPU Monitor (topcpu)
⊕ Top I/O Monitor (topio)
⊕ Top Sys Monitor (topsys)
2/94 - Intergraph Corporation 1
crm(1) CLIX crm(1)
⊕ Show Open Files (showfiles)
⊕ Show Memory Usage (showmemory)
⊕ Show XT Devices (showxt)
Process Monitors
Provides the capability to watch a process and show its paging,
I/O, system call, and instruction execution. The crm command
provides the following process monitors:
⊕ Watcher (watcher)
⊕ Memory Monitor (monregion)
⊕ Process Monitor (monproc)
Exit Exits crm.
System Monitors
Each of the system monitors can be executed from the crm menus or from the
command line by entering the command in parentheses. However, not all
monitors and options are available through the fmli interface.
The following choices are available from the System Monitor menu:
Change Defaults
The change defaults menu option allows the user to change the
defaults for the remaining menu options.
The following defaults can be changed:
Sample Interval
Specifies how frequently the monitor samples and displays
information.
Input File
Reads the data from the input file. The input file must
have been previously created as a crm output file.
Output File
Directs output to the output file.
Graphic Windows
Invokes graphically oriented windows such as topsys.
Learn Mode
Displays the command and options used to execute a monitor.
Separate Windows
2 Intergraph Corporation - 2/94
crm(1) CLIX crm(1)
Invokes a vterm window separate from the fmli window and
runs the selected monitor in the separate window.
Monitor Parameters
Executes monparam.
Monitor Disks
Executes mondisk.
Monitor NFS
Executes monnfs.
Top Fault Monitor
Executes topfault.
Top Memory Monitor
Executes topmem.
Top CPU Monitor
Executes topcpu.
Top I/O Monitor
Executes topio.
Top System Monitor
Executes topsys.
Show Open Files
Executes showfiles.
Show Memory Usage
Executes showmemory.
Show XT Devices
Executes showxt.
Process Monitors
All crm process monitors display in curses-based format by default.
However, the memory and process monitor can also display in a graphics-
based format by selecting an option from crm menus. Select the Delete
icon to exit from graphics-based monitors; press <Ctrl-C> to exit from
curses-based watcher and Q or X to exit from curses-based Memory and
Process monitors.
The crm process monitors may be executed through the crm menus or from the
command line.
The following choices are available from the process monitor menu:
Select Process to Monitor
2/94 - Intergraph Corporation 3
crm(1) CLIX crm(1)
Before a process can be monitored, the user must specify the
process to monitor. The user can key in ps -e at the system prompt
to determine the name or process ID (PID) of processes running on
the system.
Then, to select the process to monitor, the user chooses the Select
Process to Monitor option from the main process monitor menu. A
Change Default options form appears. One of the first four fields
must be completed to specify which process to monitor. The rest of
the fields are optional. A brief description of each field
follows:
Name of program to monitor
Allows the user to enter the process name of the process to
monitor.
PID Allows the user to enter the PID of an active process to
monitor.
Program to execute
Allows the user to enter the pathname (and options) of a
program to execute and monitor simultaneously.
Pre-recorded File
Allows the user to enter the filename (pathname) of a
previously recorded monitoring session.
Output File
Allows the user to enter the filename (pathname) of a file
where the monitoring session will be recorded.
Separate Windows
Allows the user to execute a monitor in graphics-based
format when set to Y. This field applies only to the memory
and process monitors; the Watcher does not run in graphics-
based format. The option causes the Watcher to execute in a
vterm window.
Sample Interval
Allows the user to define how frequently (in seconds) a
monitor will gather information and update the monitor
fields. Enter a positive number in this field. This field
applies only to the process monitor, monproc.
Learn mode
Displays the command and options used to execute a monitor.
Select Watcher Options
The Watcher monitors the page faults and system calls of a
specified process. Before the Watcher is run, page faults and/or
system calls must be enabled. Choose Select Watcher Options from
4 Intergraph Corporation - 2/94
crm(1) CLIX crm(1)
the main process monitor menu. To accept the default values for
each option listed on the Page Faults and System Calls forms, press
<PF3> (SAVE).
Select the Enable Page Faults option. See topfault(8) for a
description of the Demand Zero, Swap, Cache, File, Copy on Write,
and Steal fields. The last three fields on the form are described
as follows:
Starting Virtual Address
Ending Virtual Address
Allows the user to monitor faults occurring only at certain
addresses in the process. These fields allow the user to
define the section of the process in which faults will be
watched.
Maximum Samples
Allows the user to define the number of samples for the
monitor to collect. This definition may prevent the monitor
from running indefinitely.
Select the Enable System Calls option. A description of the fields
follows:
All System Calls
Directs watcher to report all system calls. The default
setting is Y.
I/O Directs watcher to ignore all system calls except for I/O
calls. The default setting is N.
Summary Only
Directs the monitor to display only a summary of system
calls when the monitoring interval is complete instead of
listing all system calls as they are encountered. The
default setting is N.
Run Watcher
Executes watcher.
Run Memory Monitor
Executes monregion.
Run Process Monitor
Executes monproc.
NOTES
Superuser privileges are required to run this monitor on processes other
than those owned by the user.
2/94 - Intergraph Corporation 5
crm(1) CLIX crm(1)
CAUTIONS
Sending raw data to a file can create a very large file, which may result
in unexplained ``disk full'' messages.
EXAMPLES
This example starts crm to monitor the CLIX operating system.
/usr/ip32/crm/crm.server
FILES
/usr/ip32/crm/fmli/* The fmli script files.
/usr/ip32/crm/learn The program used for learn mode.
/usr/ip32/crm/close_std The program used as an interface for fmli to crm
graphic utilities.
/usr/ip32/crm/crm.sh The program that creates an Environ V vterm
window and runs CRM in it.
/usr/ip32/crm/crm.server The program that runs CRM in the current
terminal session, either in a vterm window or on
an alphanumeric terminal.
EXIT VALUES
Exit values are not valid.
RELATED INFORMATION
Commands: mondisk(8), monnfs(8), monparam(8), monproc(1), monregion(1),
showfiles(8), showmemory(8), showxt(8), topcpu(8), topfault(8), topio(8),
topmem(8), topsys(8), watcher(1)
6 Intergraph Corporation - 2/94