The DETAIL LINE Statement

3 Report Execution Statements

The DETAIL LINE Statement

The DETAIL LINE statement is the foundation around which the Eloquence Report Writer runs. When the DETAIL LINE statement is executed, all break conditions are tested and triggered if appropriate before any output associated with the DETAIL LINE is printed. In addition, this statement causes all totals to be incremented. Upon the first execution of the DETAIL LINE statement, the Eloquence Report Writer triggers the report header, page header and all header statements in ascending level-number sequence.

DETAIL LINE line [WITH number LINES]

[ USING[;list]]

The parameters are:

line: A numeric expression evaluating to an integer between 0 and 9. If greater than zero, totals are incremented, Eloquence Report Writer counters are incremented and a check for break conditions is made. If equal to zero, the above items are not done. If a DETAIL LINE statement will not fit on two program lines, a second DETAIL LINE statement can be used by setting the line parameter equal to one (or greater) in the first statement and equal to 0 in the second statement.
number: The number of lines required for output. If not entered, the value defaults to 1. If more than one line is required, it is important to enter the number so that a page break does not occur which would cause an error.
line id: A line number or label referencing an IMAGE statement.
image string: A string that contains an image format.
list: A list of numeric, string or array variables, constants, literals or expressions to be printed according to the image referenced.

Examples of this statement follow.


520  DETAIL LINE 1 USING D_line;Part$, Qty, Price, Qty*Price
.
.
.
770  D_line:  IMAGE 9X,8A,8X,DCDDD,5X,DDCDDDPDD,3X,DDDCDDDPDD

This example causes the values of Part$, Qty, Price and Qty$\ast$Price to be printed in the format shown.


100  DETAIL LINE 1
110  IF A=1 THEN GOTO X
120  IF A=2 THEN GOTO Y
130  IF A=3 THEN GOTO Z
.
.
.
200  X: DETAIL LINE 0 USING D1;A,B,C,D
.
.
.
300  Y: DETAIL LINE 0 USING D2;A,B,C,D
.
.
.
400  Z: DETAIL LINE 0 USING D3;A,B,C,D

In this example, all break conditions are checked and totals incremented at line 100, but no detail is output. The value of A determines the image used for the detail line. Line 200, 300, or 400 is used to print the line. When it is printed, totals are not incremented nor are break conditions checked.

Eloquence Report Manual - 19 DEC 2002