User's Guide

ORBREAD

Retrieve scenes from the silo for orbital stitching.

Function:

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.

Parameters:

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.

Examples:

  1. LAS> orbread infile=scenes.dat strscene=al11063092130017 logfile=mylog

    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.

  2. LAS> orbread infile=scenes.dat endscene=al11052293130017

    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.

Description/Algorithm:

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.

Nonfatal Error messages:

  1. [orbread-warn] Nonfatal error encountered

    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.

  2. [orbread-pre] Processing partial orbit following STRSCENE

    The specified starting scene ID STRSCENE excludes one or more scenes in the half orbit. Consequently, a partial orbit will be created.

  3. [orbread-end] Processing partial orbit preceding ENDSCENE

    The specified ending scene ID ENDSCENE excludes one or more scenes in the half orbit. Consequently, a partial orbit will be created.

  4. [orbread-clos] Error closing <XXXXXX> file

    An error was encountered while trying to close the specified file. If this error continues to occur, contact the system administrator.

  5. [orbread-dup] Duplicate scene specified

    A scene was specified more than once in the input file. Duplicate entries will be ignored.

Fatal Error messages:

  1. [orbread-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.

  2. [orbread-open] Error opening <XXXXXX> file

    The specified file does not exist or does not have the proper file permissions set.

  3. [orbread-conv] Error converting line buffer data

    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).

  4. [orbread-exe] Error returned from half orbit grouping

    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).

  5. [orbread-sread] Error reading a scene to stitch

    An error reading a scene from the UCFM occurred. A networking fault may have caused this error; try to reprocess.

  6. [orbread-rparm] Error returning parameter to TAE

    An error was encountered while trying to return a parameter to TAE. Contact the system administrator.

  7. [orbread-cach] Error requesting a scene to cache

    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.

  8. [orbread-dcon] Error converting date

    An error occurred while converting a scene acquisition date to a julian date. Check the input file for invalid acquisition dates.

  9. [orbread-envron] Error retrieving <XXXXXX>

    An error occurred while trying to retrieve the specified environment variable. Make certain the variable has been assigned a value.

  10. [orbread-read] Error reading line in input file

    An error occurred trying to read a line in the stitch list file. Verify that the file exists with the proper permission.

  11. [orbread-ftp] UCFM/FTP not operational

    The File Transfer Protocol is unable to communicate with the UCFM file system. Contact the system administrator.

  12. [orbread-dspace] Error determining the disk space

    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.

  13. [orbread-spac] Insufficient disk space available, wait

    There is not enough disk space available in the ADAPSORB/lndetect directory to initiate ORBREAD. Make sufficient space available and retry.

  14. [orbread-sfil] Error determining the stop file

    An error occurred while attempting to determine the name of the stop file. Verify that the environment variable ADAPSTABLES has been defined.

  15. [orbread-updt] Error updating list for <XXXXX>

    An error occurred while attempting to update the orbital stitch list. Verify that the list has not been corrupted.

User Notes:

  1. The expected format of the input file is as follows:

    
    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.

  2. The input file is generated by LISTITCH or is a data base listing of scenes on archive tape.

  3. ORBREAD will not acquire an input scene from archive tape, only from the UCFM. ORBLOAD should be used to acquire input scenes from archive tape.

  4. Refer to the orbital stitching overview for more detailed information.