HP 3000 Manuals HP 3000 Manuals
Report Writer Executable Statements
The Report Writer executable statements drive the report process. A
report becomes active when a BEGIN REPORT statement executes. However,
this is distinct from starting report output. Starting report output is
caused by other Report Writer executable statements. The DETAIL LINE
statement is the primary method of printing the report. END REPORT and
STOP REPORT cease report activity.
These statements must appear in the same subunit as the report
description they use. They can appear anywhere within the subunit,
although some of these statements are not allowed inside the actual
report description.
Activating and Starting a Report
A distinction must be made between activating a report and starting a
report output. This distinction is important because of the interactions
of PRINT with the report writer.
The BEGIN REPORT statement activates a report. This means that the
report description is scanned and verified, and certain important
expressions are evaluated. After activation, the Report Writer built-in
functions are referenced without error, and all Report Writer executable
statements, except BEGIN REPORT, execute without error. The errors
returned when report section statements are seen changes when the report
is activated. A report remains active until one of the following occurs:
* An END REPORT or STOP REPORT statement executes.
* The report subunit ends or stops.
* A GET statement executes.
Once a report is activated, report output can start. The following
statements are the only statements that can start report output:
DETAIL LINE
TRIGGER BREAK
TRIGGER PAGE BREAK
END REPORT
When report output begins, the following steps take place:
1. The REPORT HEADER section executes to print the report header.
2. If present, the PAGE HEADER section executes to print the page
header.
3. Any HEADER sections defined execute from level 1 to level 9, in
ascending order.
Before report output starts, all PRINT statements do not affect the
report. However, once the report output starts, PRINT statements count
as lines in the report.
The following are Report Writer executable statements:
* BEGIN REPORT
* DETAIL LINE
* TRIGGER BREAK
* END REPORT
* STOP REPORT
* TRIGGER PAGE BREAK
* SUPPRESS HEADER
* SUPPRESS TRAILER
* SET PAGENUM