Definition and purpose

The Reports Background Engine (rwrbe60.exe) provides a simple and powerful way to manage a local queue of reports called from Form Builder or Graphics Builder.  It provides a display of all the reports queued to run and enables you to monitor the status of the reports, move reports up or down in the queue, and remove jobs from the queue.


Access

The Reports Background Engine is displayed when you double-click on its icon.  The icon is automatically placed at the bottom of your screen when a report is called from Form Builder or Graphics Builder.

Note: You can also create a permanent icon for the Reports Background Engine just as you would for any other Windows executable.


Actions menu

The Actions menu contains the following menu items:

•	Cancel Job terminates the currently running job in the report list.  This menu item is only enabled when you have the currently running report selected.

•	Remove Job removes the currently selected job from the report list.  This menu item is only enabled when you have a report other than the currently running report selected.

•	Show/Hide Log shows or hides a separate pane where messages about each report are logged.  The contents of this log are written to a file (reports.log) in the current directory when you quit the Reports Background Engine.

•	Quit closes the Reports Background Engine and terminates the currently running report as well as any queued reports.  The server log is also written to a file (reports.log) in the current path when you quit.


Help menu

The Help menu contains the following menu items:

•	Contents displays a list of the topics available in the help system.  From this list, you can access any of the help topics.

•	About Reports Background Engine displays a dialog box that contains the version of the Reports Background Engine you are using and a copyright notice.


Report list

The report list in the Reports Background Engine shows the reports that are running and queued to run in priority order.  For each report in the list, the following information is provided:

•	Rank is the current priority of the report in the queue.  The report with Rank 1 is the currently running report, the report with Rank 2 is the report that will run next, and so on.  Note that you can change the order of the reports by selecting a report and dragging it to a new location in the list.

•	Report is the name of the report.

•	Status is a description of what the report is currently doing.  The possible status descriptions are as follows:

•	Formatting page x means that page x of the report is being processed.

•	In Parameter Form means the Runtime Parameter Form is being displayed for the report.  The report will not start running until you accept the parameter form.

•	In Previewer means that the report is currently being displayed in the Runtime Previewer.  The next report will not run until you close the Runtime Previewer.

•	Initializing Report means that report execution is beginning.

•	Running Before Report Trigger means that the PL/SQL in the Before Report trigger is being executed.

•	Waiting means that the report is queued and awaiting execution.


Log pane

The log pane appears if you choose Actions [image] Show Log.  This pane shows a log of the messages for the current Reports Background Engine session.  The contents of this log are written to a file (reports.log) in the current directory when you quit the Reports Background Engine.


Canceling reports

To cancel the currently executing report from the Reports Background Engine, select the report with Rank 1 and then choose Actions [image] Cancel Job.


Removing reports

To remove a report from the list, select it and then choose Actions [image] Remove Job.


Moving reports

To move a report up or down in the list, select it and drag it to a new location.


Showing/hiding log

To show/hide a log for the Reports Background Engine session, choose Actions [image] Show/Hide Log.  A separate pane for log messages will be displayed or hidden.