Acquire AVHRR images from Compact Disk (CD)
Acquire AVHRR images from CD to disk. All images or a specified set of images may be copied.
- 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
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).
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.
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.
A fatal error was encountered. The message displayed prior to this is the actual error encountered.
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.
An error was encountered retrieving the value of the environment or logical variable <xxxxx>. Ensure the variable is set appropriately.
An error was encountered mounting the CD on the specified drive. Ensure that the drive is available.
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.
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.
An error was encountered dismounting the CD on the specified drive. Ensure that the CD is mounted in the drive.
An error was encountered determining the system to write the images to. Ensure that the specified system is accessible.