User's Guide

UPDATEDB

Update AVHRR database records.

Function:

Updates the database records for each image stacked to an AVHRR archive tape.

Parameters:

TAPEID
Tape ID. The identification number of an AVHRR archive tape. The database records for each image stacked to this tape will be updated with the correct tape ID.

LOGFILE(--)
Log file. Name of the file where all of the processing messages will be logged. If defaulted, UPDATEDB;LOG in the ADAPSLOG directory will be used.

Examples:

  1. LAS> updatedb tapeid=es0001

    The [.FORMS] subdirectory of ADAPSARC is searched for the tape summary file ES0001;LIST. If the file is found, the database record of every AVHRR image that was stacked to the tape is updated with the tape ID ES0001. If the file does not exist, an error message is printed.

Description/Algorithm:

The tape summary file for AVHRR archive tape TAPEID is read, and the database record of every AVHRR image that was stacked to the tape is updated with the tape ID. The tape summary file is located in the [.FORMS] subdirectory of ADAPSARC, and is named <xxxxx>;LIST, where <xxxxx> is TAPEID.

The database records for AVHRR archive images are stored in the ADAPSDBTMP directory. UPDATEDB updates the database records with the ID of the tape the image is stored on, and moves them into the ADAPSDB directory. If the database record for an individual scene is not found in the ADAPSDBTMP directory a nonfatal error message is printed.

Nonfatal Error Message:

  1. [updatedb-update] Error updating database record for <xxxxx>

    An error was encountered while attempting to update the database record for the AVHRR archive image <xxxxx>. Ensure the file exists and that the permissions are set appropriately for the file and the directory. See User Note 1.

Fatal Error Messages:

  1. [updatedb-alloc] Error allocating memory

    An error was encountered while dynamically allocating memory. If the error persists, contact the system administrator.

  2. [updatedb-env] Error retrieving <xxxxx>

    UPDATEDB was unable to retrieve the value of the environment variable <xxxxx>. Ensure this variable is set and rerun the function.

  3. [updatedb-fatal] Fatal error encountered

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

  4. [updatedb-open] Error opening <xxxxx> file

    An error was encountered opening the <xxxxx> file. Ensure the file and directory permissions are set appropriately.

  5. [updatedb-read] Error reading summary file

    Ensure the tape summary file is valid. If the file is corrupt, the processing messages in LOGFILE can be used to manually correct the errors. See the ANSISTACK Users Guide for a description of the tape summary file. Rerun this function after the summary file has been corrected.

User Notes:

  1. When AVHRR archive images are stacked to an archive tape their database records are updated. If this function is being run manually to update a single database record, the records for some AVHRR archive images listed in the tape summary file may not exist in the ADAPSDBTMP directory. A nonfatal error message will be issued for these images, and it is up to the user to determine if these messages should be ignored.

  2. The database records stored in the ADAPSDBTMP directory are created by AVHRRDB.

  3. The tape summary files located in the [.FORMS] subdirectory of ADAPSARC are created by the ANSISTACK function.

  4. Related functions are AVHRRDB, ANSISTACK, and AVHRRSTACK.