1	DGTAPE

DGTAPE reads tapes written by the Data General RDOS or AOS Dump command 
and copy ASCII or binary files to disk on the VAX.  Binary files are 
converted from IBM format to Vax format but a format file of data types 
byte by byte is required.  At this time KMS does not know how to write
the required conversion files for dumping binary data so this utility
is limited to ASCII source files.

DGTAPE is on SYS$UTILITY and may be invoked by the UTL command.
2	Files
	Input files:

	Logical name	File content
        ------------    ------------

	TAPE		Tape written in D.General RDOS or AOS DUMP format.
			Disk files dumped to the tape can be ASCII
			or binary data files; they cannot be entire 
			directories.
			If user selects a binary disk file for
			loading then CONVERT must include a 
			template name that matches the disk file, and the 
			logical name of a format file.

	Files needed if want a  binary file:

	CONVERT		free format ascii file where each line =
			template name(ie. -.ext or name.- or name.ext)
			followed by the logical name of a format file.
			***Note.  KMS has never used this feature and
			***does not know how to use it.
	(logical
	name from 
	CONVERT file)	free format ascii file where each line =
			data type followed by count of that data type,
			(data type = 'BYTE','I*2','I*4','R*4','R*8',
				     'L*2','BEG','END')
			This file gives in ascending byte order the format of
			a binary file to be converted from IBM
			to VAX format.  Types 'BEG', 'END' are used to mark
			the begining and end of a group of data types that
			repeat.
			The count for the group is given after 'BEG', the 
			count after 'END' must be 0.  See sample format
			file.

	Output files:

	Disk file name	Content
	--------------  -------

	(VMS version of
	D.General name	
	from tape)	ascii data or converted binary data
			from each disk file selected for loading by the user
2	Use

To invoke DGTAPE first mount the tape with the following command.

	$MOUNT MSA0:/FOR DUMMY TAPE:

DUMMY may be any valid tape name of six characters or less. It is not
used and the name does not matter.  Then invoke DGTAPE by issuing a

	$UTL DGTAPE
or
	$RUN $SYS$UTILITY:DGTAPE

command.  DGTAPE will then start up the following dialog with you

(1)
Tape format?(1=AOS, 2=RDOS, 3=RDOS-SAO<cr>, 4=RDOS-SAO<lf>):

			Enter number of your choice.  Typically, 2 for most
			normal DG RDOS tapes.
(2)
Tape must have been mounted by command =
MOUNT/FOR/DEN=density device DUM TAPE:
If error message, do MOUNT command and restart program.

Current tape position (0 or last file read + 1):

			If you don't know, enter 0; otherwise enter a 
			file postion.  The 1st file on tape is file 0.
(3)
Tape file = some#
Tape file to load (0=1st file on tape, ^Z to exit):

			Enter file number. Each Tape has 'n' container
			files containing a number of sub files.
(4)
Load all disk files [Y/N]:

			Enter selection.  If "Y" then:

Enter names (one per line, . or ^Z to end,
name can be: -.EXT, NAME.-, or NAME.EXT):

			If you enter just a "." the directory of the
			container file will be displayed.
		
			.  .  .  .  .  .	

Program will read tape and list each disk file name on SYS$OUTPUT.
If a file was selected, file is copied to disk. After reading
the end-of-file, program asks again:

Tape file = some#
Tape file to load?(0=1st file on tape, -1 to exit)   
2	Errors

a) Parity errors while reading the tape.

b) "Line too long" - usually caused by loading a binary file which
   is not listed in file CONVERT.

c) "Tape block type =  ..	but state = ..	so bad block type."
   - usually caused by selecting RDOS instead of RDOS-SAO.

d) Tape runs out to end of reel - tape file to load does not exist on
   the tape.
2	Source_File

	Sources are on KMS$SYSUTLUSR1:[DGTAPE].
	Program obtained from
				Claire Russell
				Columbia University
				Columbia Astrophysics Laboratory
				538 West 120th Street
				New York, New York  10027
				(212) 280-8140 or 280-2819


