home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / help / slrsys.hzp / SLRSYS.HLP
Encoding:
Text File  |  1987-01-15  |  9.1 KB  |  274 lines
  1. ;
  2.  
  3.  SLR Systems Assembly Language Tools
  4.  
  5.         A. SLRMAC (Intel macro assembler)
  6.  
  7.         B. Z80ASM (Zilog macro assembler)
  8.  
  9.         C. SLR180 (Hitachi/Zilog assembler)
  10.  
  11.         D. SLRNK (Linker)
  12.  
  13.         E. Virtual Memory Tools
  14.  
  15.         F. Ordering Information
  16. :A
  17.  
  18.  
  19.  SLRMAC
  20.  
  21.  
  22.      SLRMAC is an ultra-high-speed macro assembler for source code written
  23. in Intel mnemonics.  In our own tests we found that it would assemble ZCPR3
  24. system modules such as ZCPR3.ASM about five times faster than Digital
  25. Research's MAC assembler.  It is highly compatible with existing public-domain source code.  In only very rare cases have we found it necessary to
  26. make any changes to the source code to make it compatible with SLRMAC.
  27.  
  28.      SLRMAC can assemble source code to HEX files (like MAC) or to REL files
  29. (like M-80).  It can also generate COM files directly in a single pass!
  30.  
  31.      The next screens list some of the technical specifications, command
  32. line options, configuration options, and pseudo-ops recognized.
  33.  
  34.     The latest version of SLRMAC is designed to work with ZCPR3 systems and
  35. to automatically set the program error flag in the message buffer to reflect
  36. whether assembly errors were detected.
  37.  
  38.  
  39.  SLRMAC -- Technical Specifications
  40.  
  41.     *   Assembles to COM, HEX, or REL files in one pass
  42.     *   Optional two-pass mode for fully resolved listings
  43.     *   Full macro facility
  44.     *   M80/RMAC compatible (Intel mnemonics only)
  45.     *   Accepts symbol definitions from the console
  46.     *   Nested conditionals and include files
  47.     *   Relocatable format supports math on externals
  48.     *   Intel nmemonics with Z80.LIB extensions built in
  49.     *   Absolute, program, data, and common areas
  50.     *   Fastest assembler on the market
  51.     *   Sorted symbol and cross-reference tables
  52.     *   Labels have 16 significant characters
  53.     *   Support for automatic time and date in listings
  54.     *   Assemble for execution at another address
  55.     *   User configurable
  56.     *   Colons not required on labels
  57.     *   Reserved words may be redefined as macros and/or labels
  58.  
  59.  
  60.  
  61.  Command Line Options
  62.  
  63.  
  64.     *   Select COM, HEX, SLR REL, or Microsoft REL output
  65.     *   Select listing output type and devices
  66.     *   Select/Deselect upper/lower case distinction
  67.     *   Select 1- or 2-pass mode
  68.     *   Specify an indirect command file (like submit but much faster)
  69.     *   Disallow console I/O and auto-detach
  70.     *   Select symbol table and/or cross reference
  71.     *   Select automatic declaration of external symbols
  72.     *   Select 6 or 7 characters in Microsoft REL format
  73.  
  74.  
  75.  
  76.  Configuration Options
  77.  
  78.  
  79.     *   Set default command line switch settings
  80.     *   Set default printer page length and width
  81.     *   Control listing of more than 4 bytes of code per source line
  82.     *   Set macro listing default
  83.     *   Set the byte order for printing 16-bit values
  84.     *   Set flag for suppressing PAGE and TITLE lines in listing
  85.     *   Select time/date in listing, with options for clocks not
  86.         supported directly by the operating system
  87.     *   Use/Do-Not-Use multisector I/O
  88.     *   Define listing format
  89.     *   Set error page and abort limits
  90.     *   Set number of bytes per HEX record
  91.     *   Set all file extensions
  92.     *   Define printer initialization and termination strings
  93.  
  94.  
  95.  
  96.  Pseudo-Op List
  97.  
  98.  
  99.         ABS             DS              EXITM           IFDIF
  100.         ASEG            DSEG            EXT             IFE
  101.         ASET            DW              EXTERNAL        IFF
  102.         BYTE            EJECT           EXTRN           IFIDN
  103.         CLIST           ELSE            GLOBAL          IFNB
  104.         COM             END             IF              IFNDEF
  105.         COMMON          ENDIF           IF0             IFT
  106.         CSEG            ENDM            IF1             INCLUDE
  107.         DATA            ENT             IF2             IRP
  108.         DB              ENTRY           IFB             IRPC
  109.         DC              EQU             IFDEF           LIST
  110.  
  111. continued
  112.  
  113.  
  114.  
  115.  Pseudo-Op List continued
  116.  
  117.  
  118.         LOCAL           PROG            .LALL           .XCREF
  119.         MACLIB          PUBLIC          .LFCOND         .XLIST
  120.         MACRO           REL             .LIST           $EJECT
  121.         MEND            REPT            .PHASE          $INCLUDE
  122.         MTLIST          SET             .PRINTX         $TITLE
  123.         NAME            SUBTTL          .RADIX          $+MACRO
  124.         NCLIST          TITLE           .REQUEST        $-MACRO
  125.         NLIST           .ACCEPT         .SALL           $*MACRO
  126.         NMTLIST         .COMMENT        .SFCOND         $+PRINT
  127.         ORG             .CREF           .TFCOND         $-PRINT
  128.         PAGE            .DEPHASE        .XALL
  129. :B
  130.  
  131.  
  132.  
  133.  Z80ASM
  134.  
  135.  
  136.     Z80ASM is nearly identical to SLRMAC except that it works with Zilog
  137. opcodes instead of Intel opcodes.  See the section of this help file on
  138. SLRMAC for technical specifications, command line options, configuration
  139. options, and pseudo-ops recognized.
  140.  
  141.     The following additional pseudo-ops are handled: COND, DEFB, DEFC, DEFL,
  142. DEFM, DEFS, DEFW, DEFZ, ENDC, *EJECT, and .Z80.   SET, $+MACRO, $-MACRO,
  143. $*MACRO, $+PRINT, and $-PRINT are not recognized.
  144.  
  145.     The latest version of Z80ASM is designed to work with ZCPR3 systems and
  146. to automatically set the program error flag in the message buffer to reflect
  147. whether assembly errors were detected.
  148. :C
  149.  
  150.  
  151.  
  152.  SLR180 Hitachi/Zilog Assembler
  153.  
  154.  
  155.     This assembler is almost identical to Z80ASM except that it recognizes
  156. the additional opcodes of the Hitachi HD64180 microprocessor.  See the entries
  157. under Z80ASM and (especially) SLRMAC for more detailed information.
  158. :D
  159.  
  160.  
  161.  SLRNK Linker
  162.  
  163.  
  164.     SLRNK is a super high speed linker, running from 3 to 7 times faster
  165. than L-80.  Below, and on the following screens, are listed some of the
  166. technical specifications, command line options, and configuration options of
  167. SLRNK.
  168.  
  169.  
  170.  Technical Specifications
  171.  
  172.     *   Links SLR and Microsoft format REL files
  173.     *   Outputs COM or HEX files
  174.     *   Supports three logical address spaces
  175.     *   Symbol table sorted and ZSID compatible
  176.     *   Generates detailed load map
  177.     *   Supports nested indirect command files
  178.  
  179.  
  180.  
  181.  Command Line Options
  182.  
  183.  
  184.     *   Select/Modify loading address for any address space
  185.     *   Select output type (COM or HEX)
  186.     *   Force undefined globals to zero
  187.     *   Select indirect command file
  188.     *   Select symbol table output
  189.     *   Select library search mode
  190.     *   Origin symbols by name
  191.     *   List undefined symbols
  192.  
  193.  
  194.  
  195.  Configuration Options
  196.  
  197.  
  198.     *   Select tabs or spaces between symbols in SYM file
  199.     *   Use/Do-Not-Use multisector I/O
  200.     *   Set number of bytes per HEX output record
  201.     *   Define default extensions for all files
  202. :E
  203.  
  204.  
  205.  
  206.  
  207.  Virtual Memory Assemblers and Linkers
  208.  
  209.  
  210.     The virtual memory versions of the assemblers (SLRMAC+ and Z80ASM+) and
  211. linker (SLRNK+) allow all internal tables to overflow to disk.  Thus the
  212. size of one's disk and not the size of the TPA is the limiting factor in
  213. determining the size of files that can be assembled and linked.
  214.  
  215.     SLRNK+ also has many additional features which are listed in the
  216. following screens.
  217.  
  218.  
  219.  
  220.  SLRNK+ Additional Technical Specifications
  221.  
  222.     *   Works with Microsoft compilers
  223.     *   Outputs SPR and PRL files
  224.     *   Supports 8 logical address spaces
  225.     *   Generates intermodule cross refrences
  226.     *   Hex files do not fill unused space
  227.     *   ALL internal tables overflow to disk
  228.     *   Supports manual overlays
  229.  
  230.  
  231.  SLRNK+ Additional Command Line Options
  232.  
  233.     *   Select address space grouping options
  234.     *   Save and restore system state to disk
  235.     *   Select sorted cross reference output
  236.     *   Select commons to be treated as address spaces
  237.     *   Origin common blocks by name
  238.     *   Select devices and filenames for listing outputs
  239.  
  240.  
  241.  
  242.  
  243.  SLRNK+ Additional Configuration Options
  244.  
  245.  
  246.     *   Size limit on symbols in SYM file
  247.     *   Lines per page on list device and console
  248.     *   Page/Do-Not-Page console output
  249.     *   Form feeds at beginning and/or end of listings
  250.     *   Loading order of CSEG, DSGE, and COMMON segments
  251. :F
  252.  
  253.  Ordering Information
  254.  
  255.  
  256. The SLR assembly language tools can be ordered by sending a check to
  257.  
  258.                         Sage Microsystems East
  259.                         1435 Centre Street
  260.                         Newton Centre, MA 02159
  261.  
  262. or by leaving a private message for Jay Sage on the bulletin board including
  263. the following information: your full name, address, phone number, credit card
  264. type, number, and expiration date, and the products you wish to order.
  265.  
  266. SLRMAC, Z80ASM, and SLRNK are $49.95 each; SLR180 is $69.95.  If you are
  267. interested in one of the virtual-memory tools, please inquire.
  268.  
  269. If you presently own one of the SLR tools, you can upgrade to the newest
  270. version by sending your original disks and $20 per upgrade to the address
  271. above.  If you bought the original version or an earlier upgrade from Sage
  272. Microsystems, then you can get upgrades over the system without having to
  273. return your diskette.
  274.