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

4-: 153
When no suppress options are specified, this statement acts identically
to an automatic page break; for example, one caused by a WITH clause on
any Report Writer statement. The following actions are taken:
* Print blank lines up to the location where the PAGE TRAILER should
begin.
* Execute the PAGE TRAILER section, if present. During this process,
the number of lines left on the page is reset to the page trailer
size.
* Print the blank lines at the top of the page.
* Execute the PAGE HEADER section, if present.
The SUPPRESS options of the TRIGGER PAGE BREAK statement alter the
actions listed above. With these options, you can suppress the PAGE
TRAILER on the current page and the PAGE HEADER at the top of the next
page. These options apply only to the current page break. More
permanent suppression can be done with the SUPPRESS HEADER and SUPPRESS
TRAILER statements.
If the TRIGGER PAGE BREAK statements specify that TRAILER is to be
suppressed, then the PAGE TRAILER section is not executed. Instead,
blank lines are printed for the PAGE TRAILER. All other steps apply as
stated above.
When the SUPPRESS HEADER option is encountered, all steps take place as
indicated above, except for the execution of the PAGE HEADER section.
The top margin specified in the PAGE LENGTH statement is not suppressed.
Since the PAGE HEADER is not printed, there are more lines available on
the page.
As an example, consider a report description such as the following, where
a TRIGGER PAGE BREAK occurs at the end of the REPORT HEADER:
100 REPORT HEADER
110 PAGE LENGTH 60,0,0
.
.
.
200 TRIGGER PAGE BREAK, SUPPRESS TRAILER
210 PAGE HEADER WITH 3 LINES USING Ph_1
.
.
.
500 END REPORT DESCRIPTION
When this report starts printing, the REPORT HEADER section executes
first. After the desired title is printed (lines 110 to 199), the report
executes a page break. Suppressing the page trailer on this first page,
causes a title page to print at the start of the report.
NOTE Normally the PAGE HEADER is printed immediately after the REPORT
HEADER. However, when the TRIGGER PAGE BREAK executes in the report
header section, the PAGE HEADER executes at the top of the second
page. The Report Writer does not put out a second page header.
UNLOCK
The UNLOCK statement relinquishes the exclusive access that the LOCK
statement requested for a file.