User's Guide

NDFCOPY

Copy NDF (NLAPS Data Format) media to archive tape(s).

Function:

Copy NLAPS Data Format media generated from PDS to EDC archive library tape(s). Metadata files can be created and stored locally for retrieval by project specific users.

Parameters:

COMMENT
Description of media. A text string sent to the operator's terminal. The operator uses this text to find the media to be mounted; therefore, COMMENT should be as descriptive as possible. It should include both the ID number and a short description which allows the operator to ensure that the correct media is mounted.

ITTYPE(&$MTYPE)
Input media type. The type of media from which to read the product. The default value is defined by the TAE global $MTYPE. The list of valid media types is defined by the TAE global $MTYPEVAL.

ITAPEID(CCT)
Input tapeid. The tape library storage identification. This value is used to generate a library label for the media in the event that ITTYPE and OTTYPE are identical, and not NULL.

OTTYPE(&$TTYPE)
Output tape type. The type of media on which to write the product. The default value is defined by the TAE global $TTYPE. The list of valid tape types is defined by the TAE globa $TTYPEVAL.

ORDID
Order ID. The first 8 digits from the DORRAN ordid, which will be specified on the input media's NLAPS format PDS label. (See User Note 5).

CODE(-- )
Project source code. This is the three digit code to be used to fill in the code field on a library media label.

PROJECT(--)
Project name. This is the project description to be used to fill in the project field on a library media label.

Examples:

  1. LAS> ndfcopy ittype=8lo ottype=3490 orderid=lt403205 code=103 project="nldc" comment="mount 8lo 01196020100530001 for ndfcopy"

    The 8LO input tape is read to disk. The number of output tapes required to copy the data from disk to the output media is calculated. One header file will be created for each output tape. Data will be copied to output 3490 tapes. Metadata files 01196020100530001.SCENE, 01196020100530001.ARCHV and 01196020100530001.DAT are created on disk, then placed in /sgs18/pds2/work/ops/meta/103 directory. Mail messages are sent to project specific users to notify them of the completion of NDFCOPY, and where to pick up the metadata for further processing.

  2. LAS> ndfcopy ittype=3490 ottype=3490 orderid=lt403604 code=103 project="nldc" comment="mount 3490 123456" itapeid="123456"

    The input and output media types are the same, so the NDF header is read from the tape to disk, the image data files are skipped, and the NDF work order and history files are read to disk. A library storage label is generated, and the tape is dismounted. metadata files 01197061100530002.SCENE, 01197061100530002.ARCHV, and 01197061100530002.DAT are created on disk, then moved to the /sgs18/pds2/work/ops/meta/103 directory. Mail messages are sent to project specific users to notify them of the completion of NDFCOPY, and where to pick up the metadata for further processing.

  3. LAS> ndfcopy ittype=8hi ottype=3480 orderid=lm604102 comment="mount 8hi 0089705800530001 for ndfcopy"

    The input 8HI tape is read to disk. The number of output tapes required to copy the data from the disk to the output media is calculated. One NDF header file will be created for each output tape. The data will be copied to output 3480 tapes. No metadata files will be created, and no library tape label will be generated.

  4. LAS> ndfcopy ittype=cd ottype=3490 orderid=lm403603 code=103 project="nldc" comment="mount cd 0089705800530001 for ndfcopy"

    The input CD-ROM is read to disk. The number of output tapes required to copy the data from the disk to the output media is calculated. One NDF header file will be created for each output tape. The data will be copied to output 3490 tapes. A library storage label is generated, and the tape is dismounted. Metadata files 0089705800530001.SCENE, 0089705800530001.ARCHV, and 0089705800530001.DAT are created on disk, then moved to the /sgs18/pds2/work/ops/meta/103 directory. Mail messages are sent to project specific users to notify them of the completion of NDFCOPY, and where to pick up the metadata for further processing.

Description/Algorithm:

Copy NLAPS Data Formatted media to archive library tape. This code has three operating scenarios:

1. Data will be copied from the input media to disk. The number of output tapes will be calculated. A new header file will be created for each output tape. Header and Data files will be copied to the output media. Metadata files with information from the NDF header and work files will be created and placed in a project specific directory for pickup by project data base administrators.

2. If the input and output media types are the same and the project and code fields are specified, then only the NDF header and workorder summary files are copied to disk for use in the metadata creation process. Additionally, a library tape label is generated for the input media.

3. If the input and output media types are different, and the project and code fields are unspecified, then the data on the input media is copied to disk. New header files will be generated for each output tape (if required), and output NDF format tapes will be generated on CCT media. No meta data will be created, and no library label will be printed.

This software assumes all input media was created from the Product Distribution System (PDS). Each PDS NLAPS format label will contain a DORRAN ordid which will be used for the ORDID parameter of this procedure.

The metadata files created by this process are used to update various project specific database inventories. Copying, utilization, and deletion of the meta data files is the responsibility of Data Management personnel.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [ndfcopy-dem] DEM file does not fit on one tape

    This tape can not be copied since the DEM file does not fit on one output tape. Notify Data Management Department.

  2. [ndfcopy-fatal] Fatal error encountered

    A fatal error was encountered during processing. The error message that is displayed immediately preceding this message is the specific error that was encountered.

  3. [ndfcopy-invalid] Incompatible PROJECT and CODE

    The specified Project does not belong to the Code. Re-enter Project and Code values and re-run. If the error persists, notify the Data Management Department.

  4. [ndfcopy-parm] Invalid length of <xxxx>

    The specified parameter was not entered properly. Re-enter parameter and re-run.

  5. [ndfcopy-open] Error opening <xxxx>

    An error was encountered opening the specified file. Check the file and directory protections and re-run the program.

  6. [ndfcopy-ordtype] BIL order needs more than 1 output tape

    This tape can not be copied, because image data files with a Band Interleaved by Line (BIL) format must be copied onto one output tape. Notify Data Management Department.

  7. [ndfcopy-rmserror] Absence of RMS error from work order file

    The work order file should have an entry for RMS error field. Notify Data Management Department.

  8. [ndfcopy-spec] Both PROJECT and CODE must be specified

    If either PROJECT or CODE is specified, then NDFCOPY requires that the other parameter also be specified. Enter omitted parameter and re-run.

  9. [ndfcopy-vblk] Error getting parameters from the TAE

    An error was encountered retrieving parameters from the TAE parameter block. Notify the system administrator if the problem persists.

  10. [ndfcopy-write] Error writing order to media

    An error was encountered when writing the output media. Check for faults with drive and media then re-run.

  11. [ndfcopy-format] NDF Header found when expecting work order file

    A product was processed that either contains multiple resolutions or a DEM. This process does not support these.

User notes:

  1. Refer to the National LANDSAT Archive Production System (NLAPS) document Format Description Document for more information on NDF.

  2. Related programs are NDFIN, NDF2LAS.

  3. This program will not read in multivolume products.

  4. This program is intended for use by Computer Operations staff.

  5. The ORDID parameter must be entered in lower case if the input media is CD-ROM. NDFCOPY will request mounting of the specified CD-ROM, then copy the NDF header file specified by ORDID.hd to the local disk for further processing.