.LM 10
.RM 75
.AUTOPARAGRAPH
.CENTER
POOL Monitoring and Analysis Package
.SKIP 2
	This is a POOL monitoring and analysis package for the disk-based series
of RSX operating systems.  It consists of two parts:  (1) A privileged,
Exec-mapping data acquisition task (POOLMN), and (2) an unprivileged Fortran
data analysis task (POOLANAL).
.SKIP 4
.CENTER
POOLMN - POOL Monitor
.SKIP 2
	This is a POOL monitor, but it's not like the POOL monitor that
comes with RSX.  This is a remote descendant of the original POOL enforcer
task written by Dale Donchin of the DEC RSX implementation group.
	Dale's original task protects a system from low POOL conditions.
This task, however, is a monitor and not an enforcer.  It scans POOL four times
per minute (at the 0, 15, 30 and 45 second marks)
over a 5 minute monitoring period for:
.SKIP
.NO FILL
.NO JUSTIFY
o##Number of POOL fragments
o##Size of second largest POOL fragment in words
o##Size of largest POOL fragment in words
o##Size of total free POOL in words
o##Number of active tasks in GEN
.JUSTIFY
.FILL
	After obtaining this information, it averages the values taken
for each of the above items and writes them to a logging file in LB:[1,4].
It then resynchronizes to the current time and stops until the next monitoring
period 0 second mark.
	The monitor logs high and low POOL for the previous hour on the
system console CO: every hour.  This can be disabled by editing a conditional
in the source.
	Two output formats are available for the logging file
(LB:[1,4]POOLANAL.DAT).  The formats are human readable and compressed.
Human readable is the default.  See the source for details.
	The task is not abortable by ABRT$ or MCR request.  Once started, it
runs until the system crashes.  If you need to abort it, PIP /NV, then delete, its
output file.  It dies at the end of the current monitoring interval.
	The monitor should be started by the startup command file, but POOL is
often unstable during and shortly after startup.  The task waits 5 minutes
before beginning scans to allow POOL to stabilize.  This can be disabled by
editing a conditional in the source.
	To build it, invoke the build command file @POOLMN.
.SKIP 4
.CENTER
POOLANAL - POOL Analysis
.SKIP 2
	An analysis task?  You want an analysis task, you say?  This is indeed
your lucky day.  Here is just the thing for you.
	POOLANAL reads logging files produced by POOLMN, processes and averages
them on a weekly basis, and -
.SKIP
.LM +3
.INDENT -3
o##Produces a table of low, high, mean, standard deviation and coefficient
of variance for each sampled variable on a daily and overall basis.
.INDENT -3
o##Notes significant POOL variations by day and time.
.INDENT -3
o##Pseudoplots POOL availability by day and time.
.LM -3
.SKIP
Output is dumped to a file which is printable on any 132 column line
printer with upper and lower case.
	To build it, invoke the build command file @POOLANAL.
