User's Guide

LOADLIST

Load selected images from tape based on input list.

Function:

Images listed in the input file are read from tape and placed in the output directory.

Parameters:

INFILE
Input file. The name of the list containing the images to load. (See user note 1.)

OUTDIR
Output directory. The directory where the loaded images will be placed.

NTAPES(14)
Number of tapes. The number of tapes loaded in the automatic tape stacker on DRIVE.

DRIVE(--)
Tape drive. The name of the device on which the tape has already been mounted. If NULL, a mount request will be sent to the operator.

LOGFILE
Log filename. The name of the file where all log messages are to be written.

Examples:

  1. LAS> loadlist infile="stitch;list" outdir="[workingdir]" ntapes=5 drive=4 stopfile="loadsilo;stop" logfile="loadsilo;log"

    Tape drive 4 has been loaded with 5 tapes. The list of scenes and their corresponding tapeids and time stamps are in the file "stitch;list". Scenes listed in the input file will be placed in "[workingdir]". The procedure will look for the stopfile "loadsilo;stop" and will terminate and remove the file if it finds it. All messages will be placed in the file "loadsilo;log".

  2. LAS> loadlist infile="stitch;list" outdir="[workingdir]" stopfile="loadsilo;stop" logfile="loadsilo;log"

    Since NTAPES has not been specified, it is assumed that 1 tape is to be processed. Since a tape drive has not been specified, a prompt to mount a tape will be issued. Scenes listed in the input file will be placed in "[workingdir]". The procedure will look for the stopfile "loadsilo;stop" and will terminate and remove the file if it finds it. All messages will be placed in the file "loadsilo;log".

Description/Algorithm:

If no drive has been specified, a tape mount request is made and number of tapes set to one otherwise tapes are mounted from the stacker one at a time. Once a tape has been mounted the tapeid is determined and the sceneids for that tape are obtained from the input list. READARCH is called with the list of sceneids. The scenes are placed in the working directory.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [loadlist-getd] Error mounting tape or stacker

    An error occurred while mounting a tape from GETDRIVE. Contact the system administrator.

  2. [loadlist-sfil] Error determining the stop file

    An error determining the name of the stop file or the existence of the stop file was encountered. Contact the system administrator.

  3. [loadlist-ustop] "LOADLIST terminated by user

    The stopfile specified by the user was detected. Processing was terminated.

  4. [loadlist-tpid] Error determining the tape ID

    ARCHDR was unable to determine the tapeid. Insure that the tape is a labeled archive tape.

  5. [loadlist-scen] Error determining the scenes to process

    An error occurred fetching scenes from the input file. Make sure the input file exists and is in the proper format.

  6. [loadlist-read] Error reading the scene from tape <XXXXXX>

    An error occurred reading from tape, tapeid <XXXXXX>. The message preceding this one indicates the type of problem encountered.

  7. [loadlist-drv] Error dismounting tape from drive

    An error was encountered while attempting to rewind and dismount the tape. If the tape was not dismounted properly contact the system administrator.

  8. [loadlist-bot] Error detecting BOT status on drive

    An error occurred detecting the beginning of tape in CKDRIVE. Contact the system administrator.

  9. [loadlist-fatal] Fatal error encountered

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

User Notes:

  1. The load status listing is one scene per line with storage location (tape ID), scene ID, time stamp and load flag. The order is significant. An optional header may be included. If the header is present it must start with the word tape_id in column 1. Leading zeros for tape ID's and time stamps are not required. The process flag must be 'N' for the file to be copied.

    Example:

        tape_id scene_id       t_stamp N
        110262 AH11112392132652 132449 N
        132711 AH14052597050000 105252 N
        137978 AL14091297082613 050709 N