2 Report Description Statements

The REPORT HEADER Statement

The REPORT HEADER statement has two purposes. The first is to indicate the beginning of the report description section. The second is to write a one-time heading on the first page of the report. The header is printed when the first DETAIL LINE, TRIGGER PAGE BREAK or TRIGGER BREAK statement is executed. (These statements are described in page 43 .) It is printed before the first PAGE HEADER.

The syntax of this statement is:

[label:]REPORT HEADER [WITH number LINES]

[USING [;list]][block statements]

The parameters for this statement are defined as follows:

label
This is the standard Eloquence line label. This label is referred to in the BEGIN REPORT statement. If not used, the BEGIN REPORT statement must refer to the line number of the REPORT HEADER statement.
number
The number of lines required for the header. If not entered, the value of number defaults to 1.
line id
A line number or label referencing an IMAGE statement.
image string
A list of image specifiers describing the output format, and enclosed in quotes.
list
This may be a list of string, numeric or array variables, literals, constants or expressions to be printed according to the image referenced.
block statements
Statements may follow the REPORT HEADER statement. They will be evaluated and executed immediately after the HEADER statement.
Some examples of these statements follow.


60  Inv: REPORT HEADER USING R_head
.
.
.
600 R_head: IMAGE 20X,"XYZ COMPANY INVENTORY",2/
The initial heading (XYZ COMPANY INVENTORY) is printed beginning at column 21. Two blank lines follow. The BEGIN REPORT statement (described in page 43 ) may reference line 60 or label Inv.

20    REPORT HEADER
With no block statements, there is no initial heading. The BEGIN REPORT statement must reference line 20.

90  Inv: REPORT HEADER USING "20X,K,2/ ";"XYZ COMPANY INVENTORY"
This example does exactly the same thing as the first example.


Eloquence Report Manual - 19 DEC 2002