Acquire ESA orbits from tape
Acquires ESA orbits from tape to disk. A sequential or random set of orbits may be copied.
- 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.
- 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.
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.
A request is sent to the operators to mount tape km1004. Only the second orbit on the tape will be read onto disk.
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.
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.
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.
Orbit number <xxx> is a partial tar file.
ESACQUIRE was unable to successfully release the tape drive. Run RELDRIVE to release the tape drive.
An error was encountered retrieving the value of the environment or logical variable <xxxxx>. Ensure the variable is set appropriately.
A fatal error was encountered. The message displayed prior to this is the actual error encountered.
An error was encountered forward skipping a file on tape. Ensure that there are the specified number of orbits on the tape.
Parameter <xxxxx> must be <yyy> characters in length. Ensure the specified parameter was entered correctly.
ESACQUIRE was unable to locate the command <xxxxx>. Ensure the appropriate directories are in the TAE global variable $APLIB.
An error was encountered reading orbit number <xxx> from tape. Ensure the tape contains the expected number of orbits.
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.
ESACQUIRE must be run on a UNIX system.
The user aborted ESACQUIRE with <ctrl-c>.
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.