User's Guide

ESACQUIRE

Acquire ESA orbits from tape

Function:

Acquires ESA orbits from tape to disk. A sequential or random set of orbits may be copied.

Parameters:

Subcommand -RANGE:
Copy a sequential set of ESA orbits from tape to disk. The orbits copied to tape are defined by a starting and stopping orbit number.

TAPEID
Tape ID. The library identification code of the tape(s) containing the desired orbits. Multiple tapes are to be specified only if a tape drive equipped with an automatic tape stacking device is used.

START(1 VALID=1:900)
Starting orbit number. The first orbit to be read from tape.

STOP(-- VALID=1:900)
Stopping orbit number. The last orbit to be read from tape. If NULL, all orbits will be read from tape.
Subcommand -SELECT:
Copy a selected set of ESA orbits from tape to disk. Up to ten non-sequential orbits may be copied from tape.

TAPEID
Tape ID. The library identification code of the tape(s) containing the desired orbits. Multiple tapes are to be specified only if a tape drive equipped with an automatic tape stacking device is used.

ORBITNUM
Orbit number(s). Numbers of the orbits to be read from tape.

Examples:

  1. LAS> esacquire-range tapeid=038591 start=4

    A request is sent to the operators to mount tape 038591. A sequential set of orbits are acquired from tape starting with the fourth orbit on the tape and ending with the last orbit on the tape. All the orbits will be placed in the subdirectory "esaorb" within ADAPSORB.

  2. LAS> esacquire-range tapeid=km1004 start=2 stop=2

    A request is sent to the operators to mount tape km1004. Only the second orbit on the tape will be read onto disk.

  3. LAS> esacquire-range tapeid=(km1000 km1001 km1006)

    In this example it is assumed that the user has arranged to have the three tapes km1000, km1001, and km1006 mounted in an automatic tape stacker. A request is sent to the operators to mount the first tape and it is assumed the next two tapes will be automatically mounted on the same tape drive when the previous tape is dismounted. All orbits will be acquired from each tape.

  4. LAS> esacquire-select tapeid=038591 orbitnum=(1 4 5 9)

    A request is sent to the operators to mount tape 038591. The first, fourth, fifth, and ninth orbits are acquired from tape. All of the orbits will be placed in the subdirectory "esaorb" below ADAPSORB.

Description/Algorithm:

The tape containing the orbits to be acquired is defined by a tape ID. The station ID is always assumed to be "ESA".

Each orbit is first read into the "esaorb" directory; when the entire orbit is acquired from tape, it is renamed. The Level 0 EDC archive header file is renamed from "sceneid;ahdr" to "sceneid;ahdr;done" (where "sceneid" is the orbit scene ID). This naming scheme prevents the attempted processing of the orbits before they are completely copied from tape.

Nonfatal Error Messages:

  1. [esacquire-partial] Partial tar file was file <xxx>

    Orbit number <xxx> is a partial tar file.

  2. [esacquire-reldrive] RELDRIVE returned <xxx>

    ESACQUIRE was unable to successfully release the tape drive. Run RELDRIVE to release the tape drive.

Fatal Error Messages:

  1. [esacquire-env] Error retrieving <xxxxx>

    An error was encountered retrieving the value of the environment or logical variable <xxxxx>. Ensure the variable is set appropriately.

  2. [esacquire-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed prior to this is the actual error encountered.

  3. [esacquire-fsf] Error forward skipping file

    An error was encountered forward skipping a file on tape. Ensure that there are the specified number of orbits on the tape.

  4. [esacquire-len] <xxxxx> must be <yyy> characters

    Parameter <xxxxx> must be <yyy> characters in length. Ensure the specified parameter was entered correctly.

  5. [esacquire-lib] Error determining library for <xxxxx>

    ESACQUIRE was unable to locate the command <xxxxx>. Ensure the appropriate directories are in the TAE global variable $APLIB.

  6. [esacquire-read] Error reading orbit <xxx> from tape

    An error was encountered reading orbit number <xxx> from tape. Ensure the tape contains the expected number of orbits.

  7. [esacquire-remote] Remote system not allowed for <xxx>

    Remote tape drives are not allowed for CEOS ID <xxx> when ESACQUIRE is being run from the current computer system. Use a tape drive on the current system or consult User Note 1.

  8. [esacquire-system] ESACQUIRE must be run on a UNIX system

    ESACQUIRE must be run on a UNIX system.

  9. [esacquire-user] User interrupt

    The user aborted ESACQUIRE with <ctrl-c>.

User Notes:

  1. Tapes may only be remotely mounted if ESACQUIRE is being run from a computer that can handle remote tar commands.

  2. To read all orbits from a tape use the -RANGE subcommand and allow START and STOP to default. At most, 900 orbits may be read from any one tape. If you have a tape with more than 900 orbits consult the system administrator.

  3. The following message may appear during processing:

    Change tape and press the Enter key:

    If it does appear, type <ctrl-c> to go on to the next orbit. You will then have 10 seconds to type another <ctrl-c> to abort ESACQUIRE, if desired. This message appears due to an invalid tar file header record. A resulting tar file will remain on disk and may be incomplete.