Compaq DEC Text Processing Utility AA-PWCBD-TE - Manual (Page 128)

DEC Text Processing Utility Program Development
5.7 Debugging DECTPU Programs
5.7 Debugging DECTPU Programs
This section discusses the options you have for debugging DECTPU programs.
To debug DECTPU programs, you can do one of the following:
• Write your own debugger in the DECTPU language. This is discussed in
Section 5.7.1.
• Use the DECTPU debugger provided in TPU$DEBUG.TPU. This is discussed
in Section 5.7.2.
Regardless of which debugger you use, you may find it helpful to enable
the display of error line numbers by using SET (LINE_NUMBER, ON) and
to enable the display of procedures called when an error occurs by using
SET (TRACEBACK, ON).
5.7.1 Using Your Own Debugger
If you write your own debugger, you can invoke it (and bypass the default bugger)
by using the /DEBUG qualifier with the EDIT/TPU command. For example,
to use a debugger called MY_DEBUGGER.TPU on a file called MIGHT_BE_
BUGGY.TPU, type the following:
$ EDIT/TPU/DEBUG=MY_DEBUGGER.TPU MIGHT_BE_BUGGY.TPU
5.7.2 Using the DECTPU Debugger
You can invoke the DECTPU debugger to debug one of the following kinds of files:
• Section files
• Command files
• Files that contain DECTPU programs that are not startup programs
The following sections contain more information on debugging each kind of file.
5.7.2.1 Debugging Section Files
To invoke the debugger for a section file, specify the following command on your
command line:
$ EDIT/TPU/DEBUG
Use of your system’s debug command causes the DECTPU initialization routine
to execute the debugger file before the system runs its initialization procedure.
The debugger initially creates a window that fills most of the screen. The window
consists of the following three areas:
• Source area—Displays your code when it has been placed in the debugger
source buffer.
• Output area—Displays one-line messages or one-line results of an EXAMINE
command.
• Debug command line—Displays the Debug: prompt.
When DECTPU displays the debug window, you can set breakpoints in the
section file by using the SET BREAKPOINT command. For example, if you
want to debug a procedure called user_fum, type the following on the debugger
command line:
Debug: SET BREAKPOINT user_fum
5–28 DEC Text Processing Utility Program Development