User's Guide

LOADSILO

Transfer scenes from AVHRR archive tapes to the silo.

Function:

Transfer multiple scenes from archive tape to the silo. Multiple tapes may be processed using a tape stacker.

Parameters:

INFILE
Input file. The name of the file containing scenes to load. See user note 3 for file format.

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.

COPYFLG
Copy flag. Flag indicating whether to copy the scene unconditionally, to copy only if the file doesn't already exist on silo, or to delete files on silo before copying.

    UCOPY - Unconditional copy
    CCOPY - Conditional copy
    DCOPY - Delete before copy

Examples:

  1. LAS> loadsilo infile="loadsilo.list" ntapes=5 drive=4 copyflg=dcopy

    Tape drive 4 has been loaded with 5 tapes. The list of scenes and their corresponding tapeids and time stamps are in the file "loadsilo.list". If scenes already exist in the UCFM with the same 16-digit scene id as those in the list, they will be deleted.

  2. LAS> loadsilo infile="process.list" copyflg=ucopy

    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. The scenes contained in the process list will be unconditionally copied to UCFM.

  3. LAS> loadsilo infile="loadsilo.list" ntapes=5 drive=4 copyflg=ccopy

    Tape drive 4 has been loaded with 5 tapes. The list of scenes and their corresponding tapeids and time stamps are in the file "loadsilo.list". If individual scenes already exist in the UCFM, those scenes will not be read from tape nor copied to the UCFM.

Description/Algorithm:

If the copy flag is either CCOPY or DCOPY, the UCFM is checked for existance of scenes that match the 16-digit scene id of those listed in the input file. The scenes are either deleted from UCFM or edited from the input list.

A working directory is created to which scenes will be placed when read from tape. A loadsilo daemon is started that will look in the working directory and copy any scene found to its appropriate location in the UCFM. LOADLIST is then called to read files found in the input list and place them in the working directory. Once LOADLIST has completed and all files in the working directory have been processed, the loadsilo_daemon is stopped and the directory removed.

Nonfatal Error Messages:

  1. [loadsilo-wrk] Working directory not removed

    The working directory was not empty and could not be removed. Check for errors from the LOADSILO_DAEMON. The files remaining may be manually moved to UCFM and the working directory removed.

Fatal Error Messages:

  1. [loadsilo-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.

  2. [loadsilo-fetch] Error occurred fetching from list

    An error occurred retrieving sceneids, tapeids, or time stamps from the input list file. Check that the input file exists and that is's in the proper format.

  3. [loadsilo-find] Error occurred determining files on silo

    An error occurred while finding files on the UCFM. Contact the system administrator.

  4. [loadsilo-mkdir] Error creating working directory

    An error occurred trying to create a working directory. Check that the user has permission to write to the $ADAPSPROD directory.

  5. [loadsilo-daemon] Error starting the loadsilo_daemon

    An error occurred starting the loadsilo_daemon. Contact the system administrator.

  6. [loadsilo-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. A means to gracefully terminate LOADSILO prematurely is available. If the file "loadsilo<XXXXX>.stop" exists, where XXXXX is a process ID generated by LOADSILO, in the ADAPSTABLES directory, LOADSILO will terminate when it finishes processing the tape it is currently processing. This file should be removed once the LOADSILO session has terminated. The PID for the instance is printed in the session log.

  2. A related routine is LOADSILO_DAEMON.

  3. The first time LOADSILO is run with either CCOPY or DCOPY with a specific input list, all files in the list are checked for existance on UCFM. When the same list is used on subsequent LOADSILO runs, it is not necessary to use CCOPY or DCOPY again. Using UCOPY is adequate and faster for later runs.
  4. The input file must be in the following format:

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

    The first line is a comment line and may be followed by any number of lines containing the tapeid, sceneid, time stamp and process flag. The process flag must be 'N' for the file to be copied.

  5. When processing is complete the input file may be viewed to see which files were processed. Those with a 'Y' were copied and those with a 'X' were eXcluded from being copied. An 'N' indicates the file was not processed.