Generating Reports › Headings and Footings › Defining Control Break Headings and Footings

Defining Control Break Headings and Footings

You can override the default text printed for control break headings and footings on the Heading fill‑in. The headings and footings are defined independently for each control break level by specifying the level along with the group label. The default headings and footings print for any control break levels that were not overridden on the Heading fill‑in. Thus, automatic headings and footings for some levels can be interspersed with user‑defined headings and footings for other levels.

For example, a level‑1 control break is specified on the Detail fill‑in for the value in CUSTOMER.STATE. Rather than print the value with two asterisks as in "** STATE TX", the control break heading prints as Current State: followed by the full state name. A working data variable STNAME contains the actual state name.

This is specified on the Heading fill‑in as shown in the following screen:

 =>
‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
 IDEAL   : RPT HEADING/FOOTING   RPT CUSTRPT  (001) TEST           SYS: DOC  DISP 

          Field Name, Literal, Function,                   Column
 Command  or Arithmetic Expression                         Wid Tab Edit Pattern 
 ‑‑‑‑‑‑   ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ ‑‑  ‑‑‑ ‑‑‑‑‑‑‑‑‑‑‑‑‑
 ======   ==================== T O P ===================== ==  === =============
 000300   <<BH>> LEVEL 1                                   __  ___ _____________
 000400   'Current State:'                                 __  ___ _____________
 000500   STNAME                                           __  +02 _____________
 ======   ===================== B O T T O M ============== ==  === =============

When the current level‑1 control break is for Texas, the control break heading prints as the following:

Current State:  TEXAS

You can define a control break heading for any level by specifying the level with the heading. You can specify the contents of the heading with literal text, variables, or expressions. You cannot specify a subscripted variable. You can define a single heading for multiple control breaks by including the level number with the label. For example, the following defines a single control break heading to print at the break for each level‑1, level‑2, and level‑3 control break.

<<BH>> LEVEL 1 2 3

Control break footings are defined similar to control break headings. The group label is followed by the break level. For example, the following defines a control break footing to print at the end of each level‑2 control break.

<<BF>> LEVEL 2

Use level‑0 to obtain grand totals at the end of the report.

For information on using functions in the control break footing, see Generating the Bottom Line later in this chapter.