HP 3000 Manuals HP 3000 Manuals
PAGE HEADER
The PAGE HEADER statement prints at the top of every page of a report
unless suppressed. The first page header follows the report header.
This section is activated by any automatic page break or the TRIGGER PAGE
BREAK statement. The PAGE HEADER section is optional.
Syntax
[ [LINES]]
PAGE HEADER [WITH num_lines [LINE ]]
[USING image [; output_list]]
Parameters
num_lines The maximum number of lines expected to be needed by the
section statement. This number reflects ALL output done
by the section.
image An image string or a line reference to an IMAGE line.
output_list A list of output items, identical to the list described
in the PRINT USING statement.
Examples
The following examples show the use of the PAGE HEADER statement.
100 PAGE HEADER
110 PAGE HEADER WITH 4 LINES
120 PAGE HEADER WITH 2 LINES USING Hdr;Co_name$,Pg
130 Hdr: IMAGE 30X,25A,4D,/ !Image statement for line 120.
The WITH clause of the PAGE HEADER section is evaluated only once, when
BEGIN REPORT executes. This number of lines specified is used throughout
the rest of the report, and helps define the "effective" page size. The
page header section does not have to print as many lines as are reserved.
If it does not, other lines may be printed in the rest of the space.
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.