home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / JSAGE / ZSUS / PROGPACK / Z33-ZASM.LBR / Z33ZASM.DZC / Z33ZASM.HLP
Text File  |  2000-06-30  |  4KB  |  110 lines
  1. :
  2.  
  3. Documentation for conversion of ZCPR33 for assembly by ZASM
  4.  
  5.                                                         05/21/87
  6.                                                         Michal Carson
  7.  
  8. These files are gathered here and distributed in order that the
  9. most popular command processor replacement for eight-bit machines
  10. might be compiled by a public domain assembler.  The people of
  11. Echelon, Inc. are good enough to distribute the source code of
  12. ZCPR v3.3 free of charge over public bulletin boards; it is
  13. important that an assembler for those files be as easily
  14. accessible.
  15.  
  16. The Cromemco Macro Assembler v3.04, popularly known as ZASM, is
  17. one of the most dependable and widely circulated Zilog mnemonic
  18. assemblers (in spite of the lack of original documentation).  
  19.  
  20.  
  21.  
  22.  
  23. With ZCPR version 3.3, Jay Sage and Echelon made an attempt to
  24. produce code that was not compiler-specific.  This release has
  25. achieved that goal better than any previous official or unofficial
  26. release of the command processor.  Thus, the task of conversion
  27. for ZASM was simplified.
  28.  
  29. There remain in the body of the code only a few unrecognized
  30. pseudo-ops and a handful of over-long labels.  A Zex script
  31. (compatible with Ex14 and maybe with its successors) is included
  32. here to change the pseudo-ops and shorten the labels.  It will
  33. require Eric Gans' FinRep24 which is also available in the public
  34. domain.  
  35.  
  36.  
  37. The script and FinRep will make a copy of ZCPR33.Z80 on the first
  38. pass; subsequent passes of FinRep will operate on the new file,
  39. Z33ZASM.Z80.  This will require at least 372K of disk space (three
  40. copies of the source code).  The intent is to preserve ZCPR33.Z80
  41. at least until the modifications are complete.  If this space is
  42. not available, rename ZCPR33.Z80 to Z33ZASM.Z80 and edit the
  43. script (delete the reference to ZCPR33.Z80 in the first line)
  44. before you begin.  If you are limited to single-sided floppy
  45. drives, FinRep can be instructed to copy the file from one drive
  46. to the other as it runs; you'll have to add the drive and filename
  47. specifiers in the script file.  The command line is
  48.  
  49.     B0>zex z33zasm
  50. or    B0>ex z33zasm
  51.  
  52. The operation of FinRep requires several passes through a 124K
  53. file.  This will take about ten minutes on a floppy disk.  A hard
  54. disk or ram disk would be faster if one is available.  Remember,
  55. though, that Zex may conflict with co-processors used as ram
  56. disks.  
  57.  
  58.  
  59.  
  60.  
  61. The Z33MAC.LIB, and Z33HDR.LIB included here make it possible for
  62. ZASM to assemble the new version 3.3 command processor.  These
  63. should be substituted for the header and macro files distributed
  64. with the command processor.  The macro file will also work with
  65. the 3.3-specific resident command and flow control packages.
  66.  
  67. For those not experienced with ZASM, just to get you moving a
  68. little faster, if the source file, libs and ZASM are on the B: 
  69. drive use this command line:
  70.  
  71.     B0>zasm z33zasm.bbz hex
  72.  
  73.  
  74.  
  75.  
  76. Assembling the RCP and FCP segments is treated by a seperate batch
  77. file.  Z33SEG.SUB, like Z33ZASM.SUB, will drive FinRep to convert
  78. a few pseudo-ops and labels so that Z33FCP and Z33RCP are
  79. acceptable to ZASM.  Most of the problems, though, involve
  80. multiple definitions and the duplication of effort between
  81. SYSDEF.LIB and Z3BASE.LIB.  This is quickly remedied with a little
  82. editing.
  83.  
  84. For efficiency, edit the base lib and leave sysdef alone.  Several
  85. equates must be hidden from the assembler by preceding them with a
  86. semi-colon; they are then said to be "commented out."  The
  87. definitions ("equates") to be hidden are listed below.  They may
  88. appear in uppercase or lowercase in your Z3BASE.LIB, or they may
  89. not appear at all.  If your word-processor's search function
  90. cannot find them, neither will the assembler; that's fine.  The
  91. labels here are shown already commented out.  
  92.  
  93.  
  94.  
  95.  
  96. ;false    equ    0 
  97. ;true    equ    not false 
  98. ;i8080    equ     false 
  99. ;zas     equ     false 
  100. ;base    equ    0
  101.  
  102. Don't erase them.  Some of them may be needed later, either in
  103. assembling another segment or in assembling the command processor.
  104. If, in the future, ZASM complains of an undefined label, you may
  105. need to uncomment these equates.
  106.  
  107.  
  108.  
  109.  
  110.