Micro Focus Visual COBOL 2.3 Update 2 for Eclipse (Windows) > General Reference > COBOL Language Reference > Part 3. Additional Topics > Report Writer > Data Division > The Report Group Description Entry > Presentation Rules Tables > Report Heading Group Presentation Rules

Report Heading Group Presentation Rules

The Report Heading Group Presentation Rulestable below points to the appropriate presentation rules for all permissible combinations of LINE NUMBER and NEXT GROUP clauses in a report heading report group. The report heading group presentation rules are as follows:

Upper limit rule.
The first line number on which the report heading report group can be presented is the line number specified by the HEADING phrase of the PAGE clause.
Lower limit rules.
1. The last line number on which the report heading report group can be presented is the line number that is obtained by subtracting 1 from the value of integer-3 of the FIRST DETAIL phrase of the PAGE clause.
2. The last line number on which the report heading report group can be presented is the line number specified by integer-1 of the PAGE clause.
First print line position rules.
1. The first print line of the report heading report group is presented on the line number specified by the integer of its LINE NUMBER clause.
2. The first print line of the report heading report group is presented on the line number obtained by adding the integer of the first LINE NUMBER clause and the value obtained by subtracting 1 from the value of integer-2 of the HEADING phrase of the PAGE clause.
3. The report heading report group is not presented.
4. The first print line of the report heading report group is presented on the line number obtained by adding the content of its LINE-COUNTER (in this case, zero) to the integer of the first LINE NUMBER clause.
Next group rules.
1. The NEXT GROUP integer must be greater than the line number on which the final print line of the report heading report group is presented. In addition, the NEXT GROUP integer must be less than the line number specified by the value of integer-3 of the FIRST DETAIL phrase of the PAGE clause.
2. The sum of the NEXT GROUP integer and the line number on which the final print line of the report heading report group is presented must be less than the value of integer-3 of the FIRST DETAIL phrase of the PAGE clause.
3. NEXT GROUP PAGE signifies that the report heading report group is to be presented entirely by itself on the first page of the report. The RWCS processes no other report group while positioned to the first page of the report.
Final LINE-COUNTER setting rules.
1. After the report heading report group is presented, the RWCS places the NEXT GROUP integer into LINE-COUNTER as the final LINE-COUNTER setting.
2. After the report heading report group is presented, the RWCS places the sum of the NEXT GROUP integer and the line number on which the final print line of the report heading report group was presented into LINE-COUNTER as the final LINE-COUNTER setting.
3. After the report heading report group is presented, the RWCS places zero into LINE-COUNTER as the final LINE-COUNTER setting.
4. After the report heading report group is presented, the final LINE-COUNTER setting is the line number on which the final print line of the report heading report group was presented.
5. LINE-COUNTER is unaffected by the processing of a non-printable report group.

Table 1. Report Heading Group Presentation Rules
¹		Applicable Rules²
¹		If the PAGE Clause is specified					If the PAGE Clause is omitted
Sequence of LINE NUMBER Clauses³	NEXT GROUP Clause	Upper Limit	Lower Limit	First Print Line Position	Next Group	Final LINE COUNTER Setting	First Print Line Position	Final LINE COUNTER Setting
AR	Absolute	1	2a	3a	4a	5a	Illegal Combination
AR	Relative	1	2a	3a	4b	5b	Illegal Combination ⁴
AR	NEXT PAGE	1	2b	3a	4c	5c	Illegal Combination ⁴
AR		1	2a	3a		5d	Illegal Combination ⁴
R	Absolute	1	2a	3b	4a	5a	Illegal Combination
R	Relative	1	2a	3b	4b	5b	3b	5b
R	NEXT PAGE	1	2b	3b	4c	5c	Illegal Combination ⁵
R		1	2a	3b		5d	3d	5d
				3c		5e	3c	5e

¹ A blank entry in column 1 or column 2 indicates that the named clause is totally absent from the report group description entry.

² A blank entry in an applicable rules column indicates the absence of the named rule for the given combination of LINE NUMBER and NEXT GROUP clauses.

³ See the section Line Number Clause Notation for a description of the abbreviations used in column 1.

⁴ See the section Line Number Clause Notation.

⁵ See the section The NEXT GROUP Clause.