topsys(8) CLIX topsys(8)
NAME
topsys - Runs CRM utility for monitoring system activity
SYNOPSIS
/usr/ip32/crm/topsys [-U boot_image] [-I interval] [-S snap_file] [-i
input_file] [-o output_file] [-w]
FLAGS
-U boot_image Lists the file specification of the CLIX image which was
booted. This flag is only required 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 specified in 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.
-w Runs topsys in a graphics-based format.
DESCRIPTION
The topsys command monitors the activity of the entire system. It
simultaneously displays the activities that the other four system monitors
(topmem, topcpu, topio, and topfault) show individually to give a complete
overview of system activity.
In graphics format, to expand the list of processes being monitored,
stretch the length of the window with the standard modify icon. To
receive a description of each category represented in the monitor bar
graphs, click on the question mark (?) icon from the window icon box. A
help window will appear.
In graphics format, to change the colors of the bar graphs in topsys,
2/94 - Intergraph Corporation 1
topsys(8) CLIX topsys(8)
click on the color palette icon from the window icon box. A small Color
menu will appear. The foreground color is displayed when the menu first
appears. Clicking the mouse button moves to the next color. Exit and
save the changes by clicking on the delete icon in the Colors window.
These colors are saved for this monitoring session only.
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 samples the system activity every ten seconds.
/usr/ip32/crm/topsys -I 10
FILES
/dev/kmem Allows topsys access to kernel virtual memory space.
/dev/mem Allows topsys access to kernel virtual memory space.
/unix The default CLIX image. The topsys command looks up offsets
into the kernel by using symbols from boot_image.
/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, the 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 unexpected ``disk full'' messages.
EXIT VALUES
The exit values are not valid.
RELATED INFORMATION
Commands: crm(1), topmem(8), topcpu(8), topio(8), topfault(8)
2 Intergraph Corporation - 2/94