User's Guide

TAPE2SILO

Copy AVHRR archive images from tape to the UCFM.

Function:

Copies AVHRR archive images from an archive tape to the silo Central File Manager (UCFM).

Parameters:

TAPEID
Tape ID. Tape library identification number for the tape that contains the desired image(s).

SCENEID("*")
Scene ID. Scene identifier(s) of the AVHRR archive image(s) on tape. The default is to read all of the images on the tape.

DRIVE(--)
Tape drive. The name of the device on which the tape is mounted. If a drive is specified, it is assumed that the tape has already been mounted on the drive, and the tape will not be dismounted after the images have been read, unless specified differently by RELFLG. If defaulted to NULL, the operator will be prompted to mount the tape, and the tape will be dismounted after the images have been read.

RELFLG(NO VALID=(YES,NO)
Release flag. The flag indicating whether or not to release the tape drive upon completion. If the flag is not specified, the drive is dismounted. Note that if DRIVE is defaulted to NULL, the tape will be dismounted regardless of the value of RELFLG.

  = YES: Release tape drive
  = NO:  Don't release tape drive

Examples:

  1. LAS> tape2silo tapeid=k12345 sceneid=ah11060293223145

    The operator will be prompted to mount tape K12345. The specified image is retrieved from the tape and written to the UCFM as "AH11060293223145_<XXXXXX>.AHDR" and "AH11060293223145_<XXXXXX>.ARCH", where <XXXXXX> is the current time. The image is written to "/dmf/edc/avhrr/sat11/month06/day02/".

  2. LAS> tape2silo tapeid=k33221 sceneid=(ah1105*,ah1106*) drive="edcsgs4@2"

    All images on tape K33221 that match the SCENEID wild-card specification are read from tape to disk, copied to the UCFM, and then deleted from disk. Since the drive has been specified, the tape has already been mounted.

Description/Algorithm:

The images are read from the specified tape into the ADAPSPROD directory on disk. The current time stamp is appended to each image's scene ID in order to create a unique file name (in the event the image is read in multiple times). The images are then copied to the UCFM. The directory to which the image is copied depends on the satellite number, acquisition month, and acquisition day of the image. The general directory structure is "/dmf/edc/avhrr/satSS/monthMM/dayDD/" where SS is the two-digit satellite number, MM is the two-digit month, and DD is the two-digit day. After each image is copied to the UCFM, it is deleted from the ADAPSPROD directory. Processing messages are appended to "TAPE2SILO.LOG" in the ADAPSLOG directory.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [tape2silo-vms] Unsupported system

    Silo interface functions are not supported on VMS systems.

  2. [tape2silo-sym] Error retrieving ADAPSLOG

    The directory in which to write the log file cannot be determined. Make certain ADAPSLOG has been defined.

  3. [tape2silo-nof] No files found

    The specified image(s) were not found on the tape and consequently cannot be processed. Examine the tape to determine its contents.

User Notes:

  1. TAPE2SILO calls READARCH to read the images from tape and COPYSCENE to copy the images to the UCFM.

  2. A maximum of 20 image specifications from one tape may be specified (including wild-cards). A maximum of 20 images may be copied at one time.