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 / BEEHIVE / ZSUS / Z3HELP-6.LBR / ZA.LBR / Z33-ZASM.HZP / Z33-ZASM.HLP
Text File  |  2000-06-30  |  4KB  |  85 lines
  1. ;
  2.                                  Z33-ZASM.LBR                                 
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.               n/a  n/a   n/a   n/a        Michal Carson 5/87       Z3COM12
  6.  
  7.   1- Instructions                                                             
  8.  
  9.    Z33-ZASM contains  tools to allow assembly  of ZCPR33 with the ZASM  public
  10. domain  assembler.   There remain  in  the  body  of  ZCPR33  code  only a few 
  11. unrecognized pseudo-ops and a handful of over-long labels.   Z33-ZASM contains
  12. a  Zex script  (compatible with Ex14 and maybe with its successors)  to change 
  13. the pseudo-ops  and  shorten  the labels.   It  will require Eric Gans' FinRep 
  14. program which is also available in the public domain.  
  15. :1
  16.  
  17.  
  18. Instructions:
  19.    
  20.    The  script and FinRep will make  a copy of ZCPR33.Z80  on  the first pass; 
  21. subsequent passes  of FinRep will operate on the new file,  Z33ZASM.Z80.  This
  22. will require at least 372K of disk space  (three copies  of  the source code).  
  23. The intent is to preserve ZCPR33.Z80  at least  until  the  modifications  are 
  24. complete.   If this space is not available,  rename ZCPR33.Z80  to Z33ZASM.Z80 
  25. and edit the script  (delete the reference  to ZCPR33.Z80  in the first  line)
  26. before you begin.   If you are limited  to single-sided floppy drives,  FinRep 
  27. can  be  instructed  to  copy the file from one drive to the other as it runs; 
  28. you'll have to add the drive and filename specifiers in the script file.   The 
  29. command line is
  30.               B0>zex z33zasm
  31. or              B0>ex z33zasm
  32.  
  33.  
  34. Instructions (continued):
  35.  
  36.    The operation of FinRep requires several passes through a 124K file.   This
  37. will  take about ten minutes on a floppy disk.   A hard disk or ram disk would 
  38. be faster if one is available.   Remember, though,  that Zex may conflict with 
  39. co-processors used as ram disks.  
  40.  
  41.    The Z33MAC.LIB,  and  Z33HDR.LIB  included  make  it  possible  for ZASM to 
  42. assemble the new version 3.3 command processor.   These should  be substituted
  43. for  the  header and macro files distributed with the command processor.   The 
  44. macro file will also  work  with  the  3.3-specific resident command  and flow 
  45. control packages.
  46.  
  47.    For those  not  experienced  with  ZASM,  just  to  get you moving a little 
  48. faster, if the source file, libs and ZASM are on the B: drive use this command
  49. line:
  50.     B0>zasm z33zasm.bbz hex
  51.  
  52.  
  53.  
  54. Instructions (continued):
  55.  
  56.    Assembling  the RCP and FCP segments  is treated by  a separate batch file.
  57. Z33SEG.SUB,  like Z33ZASM.SUB,  will drive FinRep to convert  a few pseudo-ops 
  58. and  labels so that Z33FCP and Z33RCP  are acceptable  to ZASM.   Most  of the 
  59. problems,  though,  involve multiple definitions and the duplication of effort 
  60. between SYSDEF.LIB and Z3BASE.LIB.   This  is quickly remedied  with  a little
  61. editing.
  62.  
  63.    For efficiency,  edit the base lib and leave sysdef alone.  Several equates
  64. must  be hidden from the assembler by preceding them with  a semi-colon;  they 
  65. are then said to be "commented out."  The definitions ("equates") to be hidden
  66. are  listed below.   They  may  appear  in  uppercase  or  lowercase  in  your 
  67. Z3BASE.LIB,  or they may not appear at all.   If  your word-processor's search 
  68. function cannot  find  them,  neither will the assembler;  that's  fine.   The
  69. labels here are shown already commented out.  
  70.  
  71.  
  72.  
  73. Instructions (continued):
  74.  
  75.  
  76. ;false    equ    0 
  77. ;true    equ    not false 
  78. ;i8080    equ     false 
  79. ;zas     equ     false 
  80. ;base    equ    0
  81.  
  82. Don't erase them.   Some  of them may be needed later,  either  in  assembling 
  83. another segment  or in assembling the command processor.   If,  in the future, 
  84. ZASM complains of an undefined label, you may need to uncomment these equates.
  85.