Retrieve scenes from the silo for orbital stitching.
Read an orbital stitch list and ensure that all of the input scenes arrive on disk at the appropriate time. Each scene within a half orbit that does not already reside on disk is retrieved from the silo so that it can be stitched into a half orbit.
- INFILE
- Input file. The file containing the list of orbital stitching information. Refer to User Note 1 for the format of this file.
- STRSCENE(--)
- Starting scene ID. The scene ID within INFILE at which processing should begin. If STRSCENE is not found within INFILE, no scenes will be processed. If unspecified, processing will begin at the first scene ID in INFILE.
- ENDSCENE(--)
- Ending scene ID. The scene ID within INFILE at which processing should end. If ENDSCENE is not specified or the specified ID is not found within INFILE, processing will continue to the end of INFILE.
- LOGFILE(--)
- Log file. Name of the log file that the processing messages will be appended to. The default is orbread.log in ADAPSLOG.
The input file is read and all of the scenes within the file starting at AL11063092130017 are read from the silo. The generated log file "mylog.log" resides in the current working directory.
Processing will begin with the first scene in the input file and continue until the scene "AL11052293130017" has been processed, or until the end of the input file is encountered. All of the scenes are grouped into orbits, and then read onto disk if not already there. Since the log file name has not been specified, it will be named "orbread.log" and will reside in the ADAPSLOG directory.
The specified input file is read to determine which scenes are to be stitched into half orbits. If a scene does not already exist on disk but does exist on the UCFM, it will be retrieved from the UCFM. However, ALL of the input scenes within a half orbit must reside either on disk or on the UCFM before ORBREAD will begin to transfer scenes to disk. In the event of an error transferring a scene from the UCFM, three attempts will be made before displaying an error message and quitting. Requests to stage the scenes from UCFM tape into cache memory are issued ahead of the calls to transfer the scenes from cache memory onto the host system. If a scene does not exist on disk or the UCFM, the scene will NOT be acquired from archive tape by ORBREAD.
A nonfatal error was encountered during processing. The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing will continue.
The specified starting scene ID STRSCENE excludes one or more scenes in the half orbit. Consequently, a partial orbit will be created.
The specified ending scene ID ENDSCENE excludes one or more scenes in the half orbit. Consequently, a partial orbit will be created.
An error was encountered while trying to close the specified file. If this error continues to occur, contact the system administrator.
A scene was specified more than once in the input file. Duplicate entries will be ignored.
A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.
The specified file does not exist or does not have the proper file permissions set.
A buffer of data read from INFILE is not in the expected format. Investigate the data in the specified input file (see User Note 1 for input file format).
An error was encountered reading the input file and determining which scenes are part of a half orbit. Verify that the specified input file has not been corrupted (see User Note 1 for input file format).
An error reading a scene from the UCFM occurred. A networking fault may have caused this error; try to reprocess.
An error was encountered while trying to return a parameter to TAE. Contact the system administrator.
An error was encountered while trying to issue a command to copy a scene from UCFM tape into cache memory. Make certain the scene exists on the UCFM.
An error occurred while converting a scene acquisition date to a julian date. Check the input file for invalid acquisition dates.
An error occurred while trying to retrieve the specified environment variable. Make certain the variable has been assigned a value.
An error occurred trying to read a line in the stitch list file. Verify that the file exists with the proper permission.
The File Transfer Protocol is unable to communicate with the UCFM file system. Contact the system administrator.
An error occurred while trying to determine if a stop file exists in the ADAPSTABLES directory. Verify that the environmental variable ADAPSTABLES has been defined.
There is not enough disk space available in the ADAPSORB/lndetect directory to initiate ORBREAD. Make sufficient space available and retry.
An error occurred while attempting to determine the name of the stop file. Verify that the environment variable ADAPSTABLES has been defined.
An error occurred while attempting to update the orbital stitch list. Verify that the list has not been corrupted.
tapeid mth acqdate start stop ceos st d a source flg 031185 AH 04/01/92 5332 10408 NGC 11 D A 31376 019990 AH 04/01/92 34636 35718 HBT 11 D A 37446 020403 AH 04/01/92 35703 40438 TSV 11 D A 38496 031272 AL 04/01/92 41800 42906 NOA 11 D A 31435 019990 AH 04/01/92 52626 54118 HBT 11 D A 37447 020403 AH 04/01/92 53416 54728 TSV 11 D A 38497 . . . . . .The header is read until the line beginning with "tapeid" has been encountered. Valid lines of data are expected following this line.