Adding a variable, expression, or register to the Monitors view
The Monitors view shows variables, expressions, and registers that you have selected to monitor. You can enter the variables or expressions in a dialog box or select them from the Debugger Editor. Use the Monitors view to monitor global variables - or variables, expressions, and registers that you want to see at all times during your debugging session. From the Monitors view, you can also modify the content of variables, expressions, or registers - or change the representation of values. Note: The expression support for some programming languages might depend upon the version of the compiler and/or runtime for those languages which are installed on your server.
About this task
To add a new Program Monitor for an expression from the Monitors view:
Procedure
- In the editor, select the source line that represents the context in which you want to evaluate the expression. Alternatively, in the Debug view, select the thread that contains the expression that you want to monitor.
- Click the Monitors view Monitor Expression button
(
).
- In the Monitor Expression dialog box, enter the variable, expression, or register in the field.
- Click OK.
Additional actions
About this task
The following information describes additional ways to add a program monitor from the editor, variables view, registers view, and how to change the contents of a variable, expression, or register in the monitors view
- In the editor, highlight and right-click the expression that you want to monitor.
- Select Monitor Expression from the pop-up menu.
- In the Variables view, right-click the variable that you want to monitor. To add multiple monitors, select multiple variables using the keyboard Ctrl or Shift keys.
- Select Monitor Local Variable from the pop-up menu.
- Stop your program at the first line you want to start monitoring.
- In the Debug Console view, enter the SET AUTOMONITOR ON command.
- In the Registers view, right-click the register that you want to monitor.
- Select Monitor Register from the pop-up menu.
- Select the expression whose value you want to modify.
- If the expression is a struct or array, expand it to show its individual elements.
- Scroll down to the expression you want to change and do one of
the following:
- Double-click the expression.
- Right-click the expression and choose Change value from the pop-up menu.
Note: If you double-click on a variable and its value field cannot be edited, the variable is a type that cannot be modified. - Enter a new value for the expression and press Enter. The new value can be any valid expression that has no side effects. To indicate that the expression value has changed, its indicator will have a delta symbol next to it. All expressions affected by the change will also have a delta symbol next to their indicators.
- Add the variable to the Monitors view using any method described earlier. The debugger displays the variable's name and current value in the Monitor view.
- Step through your program until you reach a statement that alters the value of that variable.
- Enter the SET WARNING OFF command in the Debug Console view. The Debug Console view displays a message that the SET WARNING OFF command was received.
- Step through the statement. The new value of the variable you are monitoring is displayed in the Monitors window.