Kbase P111916: Report Builder: The Report Status File
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
12/16/2005 |
|
Status: Unverified
GOAL:
What is the Report Status file
GOAL:
Where does Report Engine write the Report Status File
GOAL:
How to configure the name and location of the Report Status File
GOAL:
What do the ENTRY=VALUE pairs mean in the Repot Status File
FACT(s) (Environment):
Progress 8.x
Progress 9.x
OpenEdge 10.x
FIX:
The Report Engine Status file is a file that the Report Engine has the following format:
---------------------------
[<report_name>]
RO-ERROR-CODE=N
RO-ERROR-MESSAGE=
RO-PAGES=<n>
---------------------------
The following describes each entries possible values for the ENTRY=VALUE pair and what the VALUE means:
---------------------------
RO-ERROR-CODE:
=N The Report Finished successfully.
=C The user selected CANCEL to cancel a Report.
=J There was an error in the Report Engine command or Report Engine record.
= R An error occurred while attempting to process the report.
RO-ERROR-MESSAGE:
="" The Report Finished successfully.
=CANCELLED The user selected CANCEL to cancel a Report.
=OTHER An error occurred while trying to process the report.
RO-PAGES:
This entry contains the number of the last page completed in the report.
---------------------------
The creation of the Report Status File depends on the specific Engine Interface that is used.
PRINTRB interface (aderb\_prntrb.p) : The Report Engine automatically writes report status information to the Report Status File, called RBRUN.OUT, in the current directory. The Report Status File name and location cannot be configured through this interface.
PRNTRB2 interface (aderb\_prntrb2.p) : The value of the 20th Engine parameter, RB-STATUS-FILE, controls the name and location of the Report Status File. 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 nothing is specified.
TABLE interface (aderb\_prore.p) : Configure the Report Status File name and location via the startup parameter, -rbstatfile. You must also set the RB-STATUS field of the Report Record to True.