COMMAND SPECIFICATIONS
	
							TAPE
	
	
The TAPE command allows users to read and write tapes in various foreign
formats.  In order to use this command, the tape to be read or written
must be mounted as a foreign volume.  There are three basic tape formats
available:  dump format, blocked format, and line format.
	
Dump format is essentially paper tape image.  The tape blocks are, usually,
of fixed length.  Logical records are terminated by a carriage return and
a line feed.  By using the /DEC10 switch, the user may match the DEC 10
ASCII word dump format.
	
Blocked format contains one or more fixed length records per tape block.
By using the /EBCDIC switch, tapes may be made in an IBM compatible form.
	
Line format contains one variable length logical record per tape block.
	
		*******  CAUTION:  *******
		On output, any record less 
		than 14 bytes is padded to 
		that size.  On input, any
		record less than six bytes
		is ignored.
		**************************
	
	
FORMAT 1
	
	____PDS> TAPE/IN[:dev:filenum]/DUMP[/qualifiers-1] newfile [qualifiers-2]
	
or
	
	____PDS> TAPE/IN[:dev:filenum]/DUMP[/qualifiers-1]
	_____FILE>newfile [/qualifiers-2]
	
where /qualifiers-1 can be:
	
	/DEC10		Tape is in DEC 10 ASCII word dump format.
	
	/PE		Tape is at 1600 bpi (phase encoded).
	
/qualifiers-2 can be ___one of two:
	
	/STRIP		Trailing blanks, tabs, and nulls are stripped
			from the input.
	
	/LENGTH:length	Output is to be in fixed length records.  If
			necessary, record will be truncated or padded
			with blanks.
	
If neither /STRIP or /LENGTH is specified, records will be written as they
appear in the input file.
	
dev is the magnetic tape device, and must be either MM0 ... MM7 or MT0 ...
MT7.  The default device is MM0.  This program does not support seven track
drives.
	
filenum refers to the absolute file number on the tape.  If not specified,
the tape operation begins wherever the tape is currently placed.  If
specified, the tape rewinds and spaces to the specified file number.
	
	
FORMAT 2
	
	____PDS> TAPE/IN[:dev:filenum]/LENGTH:len[/qualifiers-3] newfile [/qualifiers-2]
	
or
	
	____PDS> TAPE/IN[:dev:filenum]/LENGTH:len[/qualifiers-3]
	_____FILE>newfile [/qualifiers-2]
	
where /qualifiers-3 may be:
	
	/EBCDIC		Convert EBCDIC to ASCII codes.
	
	/PE		Tape density is 1600 bpi.
	
/qualifiers-2 is the same as for format 1.
	
	
FORMAT 3
	
	____PDS> TAPE/IN[:dev:filenum]/LINE[:len][/qualifiers-3] newfile [/qualifiers-2]
	
or
	
	____PDS> TAPE/IN[:dev:filenum]/LINE[:len][/qualifiers-3]
	_____FILE>newfile [/qualifiers-2]
	
where len is the maximum line length.
	
	
FORMAT 4
	
	____PDS> TAPE/OUT[:dev:filenum]/DUMP:size[/qualifiers-4] oldfile
	
or
	
	____PDS> TAPE/OUT[:dev:filenum]/DUMP:size[/qualifiers-4] oldfile
	
where /qualifiers-4 may be:
	
	/DEC10		Output is to be in DEC 10 ASCII word dump format.
	
	/NOTAB		Tabs are to be converted to appropriate number
			of blanks prior to writing.
	
	/STRIP		Strip trailing blanks and tabs.
	
	/LENGTH:len	Output fixed length records.  /STRIP and /LENGTH
			may not be used together.
	
	/PE		Tape is to be written at 1600 bpi density.
	
size is the physical tape record size.  If the /DEC10 qualifier is used, size
may be omitted and will be set to 640 bytes.
	
	
FORMAT 5
	
	____PDS> TAPE/OUT[:dev:filenum]/BLOCK:fact/LENGTH:len[/qualifiers-5] oldfile
	
or
	
	____PDS> TAPE/OUT[:dev:filenum]/BLOCK:fact/LENGTH:len[/qualifiers-5]
	_____FILE>oldfile
	
where /qualifiers-5 may be:
	
	/NOTAB		Convert tabs to spaces before output.
	
	/EBCDIC		Convert to EBCDIC codes.  If this is
			selected, /NOTAB is automatically selected.
	
	/PE		Tape density is 1600 bpi.
	
fact is the number of records of length len to pack into a physical tape
block.
	
	
FORMAT 6
	
	____PDS> TAPE/OUT[:dev:filenum]/LINE[/qualifiers-6] oldfile
	
or
	
	____PDS> TAPE/OUT[:dev:filenum]/LINE[/qualifiers-6]
	_____FILE>oldfile
	
where /qualifiers-6 may be:
	
	/NOTAB		Tabs are converted to blanks before output.
EXAMPLES
	
1.	____PDS> TAPE/IN::1/DUMP/DEC10 LIGHT.FTN/STRIP
	
	This example will read the first file of a tape produced by a DEC10,
	strip trailing blanks and tabs from the lines, and store them in
	the file SY:LIGHT.FTN.
	
2.	____PDS> TAPE/IN/LENGTH:80/EBCDIC TEST.DAT/STRIP
	This example will read in the EBCDIC tape at the current file with
	blocks containing 80 byte records, strip trailing blanks, and store
	the results in SY:TEST.DAT.
	
3.	____PDS> TAPE/IN:MT3:5/LINE:72 CL:
	
	This example will read in the fifth file of the tape loaded on MT3. 
	Each tape record will be truncated to no more than 72 characters.
	The output is to the default listing device.
	
	
	/EBCDIC		Convert to EBCDIC codes.  If this is
			selected, /NOTAB is automatically selected.
	
	/STRIP		Strip trailing blanks and tabs before output.
	
	/PE		Tape density is 1600 bpi.