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 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.