1 TPC
 
		     TPC - Fast Tape Copy


 This  program  will copy a complete magtape to a Files-11 disk
 and  store it there in a special image mode, from which it can create
 one or more copies of the tape (must faster than FLX ever could).

 The command format is:-

	TPC Output-filespec=Input-filespec<switches>

 where one  of the 'filespecs' must be a magtape device (e.g. MT:) and
       the other the name of an image file on disk.

	For a description of switches type AID TPC SWITCHES
 
	For a description of errors   type AID TPC ERRORS
 
	For a description of a switch type AID TPC XX
	where XX is the 2-character switch
 
2 SWITCHES
       /BL:nnnn - Specifies  an  initial  allocation specification for disk.
       /SA:nnnn - Specifies  a  secondary allocation specification for disk.
       /CO      - Specifies that the disk file is to be contiguous
       /HD      - Indicates High Density (1600 BPI) tape is to be written.
       /NR	- Specifies NO positioning of the tape prior to starting.
       /VE	- Verify the transfer after the copy.
       /CM	- Compare the tape with an existing TPC file.
       /SC:nnnn - Sets tape characteristics to nnnn  (octal).
       /AN	- Specifies possible ANSI format tape.
       /EB	- Specifies possible EBCDIC format tape.
       /RT	- Use RT11 type "ANSI" labels.
       /ER	- Specifies that TPC will ignore errors on tape.
       /FR	- Rewind the tape after copying to it.
       /TR	- Read a disk to a container file as though it were a tape.
       /TW	- Write a container file to a disk as though it were a tape.
       /SZ:low:high - Switch sets the device size for /TR, /TW, and /IM.
       /LO:low:high - Specifies the starting physical block of the disk.
       /CT	- Allows conTRol QIO's to occur even if /IM, /tr, or /TW
       /IM:low:high:blkfactor - Copy in image mode device to device
       /FL:filnam - Write FLX format lable record.
       /NI	- Allows /IM copies to read a disk 1 block at a time.
       /NO	- Allows /IM copies to write a disk 1 block at a time.
       /HE	- This switch causes BIGTPC to print a help message
2 ERRORS
 1.  TPC -- Disk I/O error.  Code = n
     TPC encountered an error while reading from/writing to the disk.
 2.  TPC -- Magtape I/O error.  Code = n
     TPC encountered an error while reading from/writing to the magtape.
 3.  TPC -- Command line input error
     TPC encountered an error in reading the command line.
 4.  TPC -- Command line syntax error
     TPC encountered an error when trying to parse the command line.
 5.  TPC -- Invalid switch
     The command line contained a bad Switch or file specification.
 6.  TPC -- Open error on output file
     TPC encountered an error trying to open an output file.
 7.  TPC -- Open error on input file
     TPC encountered an error trying to open an input file.
 8.  TPC -- Specify 1 file & 1 magtape device
     You must specify one magtape device and one disk device.
 9.  TPC -- Starting Verify pass.
     The /VE switch was specified and the compare operation has started.
 10. TPC -- Compare OK.
     The compare operation specified by the /VE or /CM switches was successful.
 11. TPC -- Compare error.   Files are different.
     The compare operation specified by either the /VE or /CM failed.
 12. TPC -- /VE and /CM Not valid at same time.
2 BL
       /BL:nnnn - Specifies  an  initial  allocation specification for
                  the image file if a disk is the output device.
		  Defaults to 200.

2 SA
       /SA:nnnn - Specifies  a  secondary allocation specification for
                  the image file if a disk is the output device.
		  Defaults to 50.

2 CO
       /CO      - Specifies that the disk file is to be contiguous

2 HD
       /HD      - Indicates High Density (1600 BPI) tape is to be
		  written. (For TE16, tape is read at the proper density
		  automagically.) This permits a container file from one
		  density to be written out in another.

2 NR
       /NR	- Specifies NO positioning of the tape prior to the
		  start of copying. This will allow TPC to merge
		  several backup collections on a single output tape
		  if used with care.

2 VE
	/VE	- Verify the transfer.   After the copy (in either direction)
		  is made, the tape is rewound and both the tape and file
		  are read and compared.

2 CM
	/CM	- Compare the tape with an existing TPC file.   Note that
		  the "transfer" can be in either direction.   That is, the
		  tape specification can be on either side of the equal sign.

		  *** NOTE ***   The /VE & /CM options are only implemented
		  for "vanilla" tape/disk/tape transfers.   Use of these
		  switches with any of the "exotic" copy modes is not
		  supported and may cause undesired effects.   This restriction
		  may be removed at a future date.

		After the end of a copy, TPC will write 4 EOF records and
		backspace so that it will be positioned after the first
		EOF on tape. This will ensure that a second backup
		done with the /NR switch will correctly copy onto a FLX
		tape in readable fashion.

2 SC
       /SC:nnnn - Sets tape characteristics to nnnn  (octal), to allow read or
                  write of tapes with even parity, 556BPI, etc. If the /HD
                  switch is used, the high density bit is ORed in with the
                  nnnn value specified in the /SC switch.

2 AN
       /AN	- Specifies possible ANSI format tape. If TPC sees this switch
		  it will look for ANSI label records and permit copies
		  even where the tape has null files and hence double EOF
		  before the real end of tape. Only 80 byte records are
		  examined and EOFs are treated specially only between
		  HDR2 and EOF2 (or EOV). The headers are assumed to be in
		  ASCII unless the switch /EB is given, in which case they
		  are assumed to be in EBCDIC. If the tape is not really
		  an ANSI format tape, the TPC copy operation is not
		  changed. Thus the /ANsi switch may be used on a tape of
		  unknown format.
			The default is /AN, and to force BIGTPC NOT to
		  look for ANSI labels (looking normally only at 80 byte
		  records unless the /RT subswitch is used), use the /-AN
		  switch.

2 EB
       /EB	- This subswitch of the /AN switch forces on ANSI label
		  checks but causes TPC to look for EBCDIC header labels
		  rather than ASCII. Note that TPC looks for either ASCII
		  or EBCDIC, not both. The default is not to look for
		  ANSI labels and end copy at double EOF; the /AN or /EB switch
		  settings allow some modifications to this.

2 RT
       /RT	- Use RT11 type "ANSI" labels. RT11 may not make label
		  records  80. bytes long, and if you have RT11 tapes, the
		  ANSI checks will normally ignore the RT11 ANSI labels
		  unless you use this switch. It causes BIGTPC to ignore
		  length of records and checks everything to see if it is
		  an ANSI label record. It is not a very good default because
		  it probably can be fooled easily but may be needed for
		  RT11 tapes.

2 ER
       /ER	- Specifies that TPC will ignore errors on tape. This
		  specifically means that all errors except EOT/EOV/EOF
		  will be ignored. This is quite useful for recovering
		  data from tapes which are old and full of errors, or for
		  writing an output to a tape with bad spots (though
		  it won't cure bad spots and this method of writing
		  anyway is not necessarily a good idea...).

2 FR
       /FR	- Rewind the tape after copying to it. Note the /NR switch
		  applies to BEFORE the tape is used and inhibits positioning
		  at that time. The /FR switch will rewind the tape AFTER
		  writing to it.

2 TR
       /TR	- This switch allows BIGTPC to read a disk to a container
		  file as though it were a tape. It implies BIGTPC should
		  act as though the input device were a tape even if it
		  is not. BIGTPC will need to know the size to copy (defaults
		  to 494. blocks, the size of an RX01) and the start block
		  number (defaults to 0,0) as octal numnbers in the form
		  low:high (see /SZ and /LO switches). The input device is
		  copied 1 block at a time. The normal "control" features
		  like density, rewind, etc., are suppressed UNLESS the
		  /CT switch is used. Their effect is not likely to be
		  meaningful.

2 TW
       /TW	- This switch allows BIGTPC to write a container file to
		  a disk as though the disk were a tape (on the output side
		  of the command line). It is the inverse of the /TR switch
		  and needs the /SZ and /LO information too.

2 SZ
       /SZ:low:high - This switch sets the device size for /TR, /TW, and
		  /IM copies, in 2 words of block counts. Note the number
		  of blocks is given, not the last block number, so a disk
		  with 494 blocks is specified as /SZ:494., the high size
		  defaulting to 0. Default value is /SZ:494.:0.

2 LO
       /LO:low:high - This switch specifies the starting physical block
		  of the disk to begin transfer from in /TR and /IM, or
		  transfer to in /TW cases. This allows you to move blocks
		  around or to copy only parts of a disk. The default is
		  0:0, so you won't need to use /LO often unless you intend
		  to copy partial volumes.

2 CT
       /CT	- This switch allows control-type QIO's to occur even if
		  /IM, /TR, or /TW are specified. These QIO's do things
		  like rewind, write endfile, space forward or back,
		  and set density as well as attach the LUNs. It is not
		  very meaningful for /TR or /TW unless you have a strange
		  device that nevertheless is really a tape (and it's not
		  certain you can emulate it properly this way anyhow). For
		  /IM copies, it allows a tape to be the output device
		  and to receive a blocked copy of a device in format
		  independent ways while still setting density, rewinding,
		  etc. Note the control QIOs are not error checked so if
		  you try to rewind a disk, it'll not hurt you.

2 IM
       /IM:low:high:blkfactor - This switch allows BIGTPC to copy data
		  in image mode directly from one device to another. It
		  does not operate AST driven in this mode as it does in
		  all others, but uses all buffers as one large I/O buffer
		  permitting I/O transfers of up to about 72. blocks at
		  a time. The low:high arguments are the block number
		  to begin the output transfer to on the output device
		  (/SZ specifies the length in blocks to move), and the
		  "blkfactor" argument is the number of blocks to
		  be transferred at each QIO$ to the output device.
		  This defaults to 8. so that if the output device is
		  tape, the buffers will be 4096. bytes long. If you
		  specify a bigger blocking factor than BIGTPC can
		  handle, it will just use its maximum. Normal operation
		  will not issue any "write-EOF" operations, but if tape
		  is the output device, the /CT switch will permit
		  these controls to be done so the resulting tape will
		  work (and the /FR switch, the /HD switch, and the
		  /SC switch will work).

2 FL
       /FL:filnam - This  switch works only with the /IM and /CT
		  switches and will have no effect unless BOTH of these
		  are specified. It causes BIGTPC to write a standard
		  DOS format (FLX format) label record before it writes
		  an image file on tape, using "filnam" (up to 6 characters)
		  as the filename. The full file specification is
		  [1,1]filnam.OLB with standard DOS protection and a creation
		  date of 00-JAN-70. This permits the image file to co-exist
		  on a FLX tape (.OLB is the extension chosen since FLX will
		  copy it in image mode). FLX can skip the nonstandard
		  file and make directories, read, or write on the tape,
		  allowing it to contain other interesting programs (perhaps
		  a copy of BIGTPC to read the images with, for instance).
		  Also, multiple files may be more easily kept on the tape.
		  On input, you must skip this record on tape prior to
		  inputting the file.
            If /ER is specified, zero byte reads will NOT terminate
		  copies (so sizes better be right!) and lengths copied will
		  be calculated from given block factors, not from returned
		  actual byte counts.

2 NI
       /NI	- This switch ("Nibble In") allows /IM copies to read a
		  disk 1 block at a time instead of using big QIOs of "blkfct"
		  blocks at a time. Thus, if there is a bad disk block, data
		  on following blocks will not be lost. See the /IM switch doc.
		  for interaction with /ER.

2 NO
       /NO	- This switch ("Nibble Out") allows /IM copies to write a
		  disk 1 block at a time. It is supplied also to aid in writing
		  to a disk with bad blocks, guaranteeing that not more than 1
		  block's data will be lost. Its interaction with /ER is as that
		  of /IM. The /NI and /NO switches apply only to the /IMage
		  mode copies of BIGTPC.

2 HE
       /HE	- This switch causes BIGTPC to print a help message
		  summarizing the action of all of its switches and
		  giving the defaults for the more important ones.
