Running a program unit in the PLSQL Interpreter Inserting a Navigator pane in the PLSQL Interpreter Controlling program unit execution

4-130 Oracle Reports Users Guide to Building Reports Enabled: YES

4.14.6 Editing a debug action

To edit a debug action:

1. In the Object Navigator, expand the Debug Actions node, then double-click the

debug action icon to display the appropriate dialog box. 2. Edit the content or properties of the debug action in the dialog box.

3. Click OK.

4.14.7 Disabling and enabling debug actions

To disableenable a debug action: ■ In the Object Navigator, under the Debug Actions node, right-click the desired debug action and choose Enable or Disable. or ■ In the PLSQL Interpreter, use the ENABLE or DISABLE command to enable or disable the specific debug action. For example, entering .DISABLE ACTION 1 in the Interpreter pane disables the first debug action and displays the following status: Disabling debug action 1...

4.14.8 Deleting a debug action

To delete a debug action:

1. In the Object Navigator, expand the Debug Actions node, then click the action

you want to delete. 2. Click the Delete button in the toolbar.

4.14.9 Running a program unit in the PLSQL Interpreter

To run a program unit in the PLSQL Interpreter:

1. If the PLSQL Interpreter is not already displayed, choose Tools PLSQL

Interpreter to display it.

2. At the Interpreters PLSQL prompt, type the name of the program unit followed

by a terminating semi-colon ;. If the program unit requires any arguments, be sure to supply them in parentheses. For example: getdataSCOTT; 3. Press the Enter or Return key to produce one of the following reactions: ■ Any output generated by the program unit is displayed at the command line, and the PLSQL prompt returns to indicate successful execution. ■ The secondary prompt appears + indicating you have not finished entering an executable statement. If you forgot the terminating semicolon, enter it now and press Enter or Return. Otherwise, right-click and choose New Prompt. ■ Runtime errors are displayed at the command line, then the PLSQL prompt appears. You need to edit or debug your program unit. ■ If you have set a breakpoint or debug trigger in the program unit, execution is suspended and a new prompt is displayed as: debug nPLSQL. How To... 4-131 Usage notes Running a program unit as described above only works for procedures or packaged procedures, not for functions since theres no variable for a return value to be returned to.

4.14.10 Inserting a Navigator pane in the PLSQL Interpreter

To insert an Object Navigator pane in the PLSQL Interpreter:

1. If the Interpreter is not already displayed, choose Program PLSQL Interpreter.

2. In the PLSQL Interpreter, choose View Navigator Pane to insert the Object

Navigator pane in the middle of the PLSQL Interpreter. Notice that the button bar is updated with new Object Navigator buttons. 3. Optionally, use the split bars to resize the proportions of the three panes.

4.14.11 Controlling program unit execution

Once you have inspected and modified the program state, you can resume or terminate execution using the following features: Execute these commands from either the PLSQL Interpreter toolbar or by typing the command in the PLSQL Interpreter pane.

4.14.12 Stepping through the code