Stack AVHRR archive images to tape.
Stacks AVHRR archive images to an ANSI labeled tape. If the tape drive is equipped with an automatic tape stacker, this function can stack multiple tapes.
- PROCOPT
- Processing option. The three character Committee on Earth Observing Satellites (CEOS) ID of the station for which the tape is being created. When PROCOPT is set to some off-site station, a shipping form which lists the images on the tape and a free-format tape label are created for each tape. When PROCOPT=sfl, each image has its database record updated in the ADAPSDBTMP directory and a library formatted tape label is created for each tape.
= esa: European Space Agency = sfl: EROS Data Center = noa: National Oceanic and Atmospheric Administration
- CEOSID
- CEOS ID. The three character CEOS ID of the receiving station for which the images are being stacked.
- DRIVE
- Tape drive. The tape drive to be used. If a drive is specified, the operator will not be prompted to mount a tape. It is assumed that the specified drive has NTAPES tapes mounted and ready for writing. If NULL, the operator will be prompted to mount NTAPES tapes.
- NTAPES
- Number of tapes. The number of tapes that are to be stacked. If NTAPES is greater than one, it is assumed that DRIVE is equipped with an automatic tape stacker.
- TTYPE
- Tape type. Type of tape that is to be stacked. The default is defined by the TAE global $TTYPE. The list of valid tape types is defined by the TAE global $TTYPEVAL.
- MINBYTES
- Minimum megabytes. The minimum number of megabytes that are to be stacked to a tape. If the combined size of all the available images does not exceed this value, AVHRRSTACK will wait until additional images appear in the input directory.
- MAXBYTES
- Maximum megabytes. The maximum number of megabytes that can be written to a tape.
- INFILE(A*)
- Input file. Wildcarded root file name defining the images to be stacked to tape. An extension of ;AHDR is assumed.
- FILEOPT
- File option. Option for deleting or moving the files that are stacked to tape. If set to MOVE, OUTDIR must be specified.
= DELETE: Delete files after stacking = MOVE: Move files to OUTDIR after stacking
- OUTDIR
- Output directory. If FILEOPT is set to MOVE, OUTDIR must be the directory where the files will be moved after they have been successfully stacked to tape. If FILEOPT is not set to MOVE, this parameter is ignored.
- ADDRESS(--)
- Shipping address. This address will be printed on the tape label and the shipping form.
- INSTRUCT(--)
- Special instructions. Special instructions to be printed on the shipping form.
- PRODSUM(NO)
- Product summary. Flag indicating whether to generate a product summary listing for each scene:
YES : Generate a product summary NO : Don't generate a summary
- LOGFILE(--)
- Log file. File where all processing messages will be logged. If NULL, the default is AVHRRSTACK.<xxx>;LOG in the ADAPSLOG directory, where <xxx> is PROCOPT.
- SCENEFLG("NO")
- Scene print flag. A flag to specify if the scene summaries are to be printed.
= YES: Print out the individual scene summaries = NO: Do not print the scene summaries
- PROCOPT
- Processing option. The three character Committee on Earth Observing Satellites (CEOS) ID of the station for which the tape is being created. When PROCOPT is set to some off-site station, a shipping form which lists the images on the tape and a free-format tape label are created for each tape. When PROCOPT=sfl, each image has its database record updated in the ADAPSDBTMP directory and a library formatted tape label is created for each tape.
= esa: European Space Agency = sfl: EROS Data Center = noa: National Oceanic and Atmospheric Administration
- CEOSID
- CEOS ID. The three character CEOS ID of the receiving station for which the images are being stacked.
- DRIVE
- Tape drive. The tape drive to be used. If a drive is specified, the operator will not be prompted to mount a tape. It is assumed that the specified drive has NTAPES tapes mounted and ready for writing. If NULL, the operator will be prompted to mount NTAPES tapes.
- NTAPES
- Number of tapes. The number of tapes that are to be stacked. If NTAPES is greater than one, it is assumed that DRIVE is equipped with an automatic tape stacker.
- TTYPE
- Tape type. Type of tape that is to be stacked. The default is defined by the TAE global $TTYPE. The list of valid tape types is defined by the TAE global $TTYPEVAL.
- MINBYTES
- Minimum megabytes. The minimum number of megabytes that are to be stacked to a tape. If the combined size of all the available images does not exceed this value, AVHRRSTACK will wait until additional images appear in the input directory.
- MAXBYTES
- Maximum megabytes. The maximum number of megabytes that can be written to a tape.
- INFILE(A*)
- Input file. Wildcarded root file name defining the images to be stacked to tape. An extension of ;AHDR is assumed.
- ACCTNUM
- Account number. The account number to which this order will be sent and billed.
- ORDERNUM
- Order number. The order number that includes this item.
- UNITNUM
- Unit number. The Level 1b unit number of the specified order.
- FILEOPT
- File option. Option for deleting or moving the files that are stacked to tape. If set to MOVE, OUTDIR must be specified.
= DELETE: Delete files after stacking = MOVE: Move files to OUTDIR after stacking
- OUTDIR
- Output directory. If FILEOPT is set to MOVE, OUTDIR must be the directory where the files will be moved after they have been successfully stacked to tape. If FILEOPT is not set to MOVE, this parameter is ignored.
- ADDRESS(--)
- Shipping address. This address will be printed on the tape label and the shipping form.
- INSTRUCT(--)
- Special instructions. Special instructions to be printed on the shipping form.
- PRODSUM(NO)
- Product summary. Flag indicating whether to generate a product summary listing for each scene:
YES : Generate a product summary NO : Don't generate a summary
- LOGFILE(--)
- Log file. File where all processing messages will be logged. If NULL, the default is AVHRRSTACK.<xxx>;LOG in the ADAPSLOG directory, where <xxx> is PROCOPT.
- SCENEFLG("NO")
- Scene print flag. A flag to specify if the scene summaries are to be printed.
= YES: Print out the individual scene summaries = NO: Do not print the scene summaries
AVHRR archive images will be stacked from the [.sfl.sfl] subdirectory of ADAPSARC. Images matching A* will be stacked. The operator will be prompted to mount ten 3480, ANSI labeled tapes. Each tape will contain between 250 to 270 megabytes of data. All processing messages will be logged in the avhrrstack.sfl;log file in ADAPSLOG. A tape label will be printed for each tape stacked. After each image is stacked to tape, it will be moved into the [prodgen.save] directory, and its database record will be updated to indicate the identification number of the tape to which it was stacked.
AVHRR archive images will be stacked in Level-1B format from the [esa] directory. Images matching AH* will be stacked. The operator will be prompted to mount one 8LO, ANSI labeled tape. The tape will have at most 2250 megabytes of data stacked to it. All processing messages will be logged in the avhrrstack.esa;log file in ADAPSLOG. A tape label and a shipping form will be printed for the tape. After each image is stacked to tape it will be moved into the [save.sfl] directory.
AVHRRSTACK enters a processing loop and executes the following steps for all NTAPES tapes that are to be stacked:
1. Call ANSISTACK to stack AVHRR images to a single tape. If FILEOPT=MOVE, each image will be moved into the directory specified by OUTDIR after it has been stacked to tape. If FILEOPT=DELETE, each image will be deleted after it has been stacked to tape. 2. Rename the tape summary file produced by ANSISTACK to a standard file name. See User Note 1. 3. If PROCOPT=sfl, UPDATEDB is called to update the database records for each image with the tape ID. 4. SHIPFORM is called to create a shipping form for the tape that was created. 5. If the stop file exists, exit the loop and do not stack the remaining tapes. See User Note 2.
An error was encountered stacking images to a tape. The tape is dismounted and stacking will continue with the next tape if there are additional tapes available in the automatic tape stacker.
An error was encountered while dynamically allocating memory. If the error persists, contact the system administrator.
A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.
An error was encountered opening the tape summary file. Ensure the file and directory permissions are set appropriately. See User Note 1.
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 Users Guide for ANSISTACK for a description of the tape summary file. Once the summary file has been modified, the user must manually run UPDATEDB or SHIPFORM, depending upon the value of PROCOPT.
AVHRRSTACK already has drive <xxx> in use. If another AVHRRSTACK is using the drive, select another tape drive to use. If AVHRRSTACK is not using this tape drive, the appropriate lock file will have to be removed from ADAPSTABLES. The lock file is named AVHRRSTACK.<xxx>;LOCK.
ANSISTACK completed successfully; however, the tape summary file was not created. Check the appropriate log file to determine which images were stacked to the tape. Refer to the user's guide for ANSISTACK to determine what the problem may be.
An error was encountered sending a parameter to TAE. If the error persists, contact the system administrator.
The "beginning of tape" status was not found. If the error persists, contact the system administrator.