Acquire AVHRR images from tape
Acquires AVHRR images from tape to disk. A sequential or random set of images may be copied.
- TAPEID
- Tape ID. The library identification code of the tape(s) containing the desired images. Multiple tapes are to be specified only if a tape drive equipped with an automatic tape stacking device is used.
- 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
- Acquire year. The last two digits of the year in which the data was acquired.
- START(1 VALID=1:900)
- Starting image number. The first image to be read from tape.
- STOP(-- VALID=1:900)
- Stopping image number. The last image to be read from tape. If NULL, all images will be read from tape.
- DSTDIR(ADAPSACQ VALID=(ADAPSACQ,ADAPSPROD)
- Destination directory. The directory in which the acquired images will be placed. The directory specification must be an environment variable.
= ADAPSACQ: The ADAPS 'acquire' directory = ADAPSPROD: The ADAPS 'products' directory
- TAPEID
- Tape ID. The library identification code of the tape(s) containing the desired images. Multiple tapes are to be specified only if a tape drive equipped with an automatic tape stacking device is used.
- 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
- Acquire year. The last two digits of the year in which the data was acquired.
- IMAGENUM
- Image number(s). Numbers of the images to be read from tape.
- DSTDIR(ADAPSACQ VALID=(ADAPSACQ,ADAPSPROD)
- Destination directory. The directory in which the acquired images will be placed. The 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 tape 038591. The specified tape was created by the NMY receiving station. The images were acquired in 1992. A sequential set of images are acquired from tape starting with the fourth image on the tape and ending with the last image on the tape. All the images will be placed in the ADAPSACQ directory.
A request is sent to the operators to mount tape km1004. The specified tape was created by the LSU receiving station. The images on this tape were acquired in 1992. Only the second image on the tape will be read and placed in the ADAPSPROD directory.
In this example it is assumed that the user has arranged to have the three tapes km1000, km1001, and km1006 mounted in an automatic tape stacker. A request is sent to the operators to mount the first tape and it is assumed the next two tapes will be automatically mounted on the same tape drive when the previous tape is dismounted. The three tapes were created by the LSU receiving station. The images on these tapes were acquired in 1992. All images will be acquired from each tape.
A request is sent to the operators to mount tape 038591. The specified tape was created by the NMY receiving station. The images were acquired in 1992. The first, fourth, fifth, and ninth images are acquired from tape. All of the images will be placed in the ADAPSACQ directory.
A request is sent to the operators to mount tape km1004. The specified tape was created by the LSU receiving station. The images on this tape were acquired in 1992. Only the second image on the tape will be read and placed in the ADAPSPROD directory.
The tape containing the images to be acquired is defined by a tape ID and CEOS station ID. Valid station IDs are contained in the "station;ids" table located in the ADAPSTABLES directory.
Each image is first read into a temporary file in the DSTDIR directory; when the entire image is acquired from tape, it is renamed. The final image names are of the form a<tape 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 images before they are completely copied from tape.
Image number <xxx> is a partial tar file.
TPACQUIRE was unable to successfully release the tape drive. Run RELDRIVE to release the tape drive.
An unknown CEOS ID is <xxx>. Ensure the ID was entered correctly.
An error was encountered retrieving the value of the environment or logical variable <xxxxx>. Ensure the variable is set appropriately.
A fatal error was encountered. The message displayed prior to this is the actual error encountered.
An error was encountered forward skipping a file on tape. Ensure that there are the specified number of images on the tape.
Parameter <xxxxx> must be <yyy> characters in length. Ensure the specified parameter was entered correctly.
TPACQUIRE was unable to locate the command <xxxxx>. Ensure the appropriate directories are in the TAE global variable $APLIB.
An error was encountered reading image number <xxx> from tape. Ensure the tape contains the expected number of images.
Remote tape drives are not allowed for CEOS ID <xxx> when TPACQUIRE is being run from the current computer system. Use a tape drive on the current system or consult User Note 1.
TPACQUIRE must be run on a UNIX system.
The user aborted TPACQUIRE with <ctrl-c>.
Change tape and press the Enter key:
If it does appear, type <ctrl-c> to go on to the next image. You will then have 10 seconds to type another <ctrl-c> to abort TPACQUIRE, if desired. This message appears due to an invalid tar file header record. A resulting tar file will remain on disk and may be incomplete.