Determine the type of an AVHRR archive tape.
Determine the format of an AVHRR archive tape. This function will examine the first two files of a tape to determine the AVHRR archive tape type. The tape identification number and the type of tape are returned in TAE string parameters.
- DRIVE
- Tape drive. Tape drive that the tape is currently mounted on.
- TAPEID
- Tape ID. The six character tape identification number of the tape mounted on DRIVE will be returned in the specified TAE string variable.
- TAPETYPE
- Tape type. The type of tape mounted on DRIVE will be returned in the specified TAE string variable. One of the following values will be returned.
= ANSINEW: The newest version of the AVHRR archive tapes. Each image is stored as a header file and an image file. = ANSIOLD: Each image is stored as a single file on the tape. = EA1: Each image is stored as a single file with a block size of 65024. = EA2: Each image is stored as a single file with a block size of 32768. = JULIAN: Each image is stored as a single file with a 15 character scene ID.
The first two files of the tape that is mounted on drive three will be examined to determine its type and identification number. The identification number will be returned in the TAE string variable TAPE and the tape type will be returned in the string variable TTYPE.
The first two files of the tape that is mounted on drive edcsgs4@1 will be examined to determine its type and identification number. The identification number will be returned in the TAE string variable TAPE and the tape type will be returned in the string variable TTYPE.
The tape currently mounted on DRIVE will be examined to determine its AVHRR archive format. There are five different tape formats within the AVHRR archive. Every tape contains a label indicating the tape identification number. This identification number is extracted and returned in the TAE string variable specified by TAPEID.
Tapes identified as ANSINEW may contain any number of AVHRR images stored as two files. The first file is a header file containing orbital information and the second file is the raw image data received from the satellite. The name of every header file will begin with an 'h' and the name of every image file will begin with an 'i'. Tapes identified as ANSIOLD may contain any number of AVHRR images stored as a single file. These files are blocked at either 65024 or 32768 and their names all begin with an 'a'. Tapes identified as EA1 and EA2 will contain one AVHRR image stored as a single file. These tapes do not contain the image name. The distinguishing factor is that EA1 tapes are blocked at 65024 and EA2 tapes are blocked at 32768. Tapes identified as JULIAN are the same as an EA2 tape however, the image is stored with a 15 character scene ID.
All images stored on ANSIOLD, EA1, EA2, and JULIAN tapes are not in the current AVHRR archive format. Before these images can be processed using the ADAPS functions they must be converted using INGEST with a Committee on Earth Observing Satellites (CEOS) ID of EAF.
A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.
The name of the first file on an ANSI labelled tape must start with an 'a' or an 'h'. This tape is not an AVHRR archive tape. Ensure the correct drive was specified and that the correct tape is mounted on that drive.
An error was encountered reading the header file on tape <xxxxx>. Inspect the tape to ensure it is a labelled AVHRR archive tape.
The tape mounted on drive <xxxxx> is not a labelled tape. Ensure the correct drive was specified and that the correct tape is mounted on that drive.
An error was encounted sending the tape identification number and the tape type to the TAE parameter block. Contact the system administrator.
An invalid record size of <xxxxx> was found on tape <yyyyy>. Ensure the correct drive was specified and that the correct tape is mounted on that drive.