User's Guide

CDACQUIRE

Acquire AVHRR images from Compact Disk (CD)

Function:

Acquire AVHRR images from CD to disk. All images or a specified set of images may be copied.

Parameters:

CDID
CD Identifier. The library identification code of the CD containing the desired image(s).

DRIVE
Drive name. The drive name that the operator is to mount the CD onto. A host name may be included, but is not required (i.e. "edcsgs4@cd1"). If a host name is include, it must be the local host name (cross-mounting is not supported by this routine).

CEOSID
CEOS ID. A Committee on Earth Observing Satellites (CEOS) three character alphanumeric identification code identifying the receiving station that acquired the AVHRR data.

YEAR
Acquisition year. The last two digits of the year in which the data was acquired.

FILENAME("*")
File name specification. The name(s) of the AVHRR images to be copied from Compact Disk. Wild cards are allowed.

DSTSYS(--)
Destination system. The system to which the AVHRR images will be copied. If defaulted, the local host system will be used.

DSTDIR(ADAPSACQ VALID=(ADAPSACQ,ADAPSPROD)
Destination directory. The directory in which the acquired images will be placed. This directory specification must be an environment variable.


  = ADAPSACQ:  The ADAPS 'acquire' directory
  = ADAPSPROD: The ADAPS 'products' directory

Examples:

  1. LAS> cdacquire cdid="km1234" drive="sg1@cd1" ceosid=bjg year=98 dstsys="edcsgs4" dstdir=adapsprod

    A request is sent to the operators to mount CD "km1234". The CD was created by the BJG receiving station. The images were acquired in 1998. All of the images on the CD will be read and placed in the ADAPSPROD directory on "edcsgs4" (FILENAME was allowed to default).

  2. LAS> cdacquire cdid="km4321" drive="cd1" ceosid=ykt year=96 filename="hp060414;1b"

    A request is sent to the operators to mount CD "km4321". The specified CD was created by the YKT receiving station. The images on this CD were acquired in 1996. Only the "hp060414;1b" image on the CD will be read and placed in the ADAPSACQ directory of the sg1 disk.

Description/Algorithm:

A Compact Disk is mounted onto the specified drive. Each image to be processed is first read into a temporary file within the DSTDIR directory of the DSTSYS sytem; when the entire image has been acquired from CD, it is renamed using the following syntax:

a<6-digit CD ID><2-digit year>fn<image number>;<CEOS ID>.
This temporary naming scheme prevents the AVHRR Data Acquisition and Processing System (ADAPS) from processing the image before it is completely copied from CD. Once all of the appropriate images have been acquired from CD, the CD is dismounted from the drive.

Nonfatal Error Messages:

    None

Fatal Error Messages:

  1. [cdacquire-fatal] Fatal error encountered

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

  2. [cdacquire-bdr] Invalid drive specification <xxxxx>

    If the drive specification includes a host system, i.e. "edcsgs4@cd1", the host system must be the local host system (cross-mounting is not supported by this routine). Make certain the specified drive exists.

  3. [cdacquire-env] Error retrieving <xxxxx>

    An error was encountered retrieving the value of the environment or logical variable <xxxxx>. Ensure the variable is set appropriately.

  4. [cdacquire-mnt] Error mounting input CD

    An error was encountered mounting the CD on the specified drive. Ensure that the drive is available.

  5. [cdacquire-cpy] Error copying scene from CD

    An error was encountered copying a scene from CD to disk. Ensure that the DSTDIR directory exists on the DSTSYS system with the proper permissions.

  6. [cdacquire-rnm] Error renaming scene on disk

    An error was encountered renaming a scene from it's temporary file name to it's final file name. Make certain that the file name does not already exist.

  7. [cdacquire-umt] Error dismounting the input CD

    An error was encountered dismounting the CD on the specified drive. Ensure that the CD is mounted in the drive.

  8. [cdacquire-sys] Error determining destination system

    An error was encountered determining the system to write the images to. Ensure that the specified system is accessible.

User Notes:

  1. Compact Disks may be mounted on local drives only. However, files may be copied to local or remote disk space.

  2. A related module is TPACQUIRE, used to acquire AVHRR scenes from tape instead of CD.