Progress
Report Builder
Deployment Guide
Report Status File
The first location where Report Engine outputs status information is a text file called the report status file. The file’s name and location depend upon which interface you use.
If you use the PRINTRB interface, Report Engine automatically writes report status information to the report status file, called
RBRUN.OUT
in the current directory.If you use the PRNTRB2 interface, you must set the RB-STATUS-FILE parameter. The report status file is created and has the same format as the
RBRUN.OUT
file. If you do not indicate the filename, this file is not generated. The file is written to either the directory specified in the RB-STATUS-FILE or the current directory if none is specified. See "Report Engine PRINTRB and PRNTRB2 Interfaces," for a complete description of the Report Status File parameter.However, if you use the table interface, you can choose whether to have Report Engine create a report status file, using the Report Status File (-rbstatfile) parameter. This parameter specifies the file name and directory of the report status file. See "Report Engine Table Interface," for a complete description of the Report Status File parameter.
After running Report Engine, you can check the status file for information about Report Engine processing. If Report Engine encountered an error, the file contains an error message that explains why a report was terminated, as well as an error code that lets you determine the type of error. The status file also contains the number of pages printed, so a report can be restarted where it left off.
If you set the RB-DISPLAY-ERRORS parameter to true, Report Engine also displays error messages on the screen as it executes. For a complete description of the RB-DISPLAY-ERRORS parameter, see "Report Engine Parameters,"
To avoid confusing old and new status files, delete any existing status files before starting Report Engine.
The report status file is in Windows initialization (.INI) style format and has the header [report-name]. If Report Engine is running multiple reports, the report status file contains information about all the reports that were run (table interface only). Each report’s output appears in the same format as a separate .INI file section. Figure 2–1 shows a report status file for multiple reports.
Figure 2–1: Report Status File for Multiple Reports
There are three entries in Report Engine status file:
Entries appear one per line in the following format:
The following sections describe each of the three entries.
RO-ERROR-CODE
Table 2–1 describes the possible error code entries.
RO-ERROR-MESSAGE
The error message value depends upon the type of error. The following table lists what type of message appears for different errors:
RO-PAGES
This entry contains the number of the last page completed in the report. You can use this number to restart a terminated report at the page where the error occurred.
For example, if you are printing pages 10 through 20 of a report and the printer jams on page 15, this entry contains 14 (the number of the last page that printed successfully). If RO-PAGES contains 14, you can restart the report at page 15 by entering 15 in the RB-BEGIN-PAGE parameter and 20 in the RB-END-PAGE parameter.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |