User's Guide

AUDITSCH

Audit the master schedule file

Function:

Audit the master schedule file to determine if any processing is required.

Parameters:

CEOSIDS("SFL")
CEOS id's. CEOS id's to consider when examining the logs to determine when scenes have been locally acquired. This will usually be set to "SFL" only (live acquisitions). However, if DOMSAT scenes are being acquired via satellite dish as opposed to FTP, then "NOA" and "NGC" should be specified as well.

TIME_DELETE(80)
Delete time. Time (in hours from scene acquisition time) to wait before deleting a scene from the master schedule.

TIME_MISSED(26)
Missed time. Time (in hours from scene acquisition time) to wait before marking a scene as missed in the master schedule.

TIME_ACQUIRE(60)
Acquire time. Time (in minutes from scene acquisition time) to wait before checking if a local acquisition has occurred.

LOGFILE(--)
Log file. Name of the log file to write all processing messages to. If defaulted, "auditsch" within the ADAPSLOG directory will be used. LOGFILE will have a ;log extension.

Example:

    LAS> AUDITSCH LOGFILE="[somedir]auditsch"

    AUDITSCH will read a copy of the master schedule to determine if any processing is appropriate. Processing messages and errors will be written to "[somedir]auditsch;log".

Description/Algorithm:

AUDITSCH makes a copy of the master schedule. This schedule is examined to determine if any processing needs to be accomplished as follows: (1) If a scene in the schedule is old enough to delete from the schedule, generate a "delete file" to be used to update the master schedule accordingly. If the scene to delete is a missed scene, print a warning message. (2) If a scene in the schedule is old enough to be marked as missed (cannot possibly acquire this scene anymore), generate a "modify file" to be used to update the master schedule accordingly. (3) If a scene in the schedule is old enough to be acquired and is a local acquisition, determine if it has been acquired by looking in the ingest logs. If it has, generate a "modify file" to be used to update the master schedule accordingly. Processing messages and error messages are written to LOGFILE.

Nonfatal Error Messages:

  1. [auditsch-delm] WARNING: Deleting missed scene from schedule

    A scene that was never acquired is being deleted from the schedule. This is only a diagnostic tool, no action is required.

Fatal Error Messages:

  1. [auditsch-sysm] Must be on edcsgs20 to execute AUDITSCH

    This procedure must only be executed on edcsgs20. Log onto edcsgs20 to execute this procedure.

  2. [auditsch-lis] Error generating master schedule copy

    A copy of the master schedule could not be made. Ensure that the master schedule exists with the proper file permissions.

  3. [auditsch-pro] Error processing master schedule copy

    An error occurred while processing the master schedule. Refer to the specific error message prior to this one.

  4. [auditsch-dels] Error deleting copy of master schedule

    The copy of the master schedule could not be deleted. Contact the system administrator if this error persists.

  5. [auditsch-time] Invalid time parameter specified

    An invalid time was specified in one of the parameters. The value for TIME_DELETE cannot be less than the value of TIME_MISSED and the value of TIME_ACQUIRE cannot be less than the value of TIME_MISSED. Respecify the offending time value.

  6. [auditsch-fatal] Fatal error encountered

    A fatal error was encountered, refer to the message preceding this message for more details.

User Notes:

  1. Toggling between DOMSAT acquisition systems:

    Using the local DOMSAT dish:

       - Must have the two INHALE processes running on VAXH.
       - Run AUDITSCH with CEOSIDS=SFL,NGC,NOA.
         This will enable the software on edcsgs20 to look in the ingest logs
         to determine when live and DOMSAT scenes have been acquired on VAXH
         (and generate schedule directive files to update the master schedule
         to signify the scenes have been acquired).
       - Run NOAAFTP with TIME_ACQ=180 minutes or more.  Extending this time
         will prevent NOAAFTP from downloading scenes before they get
         transmitted to the DOMSAT dish (NOAAFTP should only be downloading
         MISSED acquisitions when utilizing the DOMSAT dish).
       - When scheduling run XSCHED with the domsat flag as follows: 
    	 xsched printer1 printer2 domsat
         This allows the schedule to be pushed to vaxh.
    

    Using the ftp link to the NOAA server:

       - Must NOT have the two INHALE processes running on VAXH.
       - Run AUDITSCH with CEOSIDS=SFL.  When NOAAFTP downloads a scene from
         the server, it will generate a schedule directive file (to update
         the master schedule to signify the scene has been acquired).
         AUDITSCH only needs to look in the log files for SFL scenes to
         determine when they have been acquired.
       - Run NOAAFTP with TIME_ACQ=60 minutes (start looking for NGC scenes,
         NOA scenes, missed SFL scenes on the NOAA server 1 hour after their
         acquistion time).
       - When scheduling run XSCHED without the domsat flag as follows: 
    	 xsched printer1 printer2
         This prevents the schedule from being pushed to vaxh.