User's Guide

UPDATESCH

Process to update the master schedule.

Function:

UPDATESCH calls SCHEDIT to incorporate scheduling directives into the master schedule.

Parameters:

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

Examples:

  1. LAS> updatesch logfile="[mydir]mylog"

    UPDATESCH will determine if there are any schedule directive files to process (add, delete, etc.). If there are, it will update the master schedule accordingly.

Description/Algorithm:

UPDATESCH will determine if there are any schedule directive files to process (add, delete, etc.). If there are, it will (1) call SCHEDIT to update the master schedule with these directives, or (2) call the UNIX sort utility to update the master schedule (in the event of a sort schedule directive). Before updating the master schedule, a copy of the current master schedule is made as a back-up. The updated master schedule is also copied to the VAX for scheduling purposes on that system.

Nonfatal Error Message:

    None.

Fatal Error Messages:

  1. [updatesch-dir] Error determining schedule directory

    An error was encountered while determining the directory wherein the schedule files reside. Verify that ADAPSTABLES has been defined.

  2. [updatesch-abrt] User aborted function

    The function was aborted by the user.

  3. [updatesch-schf] Error determining schedule file names

    The schedule file names could not be determined. Contact the system administrator if this error persists.

  4. [updatesch-vaxd] Error defining VAX directory

    An error was encountered while determining the schedule directory on the VAX. Contact the system administrator if this error persists.

  5. [updatesch-purg] Error purging old master schedules on VAX

    An error was encountered while attempting to purge previous master schedule versions on the VAX. Verify that the VAX is accessible.

  6. [updatesch-exe] Error determining executable file

    The SCHEDIT executable cannot be found on the system. Verify that this function is available.

  7. [updatesch-find] Error checking for schedule update files

    An error was encountered while searching for schedule directive files. Ensure that the directory containing the schedule files is accessible.

  8. [updatesch-prof] Error processing schedule update file

    The schedule directive update file was not successfully integrated with the master schedule. Contact the system administrator if this error persists.

  9. [updatesch-copy] Error copying master schedule to VAX

    The master schedule could not be copied to the VAX. Ensure that the VAX is operational and accessible.

  10. [updatesch-purg] Error purging old master schedules on VAX

    Previous versions of the master schedule could not be deleted on the VAX. Ensure that the VAX is accessible.

  11. [updatesch-ldel] Error deleting old local master schedules

    Previous versions of the master schedule could not be deleted on the host system. Verify that the permissions on these files is set properly.

  12. [updatesch-sysm] Must be on edclxs1 to execute UPDATESCH

    This module must be executed on edclxs1 for the scheduling process to complete properly. Restart this module from edclxs1.

  13. [updatesch-fatal] Fatal error encountered

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

User Notes:

  1. The format of the schedule directive file names is as follows:

    cmnd_xxxxxxxxxxxx;sch

    where cmnd is

    add - scenes to be added to the schedule delete - scenes listed by date to be deleted delsid - scenes listed by scene id to be deleted modify - scenes to be modified based on date range modsid - scenes to be modified based on scene id modsta - scenes to be modified based on date range and station sort - indicates the schedule is to be sorted

    and xxxxxxxxxxxx - 12 character time stamp

  2. The format of the master schedule on the local host system is "master;sch". The format of back-up versions of the master schedule on the local host system is "master;sch_xxxxxxxxxxx", where xxxxxxxxxxxx is a 12 character time stamp.

  3. The format of the master schedule and it's back-up versions on the VAX VMS system is "master;sch" with VMS version numbers appended to them.