home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpmug / cpmug032.ark / RTMASM.DOC < prev    next >
Encoding:
Text File  |  1984-04-29  |  2.6 KB  |  78 lines
  1.     REAL TIME MICROSYSTEMS ASSEMBLER - INSTRUCTIONS
  2.  
  3. This disk includes a new assembler from Real Time Microsystems,
  4. 2240 Main St., #18, Chula Vista, CA 92011.  This assembler is
  5. required to assemble the source for TARBELL BASIC, since it
  6. is too large to fit on one diskette.  The unique feature of
  7. this assembler in this regard, is that it has a pseudo-op
  8. called LINK, which causes the assembly process to continue
  9. with the file named as it's operand.  This allows assembly
  10. of a large program which is broken up into several different
  11. files on different disks.
  12.  
  13. Because of some of the bugs listed below, however, this
  14. assembler cannot be used to assemble the file named TBASICIO.ASM
  15. on this disk.  Use the CP/M assembler for this instead.
  16.  
  17. After typing RTMASM, the following functions are available:
  18.  
  19. DO <filename>    Open a .DO (like submit) and use it for input.
  20. QT        Close all files and return to CP/M.
  21. CL        Close all files and restart assembler.
  22. LN        Disable all console listing.
  23. LE        Enable error printout on the console.
  24. LI        Enable program listing on the console.
  25. LS        Sort the symbol table and list it, if listing on.
  26. PE        Enable list device (high speed printer).
  27. PD        Disable list device.
  28. ER <filename>    Make a file of all statements containing errors.
  29.         (.ERR)
  30. SY <filename>    Make a file containing the xymbol table (.SYM).
  31. HX <filename>    Make an Intel hex format file (.HEX).
  32. PR <filename>    Make a file of the program listing (.PRN).
  33. AS <filename>    Assemble the file (.ASM).
  34.  
  35. NOTE:  Use filenames without extention.
  36.  
  37. Typical Sequence:
  38.  
  39.     LN
  40.     LE
  41.     SY TBASIC
  42.     HX TBASIC
  43.     AS TBASICA1
  44.     QT
  45.  
  46. The above sequence will assemble TARBELL BASIC, without the .PRN
  47. file, but giving the .HEX and .SYM file.  The .SYM file is not in
  48. ASCII format, so if you want a symbol table listing, use the PE
  49. and the LS commands (may be deferred to later).
  50. Known bugs:  1.  It will not assemble a line containing
  51. exclamation points to seperate instructions.  2.  It will flag as
  52. an error a comment line beginning with a semicolon (use an asterisk).
  53. 3.  It will flag as an error a line containing only a label.
  54. 4.  It will flag as an error a line with a label which duplicates
  55. one which is inside a false conditional assembly.  5.  The letter
  56. "A" cannot be used instead of PSW in a PUSH instruction.
  57.  
  58. Error Types:
  59.  
  60. DUP    Duplicate Label
  61. EXP    Expression error
  62. UND    Undefined symbol
  63. OVR    8-bit operand too large
  64. MNE    mnemonic error
  65. REG    Illegal register
  66.  
  67. The psuedo-ops are identical to the CP/M assembler, except
  68. for the new one:    LINK <filename> (no extension)
  69. A drive can be specified in the usual fashion (A: or B:).
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.