<acis-read.pl> script documentation

1. Introduction:
   This perl script is to be executed on the ACIS tracelog files produced by ACORN (monitored via acis-acorn-check.pl). What this script does is to find the most current ACIS tracelogs in the current working directory (there should 17 tracelog files in use at any given time) and calculate the mean value and standard deviation for the last 10 samples for each mnemonic in every tracelog file. It will also determine the time span that corresponds to the range of samples in the mean value calculation. The calculated values and time stamps are then written to 15 log files to be displayed on an ACIS scoreboard web-page which is produced by acis-www.pl. This script is run via CRON every 5 minutes by 'acisdude'. limitpager-primary.pl reads in these log files and compares each mean value against a set of red and yellow limits. If an excursion is found email and/or pager alerts are spawned. Under nominal operations, there are three versions running. The "primary" version that is run out of /export/acis-flight/primary/acis/bin/ on rhodes (via UDP port #1135), and the back-up versions that are run out of /home/acisdude/real-time/back-up/acis/bin (via UDP port #11112 on xcanuck and UDP port #11350 on colossus).
2. Execution dependencies:
   Requires the user to be on rhodes to see the primary version, or on xcanuck (or any other HEAD LAN machine) to see the back-up 1 version or on colossus to view the OPS LAN back-up 2 version. This script is run via CRON at 5-minute intervals.
3. Script dependencies:
   

   Requires access to the 17 input tracelogs specified below produce by ACORN.

   Scripts used by acis-read.pl

   none

   Scripts that depend on the outputs

   acis-www.pl

   limitpager_primary.pl

   File dependencies:
   

   Input files:

   acisSWLEDs_*.tl

   acisLED1_*.tl

   acisEPHIN_*.tl

   acisHWLEDs_*.tl

   acismech_*.tl

   acisLED2_*.tl

   acisSIMFOCUS_*.tl

   acisdea_*.tl

   acisother_*.tl

   acistempa_*.tl

   acistempb_*.tl

   acisISIM_*.tl

   acisda_*.tl

   acisdpa_*.tl

   acisFORMAT_*.tl

   acisRADMON_*.tl

   Output files:

   acistempb.log

   acistempa.log

   acissimfocus

   acisother.log

   acismech.log

   acisled2.log

   acisleds.log

   acisled1.log

   acisisim.log

   acisformat.log

   acisdpa.log

   acisdea.log

   acisda.log

   acisEPHIN.log

4. Code Location and execution
5. Problems and Issues
6. Notes