1e80
Invoking MACRO-80
MACRO-80 Switches
MACRO-80 Pseudo-Ops
MACRO-80 In-Line Error Messages
MACRO-80 Console Error Messages
Invoking LINK-80
LINK-80 Switches
Invoking LIB-80
LIB-80 Switches
Invoking CREF-80
Debugging MACRO-80 Programs Using DEBUG.MAC
:Invoking MACRO-80

     MACRO-80 is invoked by the following command --

          M80 obj:fn1.ext,lst:fn2.ext=src:fn3.ext

where
     obj:fn1.ext  is the device/filename for the object program
     lst:fn2.ext  is the device/filename for the listing
     src:fn3.ext  is the device/filename for the source

:MACRO-80 Switches

     The following switches may be specified in the command line --

          O    Print all listing addresses in octal
          H    Print all listing addresses in hexadecimal

          R    Force generation of an object file
          L    Force generation of a listing file
          C    Force generation of a cross reference file

          Z    Assemble Zilog (Z80) mnemonics
          I    Assemble Intel (8080) mnemonics

          P     Each /P allocates an extra 256 bytes of stack space for use 
during assembly.  Use /P if stack overflow errors occur during assembly.
:MACRO-80 Pseudo-Ops

     The following are the pseudo-ops recognized by MACRO-80 --

          ASEG      COMMON    CSEG      DB        DC
          DS        DSEG      DW        END       ENTRY
          PUBLIC    EQU       EXT       EXTRN     NAME
          ORG       PAGE      SET       SUBTTL    TITLE
          .COMMENT  .PRINTX   .RADIX    .REQUEST  .Z80
          .8080     IF        IFT       IFE       IFF
          IF1       IF2       IFDEF     IFNDEF    IFB
          IFNB      ENDIF     .LIST     .XLIST    .CREF
          .XCREF    REPT      ENDM      MACRO     IRP
          IRPC      EXITM     LOCAL     COND      ENDC
          *EJECT    DEFB      DEFS      DEFW      DEFM
          DEFL      GLOBAL    EXTERNAL  INCLUDE   MACLIB
          ELSE      .LALL     .SALL     .XALL
:MACRO-80 In-Line Error Messages

     A    Argument Error           O    Bad opcode or objectionable syntax
     C    Conditional nesting err  P    Phase error
     D    Double Defined Symbol    Q    Questionable
     E    External error           R    Relocation
     M    Multiply Defined Symbol  U    Undefined symbol
     N    Number error             V    Value error
:MACRO-80 Console Error Messages

     No end statement encountered in input file
          -- no END statement

     Unterminated conditional
          -- at least one conditional is unterminated

     Unterminated REPT/IRP/IRPC/MACRO
          -- at least one block is unterminated

     [xx] [No] Fatal error(s) [,xx warnings]
          -- the number of fatal errors and warnings
:Invoking LINK-80

     LINK-80 is invoked by typing --

          L80 obj1:filename.ext/sw1,obj2:filename.ext/sw2,...

where  objn:filename.ext  denotes a .REL file to be linked and swn  denotes 
switches which control the linking process.
:LINK-80 Switches

     /R        Reset -- put loader back in initial state

     /E or /E:Name
               Exit LINK-80 and return to CP/M.   Search the system library 
for any undefined references.   /E:Name uses Name for the start address  of 
the program.

     /G or /G:Name
               Start  execution  of  the program.   Again,  if  /G:Name  is 
specified, Name defines the start address of execution.

     <filename>/N
               Save the binary on disk under the name 'filename.COM'.

     /P:adr and /D:adr
               Set  the Program and Data area origins for the next  program 
to be loaded.


     /U
               List the origin and end of the program and data area as well 
as all undefined globals.

     /M
               List  the origin and end of the program and data  area,  all 
defined globals and their values,  and all undefined globals followed by an 
asterisk.

     <filename>/S
               Search 'filename.REL' to satisfy references.

     /X        If a filename/N was specified,  /X will cause the file to be 
saved in Intel HEX format with a extension of .HEX.

     /Y        If a filename/N was specified, /Y will create a filename.SYM 
file when /E is entered.  This file contains the names and addresses of all 
globals for use with SID or ZSID.
:Invoking LIB-80

     To invoke LIB-80, type --

          LIB

     Commands  to LIB-80 consist of an optional destination filename  which 
sets  the  name of the library being created,  followed by an  equal  sign, 
followed by module names separated by commas or filenames with module names 
enclosed in angle brackets separated by commas.

     To  select  a  given module from a file,  use the  name  of  the  file 
followed  by  the  module(s)  specified  enclosed  in  angle  brackets  and 
separated  by  commas.   If no modules are selected from a file,  then  all 
modules are selected.

:LIB-80 Switches

     /O   Set listing radix to Octal
     /H   Set listing radix to Hexadecimal
     /U   List undefineds
     /L   List cross reference
     /C   Create -- start LIB over
     /E   Exit -- rename .LIB to .REL and exit
     /R   Rename -- rename .LIB to .REL
:Invoking CREF-80

     CREF-80 is invoked by typing --

          CREF80 listing=source

where  'listing'  is  the  name of the  file  'listing.LST'  generated  and 
'source'  s  the  name  of the file  'source.CRF'  generated  by  MACRO-80.  
'listing' is optional, and, if omitted, the listing file generated is named 
'source.LST'.
:Debugging MACRO-80 Programs Using DEBUG.MAC

     DEBUG.MAC  is  a  package of MACROs which the user may employ  to  aid 
himself  in debugging MACRO-80 programs.   This package contains two  print 
MACROs,  one  register display MACRO,  and one exit MACRO.   In all  cases, 
these MACROs have no net affect on any register.

     DEBUG.MAC is used by first specifying it as a MACRO Library within the 
user's program.  This is accomplished by the statement --

          MACLIB    DEBUG.MAC

as an assembly-language instruction at the beginning of his program.   This 
statement  loads the library DEBUG.MAC and makes its MACROs  available  for 
use.  These MACROs are --


 Name  # Args  Size (Bytes)   Function                 Example
 ----  ------  ------------   --------                 -------

 EXIT    0/1   275 or 263+    Print an exit message,   EXIT
                              print the contents of    EXIT <Exit Cond 1>
                              all registers, and warm
                              boot CP/M
 PRINT     1   19+            Print a message on CON:  PRINT <Message>
 PRINTC    1   17+            Print a char string on   PRINTC <'M1',0DH>
                              CON:
 REGS      0   241            Print the contents of    REGS
                              all registers on CON:

Note:  The + after a size indicates that one must add to the indicated size 
the number of characters specified in the parameter.

Note:   Messages specified for EXIT and PRINT should not contain restricted 
MACRO-80 symbols (such as !) or an error message will result.

     An example of the use of these MACROs follows --

          MACLIB    DEBUG.MAC
          -- code --
          REGS                ; print all register values at this point
          -- code --
          PRINT     <Ck Pt 1> ; got to check point 1
          -- code --
          EXIT      <Exit error 1> ; should not have taken this path
          -- code --
          PRINT     <Ck Pt 2> ; got to check point 2
          -- code --
          EXIT                ; normal exit
          -- code --

0

