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

4- 102
The USING clause is executed each time a page header is printed.
The PAGE HEADER statement generates an error if a report is not active.
If a report section is active; that is, executing, and encounters this
statement, then that report section is ended.
The PAGE HEADER statement executes when an automatic page break condition
occurs, or when the TRIGGER PAGE BREAK statement is executed. Under
these circumstances, the PAGE TRAILER prints, followed by the PAGE
HEADER.
After the page eject, the Report Writer pauses if the PAUSE EVERY
statement applies. The page function values; such as, page number,
number of pages output, NUMLINE function, and number of lines left on the
page are then reset. The PAGE HEADER prints after this. Thus, the PAGE
HEADER lines do count as part of the NUMLINE value.
The PAGE HEADER does not print if the SUPPRESS PAGE HEADER ON statement
has been executed. The TRIGGER PAGE BREAK statement can suppress the
page header with its SUPPRESS option. Refer to TRIGGER PAGE BREAK for
more information. If the page header is suppressed, none of the
statements in the PAGE HEADER section are executed.
If the REPORT HEADER section executes a TRIGGER PAGE BREAK, so that a
"cover" page is printed, the PAGE HEADER is printed only at the top of
the new page. The PAGE HEADER is not printed twice as might be expected.
PAGE LENGTH
The PAGE LENGTH statement is used to set the size of a report page. You
can specify the page length and the top and bottom margin size with this
statement. There can be only one PAGE LENGTH statement in a report
description.
Syntax
PAGE LENGTH length [, blank_top [, blank_bottom ]]
Parameters
length Expression is a numeric expression in the range [0,
32767]. A value of zero indicates an infinite page
length. This prevents error 260, "Insufficient space
for printer output within the current page". The
default value is 60.
blank_top A numeric expression indicating how many blank lines
should be in the top margin. These lines are printed
before the page header, and are not suppressed by the
SUPPRESS HEADER ON statement. The value must be between
zero and the length of the page. The default value is
zero.
blank_bottom A numeric expression indicating how many blank lines are
in the bottom margin. These lines are printed after the
page trailer and are not subject to page trailer
suppression. The value must be between zero and the
length of the page. The default value is zero.
NOTE After the report definition is scanned by BEGIN REPORT, a final
check is made on the page size. The following condition must hold
or an error occurs:
Page_length - Blank_top - Blank_bottom -
Page_header_size - Page_Trailer_size >=3