Debugging a report Running a report in debug mode

How To... 4-127 ■ Browsing debug actions ■ Editing a debug action ■ Disabling and enabling debug actions ■ Deleting a debug action ■ Running a program unit in the PLSQL Interpreter ■ Inserting a Navigator pane in the PLSQL Interpreter ■ Controlling program unit execution ■ Stepping through the code ■ Modifying code at runtime ■ Displaying the current scope location ■ Examining or changing local variables ■ Modifying application variables ■ Viewing subprogram references ■ Tracing report execution ■ Tracing report distribution ■ Tracing using the SQL TRACE function For conceptual information that supports these tasks, see Section 2.10, Debugging Tools .

4.14.1 Debugging a report

To debug a report: 1. Run the report in debug mode described below to check for logical errors in the report, and displays these as warnings at runtime, before displaying the report output. Running a report in debug mode is not the same as debugging a report using the PLSQL Interpreter.

2. After identifying a problem area, choose Tools PLSQL Interpreter to display

the PLSQL Interpreter, and create the desired debug actions see Section 4.14.3, Setting a breakpoint and Section 4.14.4, Setting a debug trigger to isolate the failing code to a specific region of number of statement. 3. Close the PLSQL Interpreter to run your report. 4. Browse your debug actions and evaluate application information. 5. After narrowing the failing code to a specific region, use the PLSQL Interpreter to implement and test possible code fixes. Usage notes When debugging a JSP-based Web report in Oracle JDeveloper, you must disable any breakpoints that are not of Source type. If these breakpoints are not disabled, a deadlock is detected. You can disable breakpoints that are not of Source type in the Breakpoints window.

4.14.2 Running a report in debug mode

To compile and run a report in debug mode: 4-128 Oracle Reports Users Guide to Building Reports

1. Choose Edit Preferences.

2. In the Preferences dialog box, on the Runtime Settings page, select Run Debug.

Click OK. 3. Click the Run Paper Layout button in the toolbar to run the report. To compile and run a report in debug mode from the command line: ■ On the rwbuilder or rwrun command line, specify RUNDEBUG=YES. For information about RUNDEBUG, see the Reference Command Line section of the Oracle Reports online Help. Usage notes Running a report in debug mode specifies that you want extra runtime checking for logical errors in the report. It checks for things that are not errors but might result in undesirable output, and displays these as warnings at runtime, before displaying the report output. Running a report in debug mode is not the same as debugging a report using the PLSQL Interpreter.

4.14.3 Setting a breakpoint