RT11 <-> PC software.

RT11 is a program designed to run on IBM AT (or similar) computers equipped
with a 1.2 Mb diskette, to read and write diskettes created by RT11 running
on such machines as the Pro 350.  You can copy individual files to and from
RT11 5.25" diskettes, format RT11 diskettes, delete and rename RT11 & MSDOS
files, and copy entire diskette images to and from MSDOS hard disks.

The program runs a lot like RT11 itself; your prompt is ".", and there is a
HELP facility (admittedly, not complete at present - but still quite useful
considering most commands are like their RT11 counterparts).

You can run the program in three ways:

1. RT11/?  {this simply displays information about the program, including a
            list of commands.  Print it by using RT11/? > LPT1 }

2. RT11 command  {this executes the RT11 command, see list below, returning
                  to DOS automatically when finished}

3. RT11    {this keeps prompting you for RT11 commands, until you enter the
            EXIT command}.

POINTS TO REMEMBER:
* You must use a quad-density (1.2Mb) diskette drive; although RT-11 records
  400Kb per diskette, at the same speed as 360Kb PC disks, it uses 80 tracks
  per side.  The software sets the drive to MFM 300kbps 80-tracks; this only
  works if the hardware is moderately compatible (all AT clones I tested are
  sufficiently compatible).
* If you interrupt the program (with Ctrl-Break), the software might not set
  the drive characteristics back to normal.  Most often there is no problem,
  but you may have to reset the computer on odd occassions if subsequent DOS
  access to A: fails.
* The diskette is always referred to within the program as DZ0:, even if you
  are using drive B:. The software works out which drive (if you have 2) can
  accept 80 tracks, and uses that; if you have two such drives, or if the A:
  drive is a 3.5" drive, override the drive selection by using RT11/D=A:
* You can perform some MSDOS functions from withing the software, e.g. MKDIR
  and TYPE; some commands will work with MSDOS or RT11 files... as a rule if
  the filename is preceeded by DZ0: it is RT11, if it contains "\" (or other
  MSDOS-specific names) it is assumed to be an MSDOS file.  With no clues to
  the file, the software usually assumes it is RT11; if in doubt specify the
  full pathname of the file!
* The MSDOS standard io ports are used, so you can redirect input and output
  if you like, but you may like to try the /L option to output help or lists
  of files (etc) to the printer: use RT11/L (or RT11/L=filename) to indicate
  that all commands are to go to a printer, or append /L to the commands you
  want printed.
* The UNDEL facility can "un"delete RT11 files moderately often, provided no
  new data has been written to the disk.
* The diskette-image copy is only useful if you want to move around the RT11
  diskette's data as a single MS-DOS file (it can be transferred to a VAX or
  copied to another diskette or viewed using some tools such as NU or READ).
* Of course, the program DOESN'T run RT11 programs. (Perhaps a later version
  will do that??)
* When copying text files, watch out for the CR/LF problem... RT11 puts just
  a CR (ASCII 13) at the end of each line; MSDOS expects both a CR & LF (10)
  at the end of each line.   There are two ways around this...

  (a) use COPY/ASCII (or RT11/ASCII) to copy files as ASCII, to append a LF
      after each CR in RT11 files copied, and to delete LF's from all MSDOS
      files copied in the reverse direction. Copying stops at ^Z.

  (b) copy the files in the normal way, then (when out of RT11) use CR2CRLF
      or CRLF2CR to convert individual files, e.g. CR2CRLF RtFile DosFile

  NOTE: if you use either of these methods on a non-ASCII file that contains
  any bytes with the value 10 or 13, undesired alterations to the file could
  result! These facilities are for text, not binary or program files.

* This software was produced by Mark Aitchison, Department of Physics,
  University of Canterbury; the software is not public domain, the rights to
  the software are not shared, but you may share the executeable form of the
  program so long as no charge is made and this message is retained.

