MONITOR(1L)

NAME
monitor - display and update information about the AIX version 3 system events and optionally top cpu processes

SYNOPSIS
monitor [-s time] [-ru] [-top [number]] [-all] [-disk] [-net]

DESCRIPTION
Monitor shows various system variables and updates the screen periodically. Monitor can also be used to show top cpu processes. Monitor program can be exited by typing a letter 'q' or by typing cltr-C (keyboard interrupt). Monitor screen can be refreshed immediately by typing ctrl-L. Another key commands are 'd' to toggle disk display, 'n' to toggle net display and 't' to toggle top cpu users display. AIX systems before version 3.2.4 the monitor uses another process to calculate load average values in background. This process is started automatically first time some user tries to use this monitor or any other program which tries to get loadavgvalues with supplied getloadavg-subroutine.

OPTIONS

-s time
    Set the delay between screen updates to time seconds. The default delay is 10 seconds after first initial 1 second delay. Note the smaller the delay is more the monitor will use cputime.

-top [nproc]
    Shows top cpu processes and shows only summary of system variables. If extra parameter is given monitor will show that amount of processes. If display is wider than 95 characters, top-display will show how user and system time distributed among processes.

-all
    Shows both system events and top cpu processes. Note this will need higher window (eg. Xwindows xterm).

-net
    Show detailed network statistics.

-disk
    Show detailed disk information.

-u  Show only uid from users. This could make the top display faster if your passwd database is not fast enough.

-r  Show only running processes or show those processes which have gained CPU time.

DISPLAY
In default mode monitor will show following information

•   hostname, date and time between display delay.

•   percentage distribution of cpu-load (system, wait, user and idle percentages) with graf where '=' means system,

•   runnable processes value/second and load average values of 1, 5 and 15 minute times

•   processes waiting to be swapped in

•   both free and total from real and virtual memory, real memory is RAM-memory and virtual memory is paging space. For real memory the usage is shown for process and file pages. In AIX normal file accesses are done internally by mapping files to memory and thus memory seems to be always used.

•   paging information; pagefaults, pages to be paged in and out from user space and pages to be paged in and out from paging (swap) space, page size in AIX 3.1 is 4 kB,

•   various process and system events: process (context) switches, system call, read and write -calls, forks and execs, three interrupts rcvint, xmtint, mdmint.

•   File and tty-IO variables; iget, namei and dirblk, amout of read and written kbytes, amount of ttybased characters handled.

•   Disk-information, read and written bytes/second and amount of busy time

•   NFS RPC information of read,write and other access calls

•   network (netw) information; amount of read and written kB per second. When using -top option top lines will show:

•   hostname, load average values of 1, 5 and 15 minutes and date

•   percentage distribution of cpu states (user, system, wait and idle time)

•   for real and virtual memory the amount used, free and total memory Following lines will show values of the top cpu time processes sorted by current cpu-usage as first sortkey and by second key the total amount cputime used. The display of processes is similar to ps(1). PID is the process id, USER is the username of the process owner, PRI is the current priority of the process, NICE is the nice value for the process in the range -20 to 20 (note for kernel-processes the nice value is 21 which means that the process has fixed-priority and the nice value doesn't have any meaning), SIZE is the amount virtual memory used, RES is the amount of real memory used, STAT is the status of the process, TIME is the amount of cputime used, CPU% is the cputime distribution between two displays and COMMAND is the short-name of the process command. If process was kernel process "Kernel" is added to process name.

    Monitor -top will display both Kernel and user processes in process list. Kernel processes are display like which consumes all idle CPU cycles. Monitor -top will display with wider screens (more than 94 columns) user and system time distribution among processes.

VERSION
This manual page is for monitor version 1.12

AUTHOR
Jussi Maki, Helsinki University of Techonology, Computing Centre, Email: jmaki@hut.fi URL: http://www.hut.fi/~jmaki

SEE ALSO
vmstat(1), ps(1), sar(1), iostat(1), nfsstat(1)