User's Guide

NALC2NL

Utility to copy NALC tapes to near line.

Function:

Copy North American Landuse Cover (NALC) archive images and corresponding Digital Elevation Model (DEM) to near line.

Parameters:

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.

Examples:

    LAS> NALC2NL SUMFILE=/sg1/csb/pds2/daacnalc/summary/019032.sum_100520 FILENAME=(img_dem,img70_2,img80_1,img90_1,img70_1) TAPEID=(048689,048957,048959,048690,048958) MTYPE=3490 PATH=019 ROW=032 STACK=Y

    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.

Description/Algorithm:

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 file 

When 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.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [nalc2nl-alloc-d] Error allocating disk for <xxxx>

    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.

  2. [nalc2nl-bkupdir] Backup directory <xxxxxx> exists

    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.

  3. [nalc2nl-cpy-dat] Error copying the .dat from tape to disk

    Could not copy the data file from tape to disk. Check the tape drive and tape. Re-run program with same PATH/ROW.

  4. [nalc2nl-cpy-ddr] Error copying the .ddr from tape to disk

    Could not copy the ddr from tape to disk. Check the tape drive and tape. Re-run program with same PATH/ROW.

  5. [nalc2nl-cpy-tar] Error copying the tar file to edcsgs7

    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.

  6. [nalc2nl-cpy-txt] Error copying the <xxxxxx>.TXT file from nalcbin

    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.

  7. [nalc2nl-data] <xxx> path/<xxx> row does not exist - cannot process

    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.

  8. [nalc2nl-dda] Error creating the dda file for <xxxxxx>

    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.

  9. [nalc2nl-fatal] Fatal error encountered

    The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing is terminated.

  10. [nalc2nl-gzip] Error compressing the tar file

    Compression of tar file was not generated. Do not delete the working directory and contact the System Administrator.

  11. [nalc2nl-inproc] <xxx> path /<xxx> row is in process

    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.

  12. [nalc2nl-metadata] Metadata file - lddaacnalc.meta does not exist

    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.

  13. [nalc2nl-parm] Invalid path parameter-3char. needed

    An Invalid PATH parameter was found. Parameter needs to be 3 characters long. Re-run program with an appropriate parameter value.

  14. [nalc2nl-parm] Invalid row parameter-3char. needed

    An Invalid ROW parameter was found. Parameter needs to be 3 characters long. Re-run program with an appropriate parameter value.

  15. [nalc2nl-prdone] <xxx> path /<xxx> row has already been completed

    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.

  16. [nalc2nl-prerror] <xxx> path /<xxx> row has previously errored out

    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.

  17. [nalc2nl-stacker] Error occurred with stacker <xxxxxx>

    Stacker is not releasing or loading properly. Check the tape drive and re-run program with same PATH/ROW.

  18. [nalc2nl-tar] Error creating tar file

    Tar file could not be generated. Do not delete the working directory and contact the System Administrator.

  19. [nalc2nl-wkdir] Working directory <xxxxxx> exists

    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.

  20. [nalc2nl-xalloc] Error allocating <xxxxxx> tape drive

    Problem occurred when allocating a tape drive. Check the tape drive and re-run program with same PATH/ROW.

User Notes:

  1. The DEM must be listed first, with image tapes following in sequence.
  2. This program is intended to be called from nalcgetmeta.pdf.
  3. This program is intended to be run on Silicon Graphics (SG's) only.