User's Guide

REBROWSE

Regenerate browse images from archived images

Function:

Regenerate browse images from archived images.

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.

Examples:

  1. LAS> rebrowse infile="rebrowse;list" ntapes=5 drive=4

    Tape drive 4 has been loaded with 5 tapes. The list of scenes and their corresponding tapeids and time stamps are in the file "rebrowse;list".

Description/Algorithm:

A working directory is created to which scenes will be placed when read from tape. A rebrowse daemon is started that will look in the working directory and create the browse images as scenes are read from tape. 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 REBROWSE_DAEMON is stopped and the directory removed.

Nonfatal Error Messages:

  1. [rebrowse-wrk] Working directory not removed

    The working directory was not empty and could not be removed. Check for errors from the REBROWSE_DAEMON.

Fatal Error Messages:

  1. [rebrowse-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. [rebrowse-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 it is in the proper format.

  3. [rebrowse-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.

  4. [rebrowse-daemon] Error starting the rebrowse_daemon

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

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

  2. A related routine is REBROWSE_DAEMON.

  3. 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 browse image to be created.

  4. When processing is complete the input file may be viewed to see which files were processed. Those with a 'Y' had browse images created. An 'N' indicates the file was not processed.