⇑ Updated
![[3khat16.ico]](../../../img/3khat16.ico)
HP3000
3kMail
![[archive16.gif]](../../../img/archive16.gif "Wayback Archive")
X-OVER Copyright (c) 1992 by Allegro Consultants, Inc.
X-OVER copies HP STORE tapes, and other tapes.
A source and a target tape drive are required. Reel switching
will occur whenever the source or target is exhausted.
One popular use of X-OVER is to copy multi-reel 9-track tape
backups to a single DDS tape.
NOTE: LABELLED TAPE BACKUPS ARE NOT SUPPORTED BY X-OVER.
---------------------------------------------------------
There are three kinds of tape(s) that X-OVER can copy:
1) NM STORE tape(s)
X-OVER will automatically determine if a tape is an NM
STORE tape, and will copy the entire tape set. (E.g., if
the tape set is 5 reels of 9 track tape, X-OVER may be able
to copy it to a single DDS tape.)
2) CM STORE tape(s)
X-OVER will automatically determine if a tape is a CM
STORE tape, and will copy the entire tape set. (E.g., if
the tape set is 5 reels of 9 track tape, X-OVER may be able
to copy it to a single DDS tape.)
3) "other" tapes ("FCOPY" mode)
You can tell X-OVER to copy a single input tape/reel to a
single output tape. The output tape must be large enough
to hold the entire input tape. This kind of copy is
requested by specifying the "FCOPY" option (see the "parm"
section below).
The input tape(s) may be any kind of tape supported by
MPE/iX (e.g., 9-track, DDS, DLT).
The output tape(s) may be any kind of tape supported by
MPE/iX (e.g., 9-track, DDS, DLT).
---------------------------------------------------------
The basic method of running X-OVER is:
RUN XOVER.PUB.ALLEGRO;INFO="parm;parm;...;parm"
X-OVER generally assumes you want to copy a STORE tape set
(either CM or NM STORE). Thus, most ways of invoking it
will assume that. You can, however, use the COPY (aka "FCOPY")
mode, which copies a single reel to a single reel.
The "automatic" way of running X-OVER is:
RUN XOVER.PUB.ALLEGRO;INFO="GO"
(copy a STORE tapeset)
"parm" is defined as one or more of the following options,
which may appear in any mixture of upper or lower case:
Note: in the following, a prefix of "no" means that you may use a
'no' in front of an option to get the opposite sense, as in:
PAGING or NOPAGING. Most boolean options allow the "no" prefix.
noALLRETRIES
ALLRETRIES tells X-OVER to report all recovered tape errors.
(Otherwise, only some are reported.)
noANYFCODE
ANYFCODE tells X-OVER that when reading from a
STORE-to-disk file, the filecode may be any value.
NOANYFCODE tells X-OVER that when reading from a
STORE-to-disk file, the filecode must be 2501.
(Default: NOANYFCODE)
noAUTOSWITCHSD
When X-OVER is reading a STORE-to-disk file as input,
it will usually try to automatically open the next
"reel", if any. If the initial reel is a disk file
named FOO, the second reel is ./FOO.2, and the third
is /FOO.3. Setting NOAUTOSWITCHSD will cause X-OVER
to prompt for each input reel filename.
noCMCLOSE
Normally, when X-OVER detects that the input tape is a
CM STORE tape, it runs a helper process to do the
X-OVER. During that time, it usually keeps the
CM tape open. Specifying CMCLOSE will cause X-OVER
to close the tape before starting the helper process ...
but this will cause the helper process to issue a
tape request for the tape. (Default: NOCMCLOSE)
noCOMPRess
The NOCOMPRESS option tells X-OVER to try to disable
any "hardware compression" that the output tape might
otherwise try to do. (Default: COMPRESS)
noDROPSLT (or: SKIPSLT)
DROPSLT (or SKIPSLT) tells X-OVER to skip over (without
copying) any SLT portion of a combined SLT/STORE tape.
EOFS = <#EOFs> (only affects FCOPY mode)
Tells X-OVER how many EOFs (End-Of-File marks) in a row
constitute a logical end-of-tape.
(Default: 3)
FCOPY (or: COPY)
Tells X-OVER not to treat the tape as a STORE tape, but
simply as a single reel/tape of data. Use this to copy a
single tape to another tape. All data from the first tape
must fit on the target tape. FCOPY mode can handle any
format tape, but cannot perform reel switches (on either
the input or output tape).
Note: the default is NOFCOPY ... because X-OVER assumes
you want to copy a multi-reel STORE set, and not just
a single tape.
FILES = # (only affects FCOPY mode)
Tells X-OVER to stop FCOPY after copying the specified
number of files. 0 means "no limit". (Default: 0)
noFORCECM
FORCECM tells X-OVER to believe that the input is a CM STORE
tape. (This option is rarely, if ever, required.)
FROMDISK or TAPEDISK [=filename]
FROMDISK tells X-OVER that the input is not a tape, but is
a disk-copy of a tape (created by the TAPEDISK program from
Allegro).
GO (or: RUN)
GO tells X-OVER that no more options will be entered, it
should start copying the tape (or tape set).
HELP
Displays this help text.
IGNOREERRORS
Short for: ONERROR = IGNORE
MAXFILERECS #
(used for internal testing)
NULLoutput
NULLOUTPUT tells X-OVER not to open or write to any output
tape. (This exercises the input logic of X-OVER.)
NULLSinrow # (only affects FCOPY mode)
NULLSINROW Tells X-OVER how many null records in a row
constitute a logical end-of-tape on a DDS drive.
ONERROR = <ask |="" ignore="" ignoreq="" quit="">
ONERROR tells X-OVER what to do if a tape read/write
error occurs:
ASK : X-OVER will ask for "Ignore", "Quit",
or "Skipeof";
IGNORE : X-OVER will report but otherwise ignore
errors (where possible)
IGNOREQ : X-OVER will quietly ignore errors
(where possible)
QUIT : X-OVER will generally terminate.
Default: ONERROR = QUIT
OUTDEV devicename | NULL
OUTDEV specifies the target output device (e.g.: TAPE, DDS,
DLT) or (for testing) NULL. If not specified, X-OVER will
prompt for the device name.
OVERWRITE
Normally, before X-OVER will start writing to a new output
tape, it first checks to see if the output tape you mounted
is part of the same backup that you are *reading*.
OVERWRITE tells X-OVER that it is okay to overwrite a tape
from the same input set. (Actually, OVERWRITE tells X-OVER
to not even try reading the output tape at the start.)
This feature is normally used only when recopying a backup
to tapes previously used by X-OVER for the same backup.
Without OVERWRITE, X-OVER will reject output tapes from the
same backup, since overwriting these tapes is generally a
mistake.
noPAGING
PAGING tells X-OVER to stop after every screen-full of
output, and wait for a <return> to be entered.
Default: NOPAGING ... X-OVER normally does not attempt to
"paginate" output to the terminal ... because we have found
that users don't like to have an X-OVER stop in the middle,
waiting for a <return> to be entered.
noPROGRESS
PROGRESS tells X-OVER to report each filename as it
encounters them on the STORE tape.
PROGRESS is a synonym for SHOWFILES=ONLINE
RETRY #
Tells X-OVER how to handle reads/writes that succeeded only
after the hardware did a "retry". A value of 0 means:
treat the retry as an error. A value of -1 means: ignore
all retries (thus, do not treat them as errors). A
positive value means "allow # retries, then treat
subsequent ones as errors".
Default: RETRY 100
SECONDS # (only affects FCOPY mode)
Tells X-OVER how often to report progress during an FCOPY.
(Default: once a minute for sessions, once every
15 minutes for batch jobs.)
SHORTSinrow # (only affects FCOPY mode)
Tells X-OVER how many null records in a row constitute a
logical end-of-tape on a DDS drive.
(Default: 100)
SHOWBUFFERS
Tells X-OVER to display some information about internal
buffers when it terminates.
Note: this option is checked only when ONERROR = IGNORE.
NOSHOWfiles
SHOWfiles [= [NONE | ONLINE | OFFLINE | noSTATUS]* ]
SHOWFILES controls how verbose X-OVER's progress reporting
should be. (SHORT is a synonym for ONLINE.)
OFFLINE requests that a copy of most progress text be
sent to a printer (formal name: OFFLINE, default DEV=LP).
ONLINE requests that a copy of most progress text be
sent to the terminal. (Both ONLINE and OFFLINE may
be specified.)
STATUS ... when copying STORE tapes, STATUS causes X-OVER
to display each file to $STDLIST as it is copied. In FCOPY
mode, the number of bytes as well as the number of files
copied is shown.
NOSHOWFILES turns off all SHOWFILE options.
If no "=" follows SHOWFILES, SHOWFILES=SHORT is assumed.
SIMULATEeot eof#.record# [eof#.record# ...]
(Used for internal testing)
Simulates an End-Of-Tape (EOT) on the output tape
after eof# EOFs have been written to the tape, plus
record# records (after that EOF). If more than
one eof#.record# pair is entered, the first pair is
used for reel 1, the second for reel 2, etc., with
the last pair being used for all subsequent reels.
An eof# of -1 means "don't simulate an EOT for this reel".
A record# of 0 means "simulate the EOT when the EOF
is written".
SKIPEOFONERROR
SKIPEOFONERROR tells X-OVER to skip to the next EOF
after encountering an error reading the input tape.
NOSKIPEOFONERROR (default) tells X-OVER not to skip
to an EOF.
noSTATUS
STATUS is a synonym for SHOWFILES=STATUS
TELL [= [jobname, ] user.account]
When tapes need changing, a message will be sent via the
TELL command to the specified user. If the user.account is
omitted, OPERATOR.SYS is assumed.
Examples: TELL = MANAGER.SYS
TELL = SANDY,OPERATOR.SYS
TIMES
TIMES tells X-OVER to report some CPU/elapsed time
statistics.
TODISK
(Used for internal testing)
TRACE filename
NOTRACE
(Used for internal testing)
TRACEDIE
TRACEDIE tells X-OVER to display a stack trace when it
terminates.
VERSION
VERSION tells X-OVER to report the version number, and
then terminate.
noWAITINPUT
WAITINPUT tells X-OVER to be willing to wait and let
you restore an input disk file during a "reel switch".
Thus, if you had a STORE-to-disk that comprised three
files of 4 GB each, and didn't have room for all of them
on disk at one time, your could restore the first one
and start X-OVER. If WAITINPUT is specified, then when
the reel switch comes, you could purge the first reel
and restore the second reel and continue.
Default: NOWAITINPUT
If no INFO string is given, X-OVER will prompt you for a single
non-blank command line. If you want to copy a STORE tape set
without entering any special options, enter the "command": GO
Example:
:RUN XOVER.PUB.ALLEGRO; INFO = "GO"
(copy a STORE tapeset)
Example:
:RUN XOVER.PUB.ALLEGRO;INFO="SHOW=OFFLINE;TELL=OPERATOR.SYS"
(copy a STORE tapeset)
Or,
:RUN XOVER.PUB.ALLEGRO
XOVER: FCOPY SHOW=STATUS;FILES=20;EOFS=5
(copy a single reel, stopping after 20 files or file EOFs
in a row)
//