User's Guide

(Part of READARCH)

Function:

Part of READARCH. READSTACK can be used to read all of the AVHRR archive images stored on the tapes loaded in an automatic tape stacker. The user may mount between 1 and 14 tapes. All images are placed in OUTDIR.

Parameters:

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

OUTDIR(--)
Destination directory. Directory where the AVHRR archive images should be placed. If NULL, OUTDIR will default to $ADAPSPROD.

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.

Example:

  1. LAS>readstack ntapes=12 outdir=[images] drive=--

    A stacker drive will be requested with 12 tapes. READSTACK will cycle through the tapes and copy all of the images to the images directory.

Description/Algorithm:

Cycle through the NTAPES and copy the images contained on the tapes to the OUTDIR directory.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [readstack-fatal] Fatal error encountered

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

  2. [readstack-drv] Error detecting BOT status on drive

    The "beginning of tape" status was not found. If the error persists, contact the system administrator.

User Notes:

    None.