User's Guide

CKARCH

Check archive scenes for extra lines.

Function:

Check archive scenes for extra lines. This program was developed as a way to check archived scenes on tape for inconsistencies in the actual number of lines archived and the number of lines that should have been written.

Parameters:

OUTDIR
The working directory where archived scenes are placed. Scenes will be read from tape into this directory and removed once processing is complete.

NTAPES(14)
The number of tapes mounted in the stacker. This value is used as a loop control to mount each tape in turn. The default is the stacker maximum 14.

DRIVE(--)
The drive number where the tapes are stacked. If NULL a mount request is sent to the operator.

Examples:

  1. LAS> ckarch outdir=[sg1.km1.test.ckarch] drive=4

    It is assumed that a stacker has been loaded with the maximum number of tapes on drive 4. The scenes will be read from tape and placed in the working directory [sg1.km1.test.ckarch].

  2. LAS> ckarch outdir=[sg1.km1.test.ckarch] ntapes=5 drive=4

    It is assumed that a stacker has been loaded with 5 tapes on drive 4. The scenes will be read from tape and placed in the working directory [sg1.km1.test.ckarch].

  3. LAS> ckarch outdir=[sg1.km1.test.ckarch] ntapes=1

    The operator will be prompted to mount a tape. Pre-coordination with the operator will be necessary so the correct tape will be mounted. The scenes will be read from tape and placed in the working directory [sg1.km1.test.ckarch].

Description/Algorithm:

If a drive is specified, it is assumed that NTAPES are mounted and ready to be read. If no drive is specified then a mount request is sent to the operator. Each tape is mounted and the scenes are read using READARCH_ and placed in the working directory. Once the scenes from each tape are read, each scene is processed as follows: 1) the time stamps from the first and last line are extracted and a line count is determined; 2) the actual number of lines in the file is determined from the file size; 3) the log file is updated indicating SUCCESS, the line counts matched, or FAILURE, the line counts did not match; 4) finally, the scene is deleted from the working directory.

Nonfatal Error Message:

    None

Fatal Error Messages:

  1. [ckarch-sfil] An error occurred while determining the stop file name and location.

  2. [ckarch-getd] Unable to mount the drive specified.

  3. [ckarch-tpid] Could not determine the tape ID.

  4. [ckarch-chk] An error occurred while checking the line counts.

  5. [ckarch-drv] Error dismounting the tape.

  6. [ckarch-file] Error opening the input scene file.

User Notes:

  1. This function was written to determine the impact of a bug in INGEST that adds extra lines when it encounters more that 250 lines with invalid non-zero time stamps. Once all the tapes are processed, the file $ADAPSLOG/ckarch.log may be studied to determine which scenes fall in this category.

  2. Lines in the log file of the form:

    [working.dir]ah11060192065256 09/04/97 14:38:40 XXXXXX Lines expected: YYYY Actual: YYYY

    where XXXXXX is either SUCCESS or FAILURE and YYYY is some number, contain the information needed to investigate the impact of the INGEST bug. SUCCESS, FAILURE, and Lines expected are unique identifiers of these lines and may be used to grep the log file. These are single lines.

  3. This function was designed to be used with multiple tapes loaded on a stacker. If it's desired to check a single archive tape, the user must coordinate with the operator to load the specific tape.