Google
 

Trailing-Edge - PDP-10 Archives - tops20tools_v6_9-jan-86_dumper - tools/tenvax/tenvax.mem
There are 3 other files named tenvax.mem in the archive. Click here to see a list.
 
TENVAX - DEC10 <==> VAX/VMS TAPE UTILITY
	May 1982
	
INSTALLATION INSTRUCTIONS
 
o DISTRIBUTED ON DEC-10 MAGTAPE  (1600 BPI)
 
o BACKUP FORMAT  (INTERCHANGE MODE)
 
o 3 FILES:	TENVAX.EXE  - EXECUTABLE IMAGE
			TENVAX.MAC  - MACRO-10 SOURCE CODE
			TENVAX.MAN  - USER DOCUMENTATION
 
o PUT THE TENVAX.EXE FILE ON A SYSTEM AREA WITH A PROTECTION OF 
<155>
 
o PUT THE TENVAX.DOC FILE IN THE HLP: OR DOC: AREA PROTECTED 
<155>
 
o PUT THE TENVAX.MAC FILE IN THE SYSTEM MANAGER'S SOURCE CODE 
LIBRARY PROTECTED <157>.  SOURCE IS INCLUDED FOR REFERENCE ONLY.
 
=================================================================
 
 
		
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
T E N V A X
 
 
DECSYSTEM-10 to VAX Tape Transfer Utility
 
 
User Manual
 
 
 
 
Dave Doxey
DIS Technical Office
Digital Equipment Corp.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
TENVAX
User Manual
 
 
--------------------
TABLE OF CONTENTS
--------------------
 
Introduction ............................ page   2
 
Startup .......................................  3
 
DIRECTORY function ............................  4
 
EXIT function .................................  5
 
READ function .................................  6
 
REWIND function ...............................  7
 
WIND function .................................  8
 
WRITE function ................................  9
	Adding To A Volume Set ......................  9
	Creating A New Volume ....................... 10
 
Changing the Tape Reel ........................ 11
 
HELP assistance ............................... 12
 
Switches ...................................... 14
 
Error Messages ................................ 15
 
Typical Sessions .............................. 19
	DEC10 to VAX. single volume ................. 19
	DEC10 to VAX. multivolume ................... 20
	VAX to DEC10. single volume ................. 21
	VAX to DEC10. multivolume ................... 22
 
 
 
 
 
 
 
 
 
 
 
 
 
--------------------
INTRODUCTION
--------------------
 
The Ten-to-Vax Tape Transfer Utility (TENVAX) is a utility to transfer data 
files in both directions between TOPS-10 and VAX/VMS.  Files are moved from 
the DEC10 disk to VAX/VMS formatted magnetic tapes and from VAX/VMS 
formatted tapes to the DEC10 disk.  TENVAX runs on the DECSYSTEM-10 under 
the TOPS-10 operating system.  Files to be transferred by TENVAX must be in 
ASCII, but may have fixed or variable length records, and may span more 
than one tape volume.  Parameters (such as the tape block size) are given 
sensible default values by the system, with the user able to specify 
different  values if desired.
 
The user interface is question-driven with HELP and CANCEL at every level.  
For each question, the user may enter:
 
1.  an answer to the question, followed by <return>: or
 
2.  just <return> to accept the default (printed in angle brackets; or
 
3.  the word "HELP" followed by <return>, to receive on-line assistance; or
 
4.  the word "CANCEL" followed by <return>, to cancel the function in 
progress.
 
Not all questions have defaults, so in some cases only options 1, 3, and 4 
are available.
 
Once TENVAX's action has been decided by the user's replies, messages are 
printed to describe what the program is doing.  These messages are preceded 
by three dots (...).  errors, when they occur, are indicated by a one-line 
error message giving an error number and a short description of the 
problem.  The error number can be used to reference a more detailed 
description in this manual. 
 
Because TENVAX deals with multivolume tape sets, it will occasionally 
require tape reels to be changed.  Depending on the mode of interaction 
between the user and TENVAX on-line, on-line with Operator Dollar sign, or 
batch), the communication concerning the reel change will take various 
forms.  for a desription of these, see "Changing the Tape Reel".
 
	
--------------------
STARTUP
--------------------
 
Before starting TENVAX, the user must mount a tape on one of the system's 
tape drives.  The mount request (see the TOPS-10 Commands Manual for a 
description of the MOUNT command) must be completed by the operator before 
TENVAX can be used.
 
To start TENVAX, the user types RUN TENVAX from the TOPS-10 monitor.  
TENVAX responds:
 
	Welcome to TENVAX, version 2.0.  Type HELP for assistance.
	Tape drive:
 
The user must tell TENVAX which tape drive to use.  A scratch tape (for 
writing) or a VAX-11 formatted tape (for reading or writing) should already 
be mounted on that drive.  There is no default drive.  (Note: TENVAX does 
not require that the tape on the specified drive be the first volume of a 
volume set.  This is convenient when the user is interested in accessing 
only the later volumes in a multivolume set.)  If the tape drive is ready 
(i.e. a mount request has been completed).  TENVAX automatically rewinds 
the tape and responds:
 
	... at beginning of volume
	TENVAX function:
 
The user chooses a function for TENVAX to perform.  The choices are:
 
DIRECTORY	list the files on the VAX-11 formatted tape
EXIT		return to the TOPS-10 monitor
READ		transfer files from the VAX-11 tape to the TOPS-10 disk
REWIND	rewind the VAX-11 tape to the beginning of the reel
WRITE		transfer files from the TOPS-10 disk to the VAX-11 tape
WIND		wind the VAX-11 tape to the end of the volume set
 
The function name may be abbreviated by its first few letters provided the 
abbreviation is unambiguous.  No distinction is made between upper and 
lower case characters.  there is no default command.
 
The following pages describe the TENVAX functions in more detail.
 
 
	
--------------------
DIRECTORY
--------------------
 
Format:
 
	DIRECTORY
 
	   or
 
	DIRECTORY <file-spec>
 
Description:
 
The DIRECTORY function lists the files in a VAX-11 formatted volume set.  
The <file-spec> limits the DIRECTORY to the files specified.  If no file 
specification is given, DIRECTORY will issue an additional prompt for the 
file specification.  All standard TOPS-10 file specifications are legal, 
with possible wild cards (? and *) and multiple files separated by commas.  
the default file specification is *.* which lists all files.
 
The DIRECTORY function searches the entire volume set from the current tape 
position forward for files which match the specification.  For a 
multivolume set, this will require changing tape reels (unless the 
DIRECTORY is being performed on the last volume only).
 
A DIRECTORY can only be performed with the tape positioned at the beginning 
of a reel (though it need not be the first reel of a volume set).  Hence it 
may be necessary to REWIND the tape before doing a DIRECTORY.
 
Example:
 
	TENVAX function:  DIRECTORY
	Files <*.*>:  *.1st
	... searching tape
	... volume TVXTP2
	PRJECT.LST	22-Mar-81
	TSTDAT.LST	11-Nov-81
	ACCNT.LST	18-Apr-82
	... at end of volume set
 
	
	
 
 
 
--------------------
EXIT
--------------------
 
 
Format:
 
	EXIT
 
 
Description:
 
The EXIT function causes TENVAX to return control the the TOPS-10 monitor.
 
 
Example:
 
	TENVAX function:  EXIT
 
 
--------------------
READ
--------------------
 
 
Format:
 
	READ
 
	 or
 
	READ <file-spec>
 
 
Description:
 
The READ function reads files from a VAX-11 formatted tape (or tape set) 
and transfers them into the user's disk directory.  files to be read must 
be in ASCII format with fixed-length. variable-length, or 
variable-length-VFC records.  The files are written to the TOPS-10 disk in 
standard DEC-10 ASCII format (7-bit characters, 5 characters per word, with 
records separated by carriage-return and line-feed).  As with the DIRECTORY 
function (page 4), if the specification for the files to be read is not 
given with the READ command, READ will issue an additional prompt for the 
specification.  All legal TOPS-10 file specifications are accepted.  The 
default file specification is *.* which reads all files.
 
The READ function searches the entire volume set from the current tape 
position forward for files which match the specification.  For a 
multivolume set, this will involve changing tape reels (unless the READ is 
being performed on the last volume only).  If more than one READ is 
planned, it is strongly suggested that the READs be combined into one 
command (using a multiple file specification), so the volume set need not 
be searched more than once.
 
A READ can only be performed with the tape positioned at the beginning of a 
reel (though it need not be the first reel of a volume set).  Hence it may 
be ncessary to REWIND the tape before doing a READ.
 
** Warning **	Files read from the tape will overwrite already existing 
			files with the same name in the user's disk area.
 
In the example below, a READ is performed which copies four files from a 
two-reel volume set to disk.
 
Example:
 
	TENVAX function:  READ
	Files <*.*>: comput.*, pacman.mac
	... searching tape
	... volume TVSTP2
	... reading comput.for
	... reading comput.rel
	... reading comput.hlp
	$ End of volume reached.  Please mount next volume and type GO.
	GO
	... reading pacman.mac
	... at end of volume set
 
 
 
 
--------------------
REWIND
--------------------
 
Format:
 
	REWIND
 
Description:
 
The REWIND function rewinds the tape to the beginning of a reel.  This is 
often useful before doing a DIRECTORY or READ, if the tape is not 
positioned at the beginning of the reel.  If the tape is already positioned 
at the beginning of the reel, the REWIND has no effect.
 
Note:  REWIND rewinds the tape to the beginning of a current reel only.  
This is unlike WIND, which winds the tape, possibly through several reels, 
until it reaches the end of the volume set.
 
Example:
 
	TENVAX function:  REWIND
	... at beginning of volume
 
 
 
 
--------------------
WIND
--------------------
 
Format:
 
	WIND
 
 
Description:
 
The WIND function causes TENVAX to advance the tape until it reaches the 
end of the volume set.  The purpose of WINd is to prepare for adding new 
files to a multivolume set with WRITE.  See "Adding Files to a Volume Set".
 
Note:  WIND winds the tape, possibly through several reels, until the end 
of the volume set is reached.  This is unlike REWIND, which rewinds the 
tpae to the beginning of the current reel only.
 
Note:  For a multivolume set, WIND may involve changing several tape reels.  
Most of this effort can be avoided by the following technique.  If just 
starting TENVAX, mount the last volume of the volume set on the tape drive.  
Perform a WIND on this volume, and the end of the volume set on the tape 
drive.  Perform a WIND on this volume, and the end of the volume set will 
be reached without having to change tape reels.  If in the middle of a 
TENVAX session, perform a WIND on whatever volume is currently mounted.  
When TENVAX asks for the next volume to be mounted, ignore all the middle 
volumes and mount the last volume of the volume set instead.  WIND will 
then reach the end of the volume set without having to change tape reels 
again.
 
 
Example:
 
	TENVAX function:  WIND
	... winding tape
	... volume TVXTP2
	$ End of volume reached.  Please mount next volume and type GO.
	GO
		... at end of volume set
 
--------------------
WRITE
--------------------
 
Format:
 
	WRITE
 
   or
 
	WRITE <file=spec>
 
 
Description:
 
The WRITE function transfers files from the TOPS-10 disk to a VAX-11 
formatting magnetic tape (or tape set).  Files to be written must be in 
ASCII format, but may have fixed-length or variable-length records.  The 
files are always written on the VAX-11 formatted tape as variable-length 
ASCII files (whether or not the DEC-10 disk file has fixed-length records), 
with ANSI-78 standard labels.  As with DIRECTORY and READ (see above) if no 
file specification are accepted; in addition, the disk file switches listed 
under "Switches" may be used.  There is no default file specification.
 
After the file specification is entered, the user is prompted for a tape 
block size.  The default block size is 8192 characters, a common setting 
used by VAX/RMS.  This default should almost always be used.  In the 
exceptional case when the user needs to enter a different value, the tape 
block size must be a multiple of 4 between 20 and 16376.  In addition it 
must be at least 4 greater than the number of characters in the longest 
record in the files beig written (the extra 4 characters are needed for a 
VMS variable-length record count).  A large tape block size is desireable 
for information to be sorted efficiently on the tape.
 
WRITE appends the given files at the current tape position.  Note this 
means that if the tape is positioned in the middle of the volume set (e.g. 
at the beginning of the third reel in a 4-volume set), all old information 
from that point forward in the volume set will be lost.  To add files to a 
volume set without destroying information already on the tape, follow the 
instructions below.
 
Adding To A Volume Set
~~~~~~~~~~~~~~~~~~~~~~
To add to a volume set, the tape should first be positioned at the end of 
the volume set (that is, at the end of the last file on the last reel of 
the volume set).  This can be done using WIND function, if necessary (it 
can never hurt, and is in fact safest, to do a WIND before writing).  The 
WRITE the files to be added to the volume set.  Note that to position the 
tape at the end of a multireel volume set, only the last reel in the volume 
set need be mounted and positioned (see the WIND command, page 8).  To 
create a new volume set, see the following example.
Example:
 
	TENVAX function, WRITE
	Files:  bigfil.txt
	Block size <8192>:  544
	... writing bigfil.txt
Creating A New Volume Set
~~~~~~~~~~~~~~~~~~~~~~~~~
To create a new volume set, a scratch tape should be positioned at its 
beginning (i.e. at the beginning-of-volume marker).  This is the condition 
just after the tape is mounted, or after a REWIND function is executed.  
Then WRITE the files to be inserted in the new volume set.  The WRITE 
function will proceed as described on page 9, except:
 
Before writing the new volume set, TENVAX will prompt for:
-  the name of the volume set, and
-  the density at which to write the tapes in the volume set.
The default volume set name is 'NONAME', which has no special significance. 
The default tape density is 1600 bits per inch, a common setting.
 
Note:  TENVAX assumes that a new volume set is being written whenever a 
WRITE is performed with the tape positioned at the beinning-of-volume 
marker.  This cannot conflict with situations when the user wants to add 
files to an existing volume set.  In those situations, the tape will always 
be positioned at the end-of-volume marker following the last file in the 
existing volume set (see page 9).
 
Example:
 
	TENVAX function:  WRITE
 	Files:  bigfil.txt
	Block size <8192>:  9000
	... at beginning of volume, assuming new volume set
	Volume set name <NONAME.:  TVXTP2
	Volume set tape density <1600>:  6250
	... writing bigfil.txt
	... at end of volume set
 
----------------------
Changing the Tape Reel
----------------------
 
When performing a DIRECTORY, READ, WIND, or WRITE on a multivolume set.  
TENVAX may require that the tape reel be changed.  This will happen when
 
  1.	DIRECTORY is performed on any but the last reel of the set; or
  2.	READ is performed on any but the last reel of the set; or
  3	WIND is performed on any but the last reel of the set; or
  4.	WRITE is performed and the files being written do not all fit onto 
		one tape reel.
 
Depending on the mode of interaction between TENVAX and the user.  The 
communication concerning the tape reel change takes different forms.  There 
are three possible modes of interaction:  on-line, on-line with Operator 
Dollar Sign, and batch.
 
In on-line mode, all communication from TENVAX goes to the user's terminal.  
When the tape reel is to be changed, the user will receive the message  
 
    $ End of volume reached.  Please mount text volume and type GO.
 
The user is responsible for changing the tape reel and typing GO to TENVAX 
after the change is done.
 
In on-line mode with Operator Dollar Sign, all communication from TENAX 
goes to the user's terminal except messages that begin with a "$" 
character.  Hence the tape-change message goes to the operator.  The 
operator is responsible for changing the tape reel and typing GO to TENVAX 
after the change is done.
 
In batch mode, there is no interactive communication between TENVAX and the 
user.  As with Operator Dollar Sign mode, messages that begin with a "$" 
character go to the operator.  The operator receives the tape-change 
message and is responsible for changing the tape reel and typing GO to 
TENVAX.  Note that since the operator receives and answers the tape-change 
message, GOs should not be inserted in the batch job.
 
--------------------
HELP assistance
--------------------
 
The user may type HELP to receive assistance in answering any TENVAX 
prompt.  The following is a catalog of the HELP answers given to each of 
TENVAX's questions.
 
	Tape drive:  HELP
 
	Specify the logical or physical name for the tape drive you want TENVAX 
to access.  You should have already mounted either a scratch tape (for 
writing) or a VAX-11 formatted tape (for reading or writing) on this 
drive.
 
	TENVAX function:  HELP
 
	Specify the function which you want TENVAX to perform.  Choose from:
	DIRECTORY	list the files on the VAX-11 formatted tape.
	EXIT 	return to the TOPS-10 monitor.
	READ 	transfer files from the VAX tape to your disk directory.
	REWIND	rewind the VAX tape to the beginning of the reel.
	WIND	wind the VAX-formatted tape to the end of the volume set.
	WRITE	transfer files from disk to the VAX-formatted tape.
	Unambiguous abbreviations (e.g. DIR, WR) are accepted.
 
	Files <*.*>:  HELP	(after READ command)
 
	Specify a list of files to read from the VAX tape.  Separate the files 
listed by commas.  The file names may include wild-cards (that is, ? and 
*).
	TENVAX will search for the given files from the current tape position to 
the end of the volume set.  The files, once found, will be inserted into 
your disk directory.  The default file specification *.* reads all files 
from the tape.
 
	Files:  HELP		(after WRITE command)
 
	Specify a list of disk files to write to the VAX tape.  Separate the 
files listed by commas.  The file names may include wild cards (that is, 
* and ?). TENVAX will append the given files at the current tape 
position.  If the tape is positioned at the beginning-of-tape marker.  
TENVAX will assume a new volume set is being created.
 
	Block size <8192>:  HELP
 
	Specify the number of ASCII characters to be written in each tape block.  
This number must be a multiple of 4 between 20 and 16376.  In addition, 
it must be at least 4 greater than the length of the longest record in 
the files to be written.  For data to be compacted efficiently on the 
tape, it is a good idea for the block size to be large compared to the 
record size.  The default of 8192 characters is a common setting used by 
VAX/VMS.
	Volume set name <NONAME>:  HELP
 
	Specify a volume name to be given the new volume set.  Only the first six 
characters are significant.  The default "NONAME" has no special 
significance.
 
	Volume set tape density <1600>:  HELP
 
	Specify the density in bits-per-inch at which TENVAX is to write tapes in 
the volume set.  Possible values are 200, 556, 800, 1600, and 6250.  Note 
that most tape drives will accept only a few of these values.  The 
default density is 1600 bpi, a common setting.
 
	$ End of volume reached.  Please mount next volume and type GO:  HELP
 
	$ In the process of reading from or writing to the VAX-11 formatted 
	$ tape, the end of the current tape reel was reached.  The file being
	$ read or written should be continued on another reel.  Mount that
	$ reel (a scratch tape if you are writing) on the tape drive.  Then
	$ type GO.
--------------------
SWITCHES
--------------------
 
The following is a list of switches that work with the WRITE function when 
specifying disk files.  They have no effect when specifying tape files with 
READ.  To use them, simply attach them to the file specification.  A more 
detailed explanation of their syntax and effects can be found in the 
TOPS-10 Command Manual under BACKUP.
 
	/ABEFORE:<data>	accessed before <data>
	/ASINCE:<data>	accessed since <data>
	/BEFORE:<data>	created before <data>
	/ERNONE	error message if no files match (default)
	/LENGTH:<m:n>	length between m and n blocks
	/OKNONE	no error message if no files match
	/SINCE:<data>	created since <data>
 
 
Examples:
	
	TENVAX function:  WRITE *.MAC/BEFORE:8-JUL-82
	
	TENVAX function:  WRITE VDAT.*/OKNONE
 
	TENVAX function:  WRITE *.*/LENGTH:9:12
 
--------------------
ERROR messages
--------------------
 
The following is a catalog of the possible error messages.  Each error 
message is explained, with possible causes and correction procedures.
 
"System Problems":
	Some errors are labelled as "system problems".  This means that the 
fault is probably not with the user or the tape, but with the hardware, 
the operating system, or the utility itself.  For system problems, it is 
suggested that the user EXIT from TENVAX and try again.  If the same 
error results, consult the operator.  Perhaps the tape drive is bad, in 
which case another tape drive may work.
 
?ERROR [1] Ambiguous function.  Try HELP for assistance.
	In response to the TENVAX function prompt, the user typed a word 
fragment which could be extended to form more than one TENVAX function 
name.  For example, RE could be the beginning of READ or REWIND, and W 
could be the beginning of WRITE or WIND.  Use more letters of the 
function to be performed so there will be no ambiguity.
 
?ERROR [2] No such function.  Try HELP for assistance.
	In response to the TENVAX function prompt, the user typed a word 
fragment which could extended to form any TENVAX function name.  Review 
the legal function names and enter one of them.
 
?ERROR [3] Block size must be a multiple of 4 between 20 and 16376.
	In response to the BLOCK SIZE parameter prompt, the user typed a value 
that was either too small, too large, or not a multiple of 4.  Enter a 
legal value, or accept the default.
 
?ERROR [4] Tape label missing or incomplete.
	While attempting a READ, DIRECTORY, or WIND, TENVAX could not find a 
tape label which it expected.  Either the tape is positioned at an 
improper point, or the wrong tape is mounted, or the tape was 
incorrectly written.  To fix the positioning problem, do a REWIND and 
try again.  To fix the wrong tape problem, EXIT from TENVAX and mount 
the right tape.  To fix the incorrectly written tape problem, rewrite 
the tape.
 
?ERROR [5] Tape label not in VAX/ANSI format.
	While attempting a READ, DIRECTORY, or WIND, TENVAX discovered an 
imporperly written label.  Either the tape is positioned at an improper 
point, or the wrong tape is mounted, or the tape was incorrectly 
written.  To fix the positioning problem, do a REWIND and try again.  To 
fix the wrong tape problem, EXIT from TENVAX and mount the right tape.  
To fix the incorrectly written tape problem, rewrite the tape.
 
	Note:  error [5] will often occur after a disk file access failure (e.g. 
"file not found").  The problem can be corrected by doing two REWINDs.
?ERROR [6] Device is not a magtape drive.
	In response to the TAPE DRIVE parameter prompt, the user gave a device 
name not currently associated with a tape drive.  Either the device name 
is incorrect, or the operator has not yet completed the mount request (a 
tape must be mounted on the given drive before starting TENVAX).  To fix 
the incorrect device name problem, enter the correct device name.  To 
fix the incomplete mount request problem, wait until the mount request 
is completed and try again.
 
?ERROR [7] Could not open i/o channel to tape drive.
	While attemting to perform a READ, REWIND, DIRECTORY, WIND, or WRITE, 
TENVAX tried to access the tape drive and failed.  This is a system 
problem. 
 
?ERROR [8] Could not set industry-compatible mode for tape output.
	While attempting to perform a WRITE, TENVAX tried to signal the tape 
drive to adopt industry-compatible 9-track output mode and failed.  This 
is a system problem.
 
?ERROR [9] Could not set block size for tape output.
	While attempting to perform a WRITE, TENVAX tried to signal the tape 
drive to adopt a legal tape block size and failed.  This is a system 
problem (see page 15).
 
?ERROR [10] Density must be one of 200, 556, 800, 1600, or 6250.
	In response to the VOLUME SET TAPE DENSITY prompt,, the user entered an 
illegal value.  Enter one of the legal values, or accept the default.
 
?ERROR [11] Could not get density information from tape drive.
	While attempting to verify the tape density input by the user, TENVAX 
tried to signal the tape drive to indicate its acceptable density 
settings and failed.  This is a system problem.
 
?ERROR [12] Tape drive not capable of that density.  Try another value. 
	In response to the VOLUME SET TAPE DENSITY prompt, the user entered a 
value which the particular tape drive being used is unable to write at.  
Enter a different value, or accept the default.
 
?ERROR [13] Could not set density on tape drive.
	while attempting to perform a WRITE, TENVAX tried to signal the tape 
drive to adopt a legal tape density and failed.  This is a system 
problem.
 
?ERROR [14] Tape block is incomplete.
	While attempting to perform a READ, TENVAX discovered a block on the VAX 
tape that was shorter than it expected.  The block size information in 
the file header label does not agree with the size of the actual block 
on the tape.  EXIT from TENVAX and try again; of this doesn't work, the 
tape is bad and will have to be rewritten.
 
?ERROR [15] Record too long for tape block.  Try a larger block size.
	While attempting to perform a WRITE, TENVAX discovered a record in one 
of the files being written which was longer than the BLOCK SIZE 
parameter - 4. Do the WRITE again, with the TAPE BLOCK SIZE parameter at 
least 4 greater than the number of the characters in the longest record 
to be written.
 
?ERROR [16] Record too long for internal buffer.
	While attempting to perform a WRITE, TENVAX discovered a record too long 
to fit in the memory space reserved  according to the BLOCK SIZE 
parameter.  This error should not normally occur since an unexpectedly 
long record would cause error [15] first.  This is the system problem.
?ERROR [17] Invalid filename separator.
	The user entered an improperly formed file specification.  File names 
must be listed in the form:  file.extension, file.extension, ... 
file.extension. The "file" part should be no more than 6 characters and 
may consist of letters and digits only, starting with a letter.  The 
"extension" part should be no more than 3 characters and may consist of 
letters and digits only.  The wildcards * and ? may be used anywhere in 
place of a character position in the file name.  Multiple files must be 
separated by commas, with spaces and tabs optional after the commas.  
Redo the READ, WRITE, or DIRECTORY and enter the file specification 
correctly.
 
?ERROR [18] Tape is write-locked.
	While attempting to perform a WRITE, TENVAX discovered that the tape was 
write-locked.  EXIT from TENVAX and have the operator mount the tape 
again, this time write-enabled.  Note that in some cases a write-locked 
tape will result in error [19] instead of error [18].
 
?ERROR [19] Tape i/o operation failed.
	While attempting to perform a READ, DIRECTORY, WIND, or WRITE, TENVAX 
tried to do an i/o operation with the tape drive and failed.  For a 
WRITE, it is possible that the tape was write-locked.  In that case, 
EXIT from TENVAX and have the operator mount the tape again, this time 
write-enabled.  Otherwise, either the tape is bad or the tape drive is 
bad.  If the tape is bad, rewriting the tape will fix the problem.  If 
the tape drive is bad, it is a system problem.
 
?ERROR [20] Parity error.
	While attempting to perform a READ, DIRECTORY, or WIND, TENVAX 
discovered a parity error on the tape.  It is possible that the parity 
error occurred on the channel as information left the tape.  First, EXIT 
from TENVAX and try again.  If this doesn't work, rewrite the tape and 
try again.  If this also fails, it is a system problem.
 
?ERROR [21] Tape block too large.
	While attempting to perform a READ, TENVAX discovered a block on the VAX 
tape that was longer than it expected.  The block size information in 
the file header label does not agree with the size of the actual block 
on the tape.  EXIT from TENVAX and try again; if this doesn't work, the 
tape is bad and will have to be rewritten.
 
?ERROR [25] Unexpectedly reached physical end of tape.
	While attempting to perform a DIRECTORY, READ, WIND, or WRITE, TENVAX 
reached the physical end of the tape.  Either the tape was positioned at 
the improper point, or it was incorrectly written.  To fix the 
positioning problem, do two REWINDs and try again.  To fix the 
incorrectly written tape problem, rewrite the tape and try again.
 
?ERROR [26] Unidentified i/o error.
	This is a system problem.
 
?ERROR [30] File i/o failure for <file> - <reason>
	This is a system problem.
 
?ERROR [40] Disk file access failure (from Lookup) for <file> - <reason>
	The operating system was unable to access the given disk file for the 
reason described.  This error will result, for instance, if a given disk 
file is not found.  The safest way to recover is to EXIT from TENVAX and 
try again.  Other expedients (such as REWINDing the tape and trying 
again) may lead to some strange errors (such as number [5], see above).
?ERROR [41] Disk file access failure (from enter) for <file> - <reason>
	The operating system was unable to access the given disk file for the 
reason described.  As with error [40], the safest way to recover is to 
EXIT from TENVAX and try again.  Other expedients may work but are not 
suggested.
 
?ERROR [42] Could not open i/o channel to disk.
	While attempting to perform a READ or WRITE, TENVAX attempted to access 
the disk and failed.  This is a system problem.
 
?ERROR [43] Binary file writing not supported.  Skipping file.
	While attempting to perform a WRITE, TENVAX discovered one of the 
specified files in binary, not ASCII, format.  As TENVAX cannot transfer 
binary files, it skips the file and performs the rest of the WRITE.
 
	Note: error [43] is fatal in batch processing, and in that case the 
WRITE is not completed.
 
?ERROR [44] Cannot perform READ or DIRECTORY at end of volume set.
	TENVAX was asked to perform a READ or DIRECTORY with the tape positioned 
at the end of the volume set.  The user must REWIND the tape first.
--------------------
Typical Sessions
--------------------
 
A. Transferring Files from the DEC-10 to the VAX, single volume.
 
.RUN TENVAX
 
Welcome to TENVAX, version 2.0. Type HELP for assistance.
Tape Drive:  MTA
... at beginning of volume
 
TENVAX function:  WRITE ACCNT.DAT, ACCNT.LST
Block Size <8192>:
... at beginning of volume, assuming new volume set
Volume Set Name <NONAME>:
Volume Set Tape Density <1600>:
... writing DSK:ACCNT.DAT[100,315]
... writing DSK:ACCNT.LST[100,315]
... at end of volume set
 
TENVAX function:  WRITE NEWACT.DAT
Block Size <8192>:
... writing DSK:NEWACT.DAT[100,315]
... at end of volume set
 
TENVAX function:  EXIT
 
 
When this example begins, the user (call him Bob) has already mounted a 
scratch tape on drive MTA: in preparation for writing some files on the 
tape in VAX-11 format.  He types RUN TENVAX to the TOPS-10 monitor, 
executing the TENVAX utility.  TENVAX says hello, and asks for a tape 
drive.  Bob replies with MTA, the drive he is using.  TENVAX automatically 
rewinds the tape on MTA: and tells Bob he is at the beginning of the tape 
volume.  Then a TENVAX function is requested.  bob enters WRITE ACCNT.DAT, 
ACCNT.LST as he wants to write those two files to the tape.  TENVAX asks 
what block size to use, 8192 being the default.  Bob hits <return> to 
accept the default.  TENVAX, noticing that the tape is at the beginning, 
tells Bob he is starting a new volume set.  Bob accepts the default volume 
name NONAME and tape density 1600 bits per inch.  TENVAX writes the files 
to tape in VAX format, informing Bob of each file as it is written.  When 
the WRITE is complete, Bob is told he is at the end of the volume set, 
which contains the two files he just wrote.  TENVAX asks for another 
function.  Bob decides to write another file, NEWACT.DAT.  This time, since 
the tape is not at the beginning, TENVAX knows that bob is not creating a 
new volume set.  So it asks for the block size (Bob accepts the default 
again) but not for a volume name or tape density.  NEWACT.DAT is added to 
the tape, making three files in all.  Bob is finished, so he tells TENVAX 
to EXIT.
B.  Transferring Files from the DEC-10 to the VAX, multivolume.
 
.RUN TENVAX
 
Welcome to TENVAX, veersion 2.0.  Type HELP for assistance.
Tape Drive:  MTA
... at beginning of volume
 
TENVAX funtion:  WRITE BIGFIL.TXT
Block Size <8192>:
... at beginning of volume, assuming new volume set
Volume Set Name <NONAME>: DEC1
Volume Set Tape Density <1600>:
... writing DSK:BIGFIL.TXT[100,315]
$ End of volume reached.  Please mount next volume and type GO.
GO
$ End of volume reached.  Please mount next volume and type GO.
GO
... at end of volume set
 
TENVAX function: EXIT
 
 
When this example begins, the user (call her Sue) has already mounted a 
scratch tape on drive MTA: in prepartion for writing her very large file 
BIGFIL.TXT to tape in VAX format.  She types RUN TENVAX to execute the 
TENVAX utility.  TENVAX asks for a tape drive.  She replies MTA, the tape 
drive she is using.  TENVAX automatically rewinds the tape on drive MTA: 
and tells Sue she is at the beginning of the volume.  Then a TENVAX 
function is requested.  Sue responds WRITE BIGFIL.TXT to write her large 
file to tape.  TENVAX asks for the block size.  Sue accepts the default of 
8192 characters.  TENVAX notices that the tape is at the beginning and 
informs Sue that she is starting a new volume set.  Sue chooses the volume 
name DEC1 and  accepts the default tape density of 1600 bits per inch.  
TENVAX tells Sue it is writing her file to tape.  When the first reel of 
tape is exhausted, TENVAX types a message that the end of the volume has 
been reached and that the next volume (another scratch tape) should be 
mounted so the file can be continued.  This message goes to Sue unless she 
is using Operator Dollar Sign or running batch, in which case it goes to 
the operator.  When the second volume is exhausted, yet another volume is 
requested in the same way.  TENVAX is able to complete BIGFIL.TXT on this 
volume, so it tells Sue she has reached the end of the volume set.  The 
volume set consists of three volumes but only one file.  this is exactly 
what Sue wanted, so she tells TENVAX to EXIT.
C.  Transferring Files from the VAX to the DEC-10, single volume.
 
.RUN TENVAX
 
Welcome to TENVAX, version 2.0.  Type HELP for assistance.
Tape Drive:  MTA
... at beginning of volume
 
TENVAX funtion:  READ *.*
... searching tape
... volume VAX11
... reading PEACH.LST
... reading ORANGE.LST
... reading PLUM.DAT
... at end of volume set
 
TENVAX function: EXIT
 
 
When this example begins, the user (call him Bob) has already taken a tape 
he wrote from the VAX and mounted it on drive MTA: in preparation for 
reading it in on the DEC-10.  He types RUN TENVAX, executing the TENVAX 
utility.  TENVAX asks for a tape drive, and Bob enters MTA.  TENVAX 
automatically rewinds the tape on drive MTA: and tells Bob he is at the 
beginning of the volume.  When a TENVAX function is requested, Bob says 
READ *.* to read all the files on the tape.  TENVAX begins to search the 
tape.  It finds that the volume name of the tape is VAX11 and informs Bob.  
It then finds the first file on the tape, PEACH.LST.  This is followed by 
ORANGE.LST and PLUM.DAT.  When Bob is told that he is at the end of the 
volume set, all three files have been read from the tape and inserted in 
bob's disk directory.  Bob is happy, so he tells TENVAX to EXIT.
D. Transferring Files from the VAx to the DEC-10, multivolume.
 
 
.RUN TENVAX
 
Welcome to TENVAX, veersion 2.0.  Type HELP for assistance.
Tape Drive:  MTA
... at beginning of volume
 
TENVAX funtion:  READ *.*
... searching tape
... volume JUNKFD
... reading PIZZA.TXT
... reading HOTDOG.TXT
$ End of volume reached.  Please mount next volume and type GO.
GO
... reading ICECRM.TXT
$ End of volume reached.  Please mount next volume and type GO.
GO
... at end of volume set
 
TENVAX function: EXIT
 
 
When this example begins, the user (call her Sue) has already taken the 
first tape of a multivolume set she wrote from the VAX and mounted it on 
tape drive MTA: in preparation for reading it in on the DEC-10.  She types 
RUN TENVAX to execute the TENVAX utility.  TENVAX asks for a tape drive.  
Sue replies MTA, the tape drive she is using.  TENVAX asks for a TENVAX 
function.  Sue replies READ *.* to read all the files in the volume set.  
TENVAX begins searching the tpae.  It finds that its volume name is JUNKFD, 
and informs Sue.  It then finds the first file on the tape, PIZZA.TXT.  The 
next file on the tape is HOTDOG.TXT.  HOTDOG.TXT isn't finished when the 
end of the tape volume is reached, so TENVAX sends a message to mount the 
next volume.  This message goes to Sue unless she is using Operator Dollar 
Sign or running batch, in which case it goes to the perator.  TENVAX 
finishes another change of tape reels.  ICECRM.TXT  turns out to be the 
last file in the volume set.  When it is finished, Sue is told that she is 
at the end of the volume set.  Three files have been transferred into her 
disk directory.  She has nothing else to do, so she tells TENVAX to EXIT.