





                        POOL Monitoring and Analysis Package



               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).




                                POOLMN - POOL Monitor



               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:

          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

               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,


                                                                     Page 2



          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.




                              POOLANAL - POOL Analysis



               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 -

          o  Produces a table of low, high, mean,  standard  deviation  and
             coefficient  of  variance for each sampled variable on a daily
             and overall basis.
          o  Notes significant POOL variations by day and time.
          o  Pseudoplots POOL availability by day and time.

          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.

