<acis-www.pl> script documentation

1. Introduction:
   This perl script takes the output generated by acis-read.pl, namely the 15 log files containing the mean value, standard deviation, and start/stop times for all the MSIDs monitored in the real-time telemetry and generates an output html file (acis-mean.html) to display these values. The html file is written such that the browser is instructed to reload the page every 2.5 minutes. This script itself is executed every 5 minutes via CRON by user 'acisdude' so that when in real-time contact with the observatory, the page quickly updates the values for the MSIDs monitored. The script also reads in the 5 history files originally produced by acis-backstop.pl, and concatenated to the "global" history files by ACE-update.ksh, so that ACIS operations team personnel may compare the real-time status of the observatory (in terms of obsid, focal plane instrument, gratings status, telemetry format, and dither status) against what is expected from the approved mission load. Moreover, the script also reads in the output ACIS fluence file, produced by acis-fluence_P3pscaling.pl and acis-fluence_FP6pscaling.pl, so that the current ACIS orbital fluence may also be read from this file. Since the EPHIN data are also monitored and displayed, this allows the ACIS operations team members to monitor the radiation environment at Chandra at all times anywhere in the world as long as they have access to a web browser! 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). The xcanuck page is located here while the colossus page can be found here. Lastly, 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. Yellow limit violations are colored "yellow" and red limit violations are colored "red" on the html display page.
2. Execution dependencies:
   Requires the user to be on rhodes to see the primary version, xcanuck (or any other HEAD LAN machine) to see the back-up 1 version and colossus (OPS LAN) to see the back-up 2 version. This script is run via CRON at 5-minute intervals.
3. Script dependencies:
   

   Requires access to the 15 input log files specified below produce by acis-read.pl

   Scripts used by acis-www.pl

   none

   Scripts that depend on the outputs

   none

   File dependencies:
   

   Input 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

   ACIS-FLUENCE.dat (produced by acis-fluence_P3pscaling.pl and acis-fluence_FP6pscaling.pl)

   OBSHIST.dat (produced by acis-backstop.pl)

   GRATHIST-2001.dat (produced by acis-backstop.pl)

   FPHIST-2001.dat (produced by acis-backstop.pl)

   TSCHIST.dat (produced by acis-backstop.pl)

   TLMHIST.dat (produced by acis-backstop.pl)

   DITHHIST.dat (produced by acis-backstop.pl)

   Output files:

   acis-mean.html [rhodes]

   acis-mean.html [xcanuck]

   acis-mean.html [colossus]

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