Filter
Top Products
The ILE Source Debugger
Equate a shorthand name with a field, expression, or debug command
Before you can use the source debugger, you must select a debug view when you
create a module object or program object using CRTRPGMOD or CRTBNDRPG.
After starting the debugger you can set breakpoints and then call the program.
When a program stops because of a breakpoint or a step command, the pertinent
module object's view is shown on the display at the point where the program
stopped. At this point you can perform other actions such as displaying or changing
field values.
Note: If your program has been optimized, you can still display fields, but their
values may not be reliable. To ensure that the content of fields or data
structures contain their correct (current) values, specify the NOOPT
keyword on the appropriate Definition specification. To change the optimiza-
tion level, see “Changing the Optimization Level” on page 87.
Debug Commands
Many debug commands are available for use with the ILE source debugger. The
debug commands and their parameters are entered on the debug command line
displayed on the bottom of the Display Module Source and Evaluate Expression
displays. These commands can be entered in uppercase, lowercase, or mixed
case.
Note: The debug commands entered on the debug command line are not CL
commands.
The debug commands are listed below.
Command Description
ATTR Permits you to display the attributes of a variable. The attributes are the
size and type of the variable as recorded in the debug symbol table.
BREAK Permits you to enter either an unconditional or conditional job breakpoint
at a position in the program being tested. Use BREAK
line-number
WHEN
expression
to enter a conditional job breakpoint.
CLEAR Permits you to remove conditional and unconditional breakpoints, or to
remove one or all active watch conditions.
DISPLAY Allows you to display the names and definitions assigned by using the
EQUATE command. It also allows you to display a different source
module than the one currently shown on the Display Module Source
display. The module object must exist in the current program object.
EQUATE Allows you to assign an expression, variable, or debug command to a
name for shorthand use.
EVAL Allows you to display or change the value of a variable or to display the
value of expressions, records, structures, or arrays.
QUAL Allows you to define the scope of variables that appear in subsequent
EVAL or WATCH commands. Currently, it does not apply to ILE RPG.
SET Allows you to change debug options, such as the ability to update pro-
duction files, specify if find operations are to be case sensitive, or to
enable OPM source debug support.
164 ILE RPG for AS/400 Programmer's Guide