HP Business BASIC/XL Reference Manual - HP 3000 MPE/iX Computer Systems - Edition 1 (32715-90001)

7- 3
If a Report Writer block statement executes when a report is not active,
an error occurs. When there is an active report, the direct execution of
the statement acts as a comment. These statements execute only when
certain other Report Writer statements execute, such as DETAIL LINE.
The following are Report Writer block statements:
* PAGE LENGTH
* LEFT MARGIN
* PAUSE EVERY
* SUPPRESS AT
* SUPPRESS FOR
* PRINT DETAIL IF
* TOTALS
* GRAND TOTALS
* BREAK IF
* BREAK WHEN
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