Utility to copy NALC tapes to near line.
Copy North American Landuse Cover (NALC) archive images and corresponding Digital Elevation Model (DEM) to near line.
- SUMFILE
- Summary File. The path for the summary file.
- FILENAME
- Filename. The root filenames for all of the files to be copied to disk.
- TAPEID
- Tape Identification. Library storage locations of input archive tapes. See User Note 1.
- MTYPE(&$MTYPE)
- Media Type. The type of digital media being used. The default is defined by the TAE global $MTYPE. The list of valid media types are defined by the TAE global $MTYPEVAL.
- PATH
- WRS Path. The WRS path of this image.
- ROW
- WRS Row. The WRS row of this image.
- STACK
- Staker Flag. This is a flag used to specify whether or not a stacker will be utilized.
= Y: YES = N: NO
- ROOTDIR(/SGS6/PDS2/WORK/OPS/CHEAPNALC/)
- Root Directory. The root directory is the directory the program will be run from.
The library tapes specified in TAPEID, are read to disk. A dda file is created from every ddr file. After the dda file is created, the ddr file is deleted. For every tapeid, a metadata file is copied to the working directory from the $PDSROOT/nalcbin. When all of the tapes for a given triplicate have been processed, the data will be tarred and compressed together in a file called pathrow.tar.gz (ex. 019032.tar.gz). This file will then be copied to near line storage, which is currently edcsgs7:/archive/daac/nalc.
The NALC archive is stored on 3480 tapes. Each scene is stored on one 3480 tape. Each tape contains a binary data descriptor record (DDR) and a BSQ image file. Each DEM tape is stored with one binary DDR and one image file.NALCGETMETA.PDF is the front end to NALC2NL program. NALCGETMETA will extract all necessary information from the metadata file (lddaacnalc.meta) to copy the data from tape to near line. NALCGETMETA will call NALC2NL when all of the data has been extracted from the metadata file for a given triplicate.
NALC2NL.PDF will copy the specified DEM and images from archive 3480 media to edcsgs7 near line storage. The program will pull the 1st file off of the archive tape, which is the ddr file. It will then create a dda file from the ddr file. After the dda file has been created, the ddr file will be deleted from disk. The program will then pull the 2nd file off of the archive tape. An additional metadata text file will be copied to the working directory from $PDSROOT/nalcbin.
Every scene that is within a triplicate will have 3 files associated with it.
1. a dda file 2. a data file (image) 3. a text fileWhen all of the data is copied to the working directory, the directory will be tarred and compressed into one file called 'pathrow.tar.gz' (ex. 019032.tar.gz). This file will then be copied to edcsgs7:/archive/daac/nalc/pathrow/. If the file does not get copied to edcsgs7 because of errors, the tar file will be copied to a backup directory, under the path/row, along with a text file stating the location where the data should reside. This will allow the data to be copied by hand to the appropriate place.
Problem occurred when allocating disk for specified file. Check disk to see if there is enough disk space. Re-run program with same PATH/ROW.
The backup directory already exists. Check for data in the backup directory. If there is no data present, copy the data from the working directory into the backup directory. If data is present, verify the data within the backup directory, with the data located in the working directory.
Could not copy the data file from tape to disk. Check the tape drive and tape. Re-run program with same PATH/ROW.
Could not copy the ddr from tape to disk. Check the tape drive and tape. Re-run program with same PATH/ROW.
A problem occurred when copying the tar file to edcsgs7. All of the data (the compressed tar file) should be in the backup directory, located in the operations specified working directory for NALC2NL. Along with the tar file will be a text file giving the location of where the tar file should reside on edcsgs7. A manual copy to the appropriate location should be done.
An error occurred when copying the metadata text file from the nalcbin. Verify that the specified file exists. If the file does not exist, contact Data Management. If the file is there, re-run program with same PATH/ROW.
The specified combination of PATH/ROW cannot be processed. The specified input data does not exist in the lddaacnalc.meta file, which is located in the operations specified working directory for NALC2NL. Verify PATH/ROW and re-run program. If PATH/ROW should be present but is not, contact Data Management with problem.
An error occurred when trying to create a dda file from the ddr file. Verify that ddr file did not error when being copied to the working directory. If file did not error, contact the System Administrator.
The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing is terminated.
Compression of tar file was not generated. Do not delete the working directory and contact the System Administrator.
Within the metadata file an "i" was found in the status field of the specified PATH/ROW. The "i" means that the specified PATH/ROW is currently being run. Select another PATH/ROW and run program.
The metadata file lddaacnalc.meta does not exist. This file is needed for this program to run, because of all the information that is extracted from the file so the triplicate can be copied to disk. Contact Data Management for metadata file and copy the file to the specified working directory for NALC2NL.
An Invalid PATH parameter was found. Parameter needs to be 3 characters long. Re-run program with an appropriate parameter value.
An Invalid ROW parameter was found. Parameter needs to be 3 characters long. Re-run program with an appropriate parameter value.
Within the metadata file an "y" was found in the status field of the specified PATH/ROW. The "y" means that the specified PATH/ROW has previously been completed. Select another PATH/ROW and run program.
Within the metadata file an "e" was found in the status field of the specified PATH/ROW. The "e" means that the specified PATH/ROW has previously errored out. All of the data (the compressed tar file) should be located in the backup directory, which is located in the operations specified working directory for NALC2NL. Along with the tar file, will be a text file giving the location of where the tar file should reside on edcsgs7.
Stacker is not releasing or loading properly. Check the tape drive and re-run program with same PATH/ROW.
Tar file could not be generated. Do not delete the working directory and contact the System Administrator.
The working directory cannot be created because a working directory of the path/row already exists. Verify why the working directory is present. When directory has been removed, re-run program with same parameters.
Problem occurred when allocating a tape drive. Check the tape drive and re-run program with same PATH/ROW.