<ACE-update.pl> script documentation

1. Introduction:
   ACE-update.pl is a simple script that concatenates each of the history files produced by acis-backstop.pl to the global history files stored in /export/acis-flight/FLU-MON/ on rhodes and acis. (Copies currently also go to FLU-MON directories on han-v, colossus-v, luke-v, colossus, and han, as specified in MachinePath.pl.) These files are stored in these locations because they are also used by acis-fluence_P3pscaling.pl and acis-fluence_FP6pscaling.pl in determining the ACIS fluence each orbit. These history files are also used by acis-www.pl in producing the ACIS real-time hardware telemetry web page.
   The script reads each of the history files from the just approved mission load in the ACIS load review area (currently /data/acis0/LoadReviews/) and does a simple `cat' to the global history files in "back-up" ACIS fluence monitor area (/proj/sot/acis/FLU-MON/). Once all the history files have been updated in this manner, the script the copies all 6 history files to /export/acis-flight/FLU-MON/ on rhodes via 'scp'. Before exiting, the script also copies the approved mission load to a back-up area (currently, /data/acis33/LoadReviews/) and then sends email to 'acisdude' indicating that the script has been run and the history files have been updated. Note history-file-checker-rhodes.pl and history-file-checker.pl are run by CRON at the top of every hour by `acisdude' to ensure that the history files have at least 2.0 days worth of data in the global history files. If not, email and/or pager alerts are spawned. Also note that Robert Cameron uses the focal plane and OTG history files in his real-time CRM monitoring and plots. There may be others in the SOT who also use these files.
   Please note that ACE-update.pl also executes 2 other scripts when it is finished updating the history files; these are: ephin_orbevents.pl and crm_saved_time.pl.
2. Execution dependencies:
   Requires the user to be on any HEAD LAN machine with access to the ACIS load review repository as well as the "back-up" ACIS fluence monitor area (/proj/sot/acis/FLU-MON). Uses scp to copy the history files to rhodes.
3. Script dependencies:
   Requires access to the 6 input files specified below produced by acis-backstop.pl

   Scripts used by ACE-update.pl

   none

   Scripts that depend on the outputs

   acis-www.pl

   acis-fluence_P3pscaling.pl

   acis-fluence_FP6pscaling.pl

   history-file-checker-rhodes.pl

   history-file-checker.pl

   File dependencies:
   

   Input files:

   ACIS-FPHIST.dat

   ACIS-GRATHIST.dat

   ACIS-OBSHIST.dat

   ACIS-TLMHIST.dat

   ACIS-TSCHIST.dat

   ACIS-DITHHIST.dat

   Output files:

   FPHIST-2001.dat

   GRATHIST-2001.dat

   OBSHIST.dat

   TSCHIST.dat

   TLMHIST.dat

   DITHHIST.dat

   orbevents.rdb

   crm_saved_time.dat

4. Code Location and execution
5. Problems and Issues
6. Notes (a) When called with a -b switch, the script will utilize directories within /data/acis-bak rather than /data/acis. (b) To run ACE-update.pl in test mode, copy the contents of /proj/sot/acis/FLU-MON to a test directory
   % mkdir /proj/sot/acis/TST_FLU-MON
   % cp /proj/sot/acis/FLU-MON/*HIST.dat /proj/sot/acis/TST_FLU-MON
   % ACE-update.pl -t /proj/sot/acis/TST_FLU-MON