HP 68000 Series, User Manual

Page: 311 / 586

The curly braces ( { } ) are required punctuation. Formal arguments can be
used throughout the macro definition, and are later replaced by the actual
arguments in the macro call.
The maximum number of characters that can be entered on a line in a macro
definition is 255. When entering macros interactively, the debugger does not
respond to more than 78 characters on a line. When reading a command file,
the debugger stops recognizing characters after 255 characters have been read
on a line.
The maximum number of lines allowed in a macro depends on the complexity
of the lines. Macros with too many lines (too complex) will fail. Error 92 "Not
enough memory for expression" will be displayed.
A macro is similar to a C function. The body can contain any legal C statement
(except the SWITCH and GOTO statements). The statements IF, ELSE, DO,
WHILE, FOR , R ETUR N, BR EAK, and CONTINUE can be used to control
program flow within a macro, just as in C. Macros have return types and can
be used in expressions.
Note Debugger commands may be used in macro definitions; they are indicated by
placing a dollar sign ($) at the beginning and the end of a command sequence.
For example, the following command sequences are legal in macro definitions:
$Program Find_Source Occurrence Forward system$;
or
$
Memory Assign Long &time=12
Program Find_Source Occurrence Forward system
$;
Macros can be executed by specifying the macro name on the command line in
a Debugger Macro Call command, in an expression, or with a breakpoint
command.
Macros can be removed using the command:
Symbol Remove <macro_name>
See Also
Breakpt Access
Breakpt Instr
Breakpt R ead
Breakpt Write
Chapter 9: Debugger Commands
Debugger Macro Add
289