⇑ Updated
![[3khat16.ico]](../../../img/3khat16.ico)
HP3000
3kMail
![[archive16.gif]](../../../img/archive16.gif "Wayback Archive")
Copyright (c) 1993, 2002 Allegro Consultants, Inc. (408) 252-2330
Author: Stan Sieler sieler@allegro.com
(help text updated 2007-12-20)
This is TAPEDISK: a program to copy any kind of tape (e.g., reel
or DDS or DLT) to disk. The resulting disk file is usually
compressed, occupying less space than it might have otherwise.
The resulting disk file can be copied to tape later with
DISKTAPE.
Thus, TAPEDISK & DISKTAPE can be used as a pair to make a copy of
a tape, using only a single tape drive (assuming you have enough
disk space for the compressed output file of TAPEDISK, of
course).
Note: TAPEDISK can also create a STORE-to-disk format output
disk file, if requested. (Such disk files are not further
compressed by TAPEDISK.) (See the SD option.)
Another use is to use TAPEDISK to create a disk copy of a tape
drive, move that disk file to a personal computer, and then
"burn" it into a CD for archival storage. At a later date,
the file can be moved from the CD back to an HP 3000 and
copied back to tape via DISKTAPE.
TAPEDISK is able to read extremely large records from a tape,
much larger than the file system would normally allow you to read.
This means that it can correctly read tapes created with the
large records often used by STORE.
Although TAPEDISK was originally designed to read tapes, if you
use the INDISKLDEV option, you can copy a raw disk drive to a
compressed disk file, suitable for later unpacking by DISKTAPE.
TAPEDISK has no command prompt...it takes its options from the
INFO string. (If you don't use the DESCRIPTION option, you will
be prompted for a one-line description of the input tape.)
TAPEDISK is capable of handling tapes with record sizes that
might have been created by STORE using the MAXTAPEBUF option.
INFO options
--------------------
[no]ALLOCall
BATCH ... set batch flag
BYTES # ... restrict tape reads to the specified
number of bytes. Default: 1/8 MB.
MPE's sendio routine appears to have a bug which causes
very large read requests to sometimes be rejected with an
error ($ffd90071). To avoid this, TAPETAPE defaults to
doing 1/8 MB reads via sendio. This value can be
overridden with -BYTES. If you wanted to copy a tape
created by, for example, ODE : COPYUTIL : BACKUP, you'd
need to say -BYTES 1048576 (or, at least as of MPE/iX 7.5,
-BYTES 4194304).
NOTE: TAPETAPE will let you know if it encounters a record
that was larger than the current -BYTES value, so you don't
have to worry about it silently skipping data!
If you prefer, -MBSPerread may be used as an easier alternative
to -BYTES.
[no]COMPress ... disable/enable data compression for
the output disk file. Note: when reading from
a nine-track tape, using data compression may
prevent the tape from staying in streaming
mode. Default: COMPRESS
[no]DAT (or DDS)
[no]DEBUG1 [no]DEBUG2 [no]DEBUG3 [no]DEBUGCOMPRESS
[no]DEBUGLIMIT [no]DEBUGOPEN [no]DEBUGPERCENT
DESCription "text"
DIALOGEOFS # ... enter interactive dialog after # EOFs
DISKname = newname (default: NEWDISK[#])
(NEWD#### if EOTS > 1)
or: TO newname
[no]EBCDICIN
ECHO text ... echos rest of line to stdlist.
EOFS = #
EOTS = #
ERRors = <quit |="" ignore="" recorderror="" skipfile="" ask="">
... controls how errors are handled.
Default: interactive = ASK
batch = SKIPFILE
EVENONLY ... truncate records of an odd # of bytes
FAKEERROR # ... (internal R&D; testing only)
FROMdev = class/ldev ...specify input tape's device name
FSPACEEOF = # ... # of FSPACES to do after hitting each EOF
FSPACESInitital = # ... # of FSPACES to do after opening tape
HELP ... display this text
IGNOREERRORS ... synonym for: ERRORS = IGNORE
INDISKLDEV # ... input is a raw DISK, on that LDEV
Note: normally not used.
INTAPELDEV # ... input is a raw tape, not opened via
via FOPEN. Note: normally not used.
LABEL volid[,IBM[,expdate]]
LABEL volid[,ANS[,expdate]]
... tells TAPEDISK that the input tape is a
labelled tape. (If there are embedded
blanks, the entire text of the label must
be in double-quotes.)
[no]LARGE ... tells TAPEDISK to create Large Files
...defaults to LAEGE on MPE/iX 6.5 and later,
otherwise to NOLARGE
LDEV # ... combo of INDISKLDEV & INTAPELDEV ...
but TAPEDISK figures out whether the input
LDEV is a disk or a tape.
Note: normally not used.
MAXFiles = # ... stop after copying # files
MAXFILERECs = # ... skip to next EOF after copying # records
MAXRECSFROMTAPE = # ... stop after writing # records
MBSPerread # ... Equivalent: BYTES (# * 1024 * 1024) + 4096
NINEtrack ... input tape is a 9-track tape (tells TapeDisk
to assume NOCOMPRESS and NOSSM)
[no]NULLoutput ... disables writing to NEWDISK
outGBS # or OUTMBS #
... limit output file size to specified #.
OVERLAP ... enable overlapped tape reads using
two buffers (only if SIO in use).
PARTIAL ... after first file, only copy first 4
records of each file (for testing)
[no]REC0 ... REC0 creates a tapedisk file with no
userlabels. NOREC0 uses a userlabel.
[no]RECOVERDDS ... tape was modified by RECOVERDDS
command in FSYS utility.
RECSIZE = #bytes (for output file, not recommended)
SD ... output disk file should be in
STORE-to-disk format
[no]SHOWEOFs ... verbose report hitting EOF/EOT/SSM
[no]SHOWSTore
[no]SIO ... use sendio instead of FREAD for tape
(will read records of up to 131,072 bytes;
without SIO, max read is 16,400 bytes)
SIZES ... display some internal info and stop.
SKIPEOFinitial = # ... number of input EOFs to skip
at start.
SKIPRECS = # ...number of initial output records to
skip
[no]SPLITRecords
[no]SRLABEL ...SRLABEL (default) will report a
40+ line report of an NM STORE tape
header.
[no]SSM ...tells TapeDisk that the tape drive has
(or hasn't) support for Fast Tape search
("setmarks").
STARTPAGE = # ...specify starting spot for raw LDEV copy
STARTSECTOR = # ...specify starting spot for raw LDEV copy
TAPEname = name ...specify output disk name ("NEWDISK")
TAR ...synonym for: EOFS 1 EOTS 1
[no]TESTCOMPRESS1 ...verify compressed data decompresses to
correct (original) size (slow)
[no]TESTCOMPRESS2 ...verify compressed data decompresses to
match original data (slower)
TIMES ...report CPU/elapsed times with progress
[no]UNISYS ... UNISYS tells TapeDisk to look for
Unisys A-Series MCP file labels
UNIX ...stop at first EOF, and write output to
a bytestream style file (for testing)
VERSION ... display version and terminate
[no]ZEROeof
------------------------------
A control-Y should interrupt the reading from tape, and ask if
you want to terminate. An alternative to control-Y is to hit
<break>, :setjcw jcw 1, :continue
At startup, prior to looking at the INFO string, TAPEDISK will
read options from the file "STARTUP.TAPEDISK.ALLEGRO", if it
exists. This file may not be file-equated.
------------------------------
//