User's Guide

JSCCOPY

Copy one JSC (Johnson Space Center) format image to 3480 and extract metadata from the header records, copying it to a remote disk directory.

Function:

Copy one JSC (Johnson Space Center) format 8mm tape to a 3480 tape for archiving and extract needed metadata from the header files. The metadata, which is split into the .scene and .archv files, will be copied to the directory /dg3/work/dsb/data/lsjscnldc/ for database population.

Parameters:

PROJECT
Project. The project for which the tapes are being copied.

CODE
Associated project code. This corresponds to the entry for PROJECT.

Example:

  1. LAS> jsccopy project="htfpmss" code=051

    The operators are prompted to mount an 8mm JSC format tape. The image is read from the tape. The operators are prompted to mount a scratch 3480 and the image is copied to it. Metadata is extracted from the Universal and Landsat Header files and copied to /dg3/work/dsb/data/lsjscnldc, reflecting the given project name and code.

Description/Algorithm:

The operator is prompted to mount an 8mm JSC tape, and image data is read off of it. After all three files have been read from the tape (Universal Header File, Landsat Header File, and Video Data File), the operators are prompted to mount a 3480 scratch tape, and the files are copied over to it.

Metadata is then extracted from the header files and copied to a repository at /dg3/work/dsb/data/lsjscnldc for DMS to use in database population.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [jsccopy-alloc] Error allocating dynamic memory

    An error occurred allocating memory. Re-run, and if the error persists, contact the LAS system administrator.

  2. [jsccopy-file] Error opening <xxxxx> file for <xxxxx>

    An error occurred trying to open a disk file. Ensure that the disk device is not full and re-run. If the error persists, contact the LAS system adminsistrator.

  3. [jsccopy-pass] Error passing variables to TAE.

    An error occurred while trying to pass information back to TAE. This error should not occur. Re-run, and if the problem persists, contact the LAS system administrator.

  4. [jsccopy-read] Error reading data from <xxxxx>

    An error occurred while trying to read data from an input file. Re-run, and if the error persists, contact the LAS system administrator.

  5. [jsccopy-write] Error writing data to <xxxxx>

    An error occurred while trying to write data to an output file. Ensure that the disk device is not full and re-run. If the error persists, contact the LAS system administrator.

User Notes:

  1. JSCCOPY uses DITTO functions for processing. Refer to these User Guides for more information.

  2. The PROJECT and CODE fields do not have a list of valid entries; rather, they have been made mandatory and free-form to allow for future project names/associated codes without requiring modification to this function.

  3. The user running this function must have have an account on the dg3 machine; otherwise, the function will be unable to remote-copy the metadata files to the proper directory. It may be necessary to run the function from under a release account.