This chapter gives a very brief introduction to debugging. For additional
information, refer to the Programmer's Guide corresponding to the
language compiler you are using. There you will find details and examples
specific to your language.
How to Debug a CM Program |
 |
Compile and, using the Segmenter, prepare your program file and optional library files.
In order to take full advantage of Debug's symbolic capabilities, you must
ensure that your program (and library) contain the necessary FPMAP
symbolic records. This is easily accomplished with the Segmenter as follows:
For program files, use the FPMAP option when you prepare your program:
:PREP USLFILE, PROGFILE;FPMAP
|
For libraries, use the FPMAP
option each time you add a segment to the library:
To debug your program, specify the Debug
parameter in the RUN command:
:RUN CMPROG.GRP.ACCT;LIB=G;DEBUG
|
The program file is loaded, and you break at the first instruction
in your program, at the main entry point.
Debug announces your arrival into the debugger.
You are now ready to debug your program (set breakpoints, define macros,
turn on the windows, and so on). For example,
:RUN CMPROG.GRP.ACCT;LIB=G;DEBUG
CM DEBUG Intrinsic: PROG %0.22
%cmdebug > won
|
How to Debug an NM Program |
|
Compile and link your program file and any necessary libraries.
To Debug your program, specify the DEBUG
parameter in the RUN command:
The NM program file is loaded, and a temporary breakpoint is set
at the external stub that is linked to your program's main entry point.
When the program is launched into execution, the temporary
breakpoint is hit, and you immediately enter Debug (in NM mode). Debug
announces your arrival and deletes the temporary breakpoint.
To best observe the actual entrance (through the stub procedure) into your
main program, type WON to turn the windows on. Note that
you are at a stub procedure, which is marked with a question mark:
> ?PROGRAM
?PROGRAM+0004 etc.
|
Single step a few times to advance the program through the stub and into the
main body of the program. In summary,
:RUN NMPROG;DEBUG
Break at: [0] PROG 31.00022e7c ?PROGRAM
$nmdebug > won
$nmdebug > s
$nmdebug > s
|
You are now ready to debug your program (set breakpoints, define macros,
turn on the windows, and so forth).
