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. /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. /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 all registers, and warm boot CP/M PRINT 1 19+ Print a message on CON: PRINT 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 ; got to check point 1 -- code -- EXIT ; should not have taken this path -- code -- PRINT ; got to check point 2 -- code -- EXIT ; normal exit -- code --