User's Guide

BRWREAD

Read AVHRR browse images from archive tape

Function:

Read AVHRR browse images from archive tape

Parameters:

TAPEID
Tape identifier. The identification label number of the tape to be mounted.

OUTDIR
Output directory. The directory in which to place the AVHRR browse images and directory structure.

CDDIR
CD directory. The directory in which to place the AVHRR browse images and directory structure to make the CD.

LOGFILE
Log file. The file to which processing messages will be written. LOGFILE will have a ";log" extension.

Examples:

  1. LAS> brwread tapeid=km1234 outdir=[dir1.dir2] cddir=[dir1.dir2.cd] logfile=logf

    A request is sent to the operators to locally mount the tape km1234. The directory structure and AVHRR browse images are extracted from tape into the directory "[dir1.dir2]". The files and directory structure are moved to CDDIR to remove the upper-case naming in the path name. Messages are logged in LOGFILE.

Description/Algorithm:

A tape containing AVHRR browse images is mounted on a tape drive. BRWREAD goes into the directory specified by OUTDIR. The images are extracted from the tape using the UNIX "tar" utility. The entire directory structure below OUTDIR is moved to CDDIR to remove the upper-case names from the directory path. BRWREAD returns to the original working directory and the tape is dismounted. Messages are logged in LOGFILE.

Nonfatal Error Messages:

    None

Fatal Error Messages:

  1. [brwread-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed prior to this is the actual error encountered.

  2. [brwread-env] Error retrieving destination directory

    An error was encountered while attempting to determine the destination directory. Ensure that the environment variable ADAPSMIC has been defined.

  3. [brwread-dir] Error changing directories

    An error changing directories was encountered. Ensure that the directory specified by OUTDIR exists with the proper permissions.

  4. [brwread-drv] Error allocating a tape device for <XXXXXX>

    An error occurred while allocating a tape drive. Retry executing the program.

  5. [brwread-tar] Error extracting tar information from <XXXXXX>

    An error occurred extracting the information from the tape. Ensure that the tape is a "tar" format tape.

  6. [brwread-rel] Error releasing tape drive for <XXXXXX>

    An error occurred releasing the tape drive. Examine the data extracted from the tape to ensure that it is complete.

User Notes:

  1. The format of the "tar" AVHRR browse image file is as follows:

    
        ./diskpack/year/month/day/sourcelink.1KM
    
        where
    	diskpack   is the disk pack
    	year       is the year of acquisition
    	month      is the month of acquisition
    	day        is the day of acquisition
    	sourcelink is the data base source link
    
        for example:
    
        ./HD02/1996/04/08/00140228.1KM
    
    

    The "diskpack" portion of the pathname is eliminated since upper-case names are not handled well by TAE.