System Debug Reference Manual (32650-90888)

Chapter 6 227
System Debug Command Specifications M-X
MAP
( num : ANY = $1 )
<-- exit macro: inc : U16 = $2
$2
The MACTRACE command is used to enable macro tracing for macro inc at trace level 3.
Now, every time macro inc is invoked, trace information is displayed. Since the trace level
for this macro is set to level 3, entry into the macro is displayed, along with the parameter
value(s) at entry, and exit from the macro is displayed, along with the function return
value.
$nmdat > macl @ trace
macro inc trace = 3
The MACLIST command is used to display all macros that have tracing enabled (level >= 1).
Macro inc is shown to have tracing enabled at level 3.
$nmdat > mactrace @ 3
$nmdat > driver
--> enter macro: driver
--> enter macro: min
--> enter macro: triple
--> parms macro: triple
( input : ANY = $2 )
<-- exit macro: triple : U16 = $6
--> enter macro: inc
--> parms macro: inc
( num : ANY = $1 )
<-- exit macro: inc : U16 = $2
--> parms macro: min
( parm1 : ANY = $6 ,
parm2 : ANY = $2 )
<-- exit macro: min : U16 = $2
$2
<-- exit macro: driver
In this example, macro tracing is set to level 3 for all macros.
$nmdat > mactrace @
Tracing is disabled for all macros.
Limitations, Restrictions
none
MAP
Opens a file and maps it into a usable virtual address space.