home *** CD-ROM | disk | FTP | other *** search
/ kermit.columbia.edu / kermit.columbia.edu.tar / kermit.columbia.edu / bin / z80mu310.arc / Z80MU310.TXT < prev   
Text File  |  1986-04-14  |  5KB  |  127 lines
  1.  
  2.  
  3.  
  4.                                 Z80MU Information
  5.  
  6.  
  7.                     release 3.10 of Z80MU.EXE, dated 3/14/86
  8.  
  9.  
  10.      Z80MU is a Z80 and CP/M 2.2 Emulator which runs on the IBMPC. It was
  11.      written by Joan Riff for Computerwise Consulting Services. We have used
  12.      it for the various projects that we needed it for, and rather than have
  13.      the thing collect dust on the shelf we have decided to release it to the
  14.      public domain so that it may find its way into the hands of whoever
  15.      could use it.
  16.  
  17.  
  18.  
  19.  
  20.      WE NEED YOUR HELP!!!
  21.  
  22.      Please help the Public Domain world in the following ways:
  23.  
  24.           1) Feel free to distribute Z80MU310.ARC (the original Emulator ARC
  25.      file), along with this file (Z80MU310.TXT). Don't change their names. Do
  26.      not try to rebuild an ARC file from the component files unless you are
  27.      very careful. We much prefer that you keep a copy of the original ARC
  28.      file around for uploading. If you upload it to a bulletin board system,
  29.      please be VERY careful to make sure that a good upload is obtained. To
  30.      be safe, download the thing back (under a different name) and use ARC to
  31.      expand it. If you get a good expansion, then you know that the upload
  32.      was good. WE HAVE SEEN MANY GARBAGED (BAD CHECKSUM) COPIES OF THE ARC
  33.      FILE ON VARIOUS BULLETIN BOARDS. This hurts everybody. If you discover a
  34.      garbaged version of the ARC file on a bulletin board, please notify the
  35.      Sysop, and upload a good version.
  36.  
  37.           2) Keep your eyes open for new releases of the Emulator.
  38.  
  39.           3) Please forward bug reports to us (on disk). We'll fix 'em if and
  40.      when we can. This gives us a better version for our own continued use,
  41.      and we'll release the fixed one to various bulletin boards. We have
  42.      already received several "Hey! This CP/M program doesn't work!" reports
  43.      from users, which have resulted in the improvement of the Emulator. It
  44.      now runs a much larger universe of CP/M software, thanks to feedback
  45.      from the field.
  46.  
  47.  
  48.  
  49.  
  50.      FILES IN THE .ARC FILE
  51.  
  52.      The files in the ARC file are as follows:
  53.  
  54.      Z80MU    EXE    97696   3-25-86   2:56a The Emulator
  55.      Z80MU    DOC   203232   4-11-86   2:44a The User's Guide
  56.      820INIT  COM      640  11-24-85  12:02a RESOURCE test file (object)
  57.  
  58.      820INIT  CTL     3443  11-24-85   8:14p Control file for 820INIT.COM
  59.      820INIT  ASM     6373  11-24-85   8:15p Resultant source code
  60.      820INIT  PRN    20608  11-24-85   8:17p Resultant assembly listing
  61.  
  62.  
  63.  
  64.  
  65.  
  66.      IMPLEMENTATION HINTS
  67.  
  68.      This new version runs a much wider universe of CP/M software than the
  69.      previous ones did.
  70.  
  71.      When in doubt, configure your CP/M program to use a VT52 (Heath/Zenith
  72.      H-19 or Z-19) terminal. Then use the Emulator command "TERMINAL BOTH" to
  73.      send BIOS and BDOS console I/O through the built-in VT52 emulator. Once
  74.      you have things figured out, you can put the proper "TERMINAL" command
  75.      in your AUTOEXEC.Z80 file.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.      STICKY WICKETS
  82.  
  83.      If you STILL can't get your CP/M program to run under the Emulator,
  84.      then:
  85.  
  86.           1) It may not be "portable" enough. Sorry, we can't work
  87.           miracles.
  88.  
  89.           2) It may use a quirk of CP/M that we don't currently (but may
  90.           in the future) support. Send us a disk containing the offen-
  91.           ding program, and a writeup of how to reproduce the problem.
  92.           We may be intrigued enough to debug your package. This may
  93.           result in an improved Emulator which can handle your program.
  94.           Then again, it may not. In either case, we destroy copies of
  95.           your CP/M program once we're done debugging it.
  96.  
  97.  
  98.  
  99.  
  100.      THINGS FIXED WITH 3.10:
  101.  
  102.           1) BDOS Func 10/0Ah is now done entirely by Z80MU (used to
  103.           call DOS). RETURN no longer required.
  104.  
  105.           2) VT52 clear-screen code is ESC E, not ESC F.
  106.  
  107.           3) FCB fields more closely emulated.
  108.  
  109.           4) Word of zeroes is put on stack prior to Transient entry at
  110.           0100h. Bug in Lattice used to store zero word "elsewhere..."
  111.  
  112.  
  113.           5) Keypress fights between PCDOS and VT52 emulator resolved.
  114.           The VT52 emulator won.
  115.  
  116.           6) Disassembler (broken in 3.00) is now fixed.
  117.  
  118.           7) CP/M results come back in HL as well as A-reg.
  119.  
  120.  
  121.      Have fun!
  122.  
  123.              Computerwise Consulting Services
  124.              P.O. Box 813
  125.              McLean, VA 22101
  126.              (703) 280-2809
  127.