The USE BEFORE REPORTING Statement (Report Writer)
The USE BEFORE REPORTING statement specifies Procedure Division statements that are executed just before a report group named
in the Report Section of the Data Division of this program, and optionally a contained program, is presented.
General Format
Syntax Rules
- A USE BEFORE REPORTING statement, when present, must immediately follow a section header in the declaratives portion of the Procedure Division and must appear in a sentence by itself. The remainder of the section must consist of zero, one, or more procedural paragraphs that define the procedures to be used.
- Identifier-1 must reference a report group. The same identifier-1 must not appear in more than one USE BEFORE REPORTING statement in the same Procedure Division.
- The GENERATE, INITIATE, or TERMINATE statements must not appear in a paragraph in a USE BEFORE REPORTING procedure. A PERFORM statement in a USE BEFORE REPORTING procedure must not have GENERATE, INITIATE, or TERMINATE statements in its range.
- A USE BEFORE REPORTING procedure must not alter the value of any control data item.
- The USE BEFORE REPORTING statement itself is never executed; it merely defines the conditions calling for the execution of the USE procedures.
General Rules
- A declarative procedure is invoked just before the named report group is produced during the execution of the program. The report group is named by identifier-1 in the USE BEFORE REPORTING statement which prefaces the declarative.
- Within a declarative procedure, there must be no reference to any nondeclarative procedures.
- Procedure-names associated with a USE BEFORE REPORTING statement can be referenced in a different declarative section or in a nondeclarative procedure only with a PERFORM statement.
- In the USE BEFORE REPORTING statement, the designated procedures are executed by the RWCS just before the named report group is produced. (See the section The TYPE Clause.)
- Within a USE procedure, there must not be the execution of any statement that would cause the execution of a USE procedure that had previously been invoked and had not yet returned control to the invoking routine.
- Special precedence rules are followed when programs are contained within other programs. In applying these rules, only the
first qualifying directive will be selected for execution. The declarative which is selected for execution must satisfy the
rules for execution of that declarative. The order of precedence for selecting a declarative is:
- The declarative within the program that contains the statement which caused the qualifying condition.
- The declarative in which the GLOBAL phrase is specified and which is within the program directly containing the program which was last examined for a qualifying declarative.
- Any declarative selected by applying rule 6b to each more inclusive containing program until rule 6b is applied to the outermost program. If no qualifying directive is found, none is executed.