autosched, schedlist, onlinecat, and passcat are all files in the directory $PASSDIR. autosched and schedlist pertain to scheduling pass reception. onlinecat is the catalog of online passes and passcat is the catalog of archived passes. Each of these files is binary and cannot be edited by typical text editors.
The autosched file contains rules for scheduling passes. Rule records are added, deleted, and modified primarily via the TeraCapCon GUI and autosched functions. The pass scheduling daemon tsched reads the autosched file and determines when to update schedlist, the list of scheduled passes. tsched actually invokes the autosched2 utility function to process autosched file records and update the schedlist file.
The structure of the autosched file is described in the C header file, $TSCANROOT/include/cappcap.h. See the definition of the autorec structure.
schedlist is the list of currently scheduled satellite passes. This file is updated automatically by tsched. It can also be edited via the TeraCapCon GUI or the autosched function. tsched reads the schedlist file to determine when to run pass reception. tsched captures scheduled passes, skipping over passes that cannot be run due to conflicts. tsched deletes schedlist records as they are used.
The structure of the schedlist file is described in the C header file, $TSCANROOT/include/cappcap.h. See the definition of the pcaptrg and the pcapass structures.
onlinecat is the list of received passes currently online. onlinecat records are viewed primarily using the GUI, or the lspass and llpass functions. onlinecat records are numbered 1-relatively. These numbers correspond to the numbers of the pass partitions used to store the actual raw pass data. See BAST.
Each time tsched runs a scheduled pass, tsched adds a corresponding record in the onlinecat, showing 0 lines of data received. When reception of a given pass is complete, its onlinecat record is updated with the true number of data lines received.
onlinecat records contain flags showing the status of pass reception and subsequent automatic archiving. The receiving and archiving processes update these flags at the conclusion of their respective tasks.
onlinecat records can also be created as the result of restoring archived passes to online storage.
The structure of the onlinecat file is described in the C header file, $TSCANROOT/include/catrec.h. See the definition of the CATREC structure.
passcat is the list of archived passes. passcat records are created via archive write, copy, and list operations. This occurs automatically during pass reception if the AutoArchive and Cataloged options are used in the autoschedule records created in TeraCapCon (or if the achive_pass and catalog_pass parameters are set to yes for the autosched function). passcat records can be searched via the TeraCapCon GUI or the listcat function.
The structure of the passcat file is described in the C header file, $TSCANROOT/include/catrec.h. See the definition of the CATREC structure.
tsched reads the autosched file, looking to see if it is time to process any of the records.
If so, tsched invokes the autosched2 utility to process all pending autosched rules and add records to the schedlist file. autosched2 increments the start date for each autosched record it processes.
tsched reads the schedlist file, seeing if any pass start time is nearing the current time.
If so, tsched deletes the record from the schedlist file, adds a corresponding record in the onlinecat file showing zero records received, and spawns the processes necessary to receive the pass.
When the rdframe reception process completes, it updates the onlinecat records showing the true number of data records received.
tsched reads the onlinecat file, seeing if there are any newly received passes that are to be automatically archived.
If so, and there are other automatic archive jobs in progress, tsched spawns autoarchive.
autoarchive adds a record in the passcat file for the pass that is being archived. Also, autoarchive updates the onlinecat record, indicating either success or failure.
Last Update: $Date: 2001/12/12 19:26:55 $