Debugging commands and options (PL/I)
The Eclipse IDE offers a number of debugging features and techniques:
- Breakpoint-setting
- Run > Toggle Breakpoint or double-click in the left margin.
- Data item values
- To display a data item's value, you can hover over it, or alternatively right-click it and click
Inspect item.
Inspect can also be triggered from a context menu in the editor or by using the Ctrl+Shift+I shortcut.
- Debug configurations
- Run > Debug Configurations. You can have multiple debug configurations and swap between them. These settings here override the project run-time settings
- Main program to debug
- Run > Debug. On the General tab, specify the main program file.
- Reset execution
- Moves the execution point to the cursor position. The shortcut key is Alt+F12, R.
- Run to line
- You can position your cursor anywhere in your code to instruct the debugger to run from the current execution point to the line on which the cursor is positioned. The feature can save time when debugging as you do not have to use the step functions to step through individual lines of code. You can use Run to line in both the main source code and copybook code. To use, position the cursor in the code and the click or use the shortcut CTRL+R.
- Stop debugging
- Run > Terminate. You can also click the red square at the top .
- Watchpoint-setting
- Run > Toggle Watchpoint or double-click in the left margin.
- Keyboard shortcuts - debugging
-
- F5 = Step into the next statement at the current line of code and suspend execution. Equivalent of clicking
.
- F6 = Step over the next statement at the currently executing line of code without entering it, and suspend execution. The
method will be executed normally. Equivalent of clicking
.
- F7 = Return from a method or paragraph that has been stepped into, and suspend execution. The remainder of the code inside
the method is executed normally. Equivalent of clicking
.
- F8 = Resume execution of the program from a suspended line of code. Equivalent of clicking
.
to reposition you at the start of the current method.
- F5 = Step into the next statement at the current line of code and suspend execution. Equivalent of clicking
- Querying the value of a data item or the file status of an internal file name
- Hold the mouse pointer over a data item or internal file name and the current value or file status displays as a Text Hover. The values of variables and file statuses of internal file names contained on the current execution line and previous line are displayed in Variables View (usually displayed in the top right of the IDE).