HEADING

Displays the page heading: either the default heading or the heading as defined with the STARTHEADING and ENDHEADING commands.

If the SUPHEADING command has been used to turn off the display of the heading, this command also turns it back on, printing it just before the next non-suppressed output row, and thereafter at the top of every new page (unless SUPHEADING is used again). The heading automatically adjusts to any change in column or page selection members and is generated prior to the next output data row without the need for a further HEADING command.

Note:

The default heading includes the page member heading and the column member heading.

Syntax

{ HEADING }

Notes

By default, page and column headers (together called the HEADING) are turned on. This means they are displayed prior to the first actual output row in a report, and are reset to display again whenever:
- A new page is generated.
- Any member in the page or column dimensions changes.
- A specific COLHEADING, PAGEHEADING, or IMMHEADING dictates a new heading. Once they are reset to "display", they are output just prior to the new non-suppressed output row.
To produce a new page and column heading immediately, without waiting for the next non-suppressed output line, use IMMHEADING.
A heading normally comprises the page heading (members of the PAGE dimension) and the column heading (the current members of the column dimensions). The last line of the column header is also underlined.
If STARTHEADING/ENDHEADING is used, the HEADING command redefines the makeup of the report heading.
If SUPHEADING is used, the page heading and column heading can still be independently turned back on by the commands: PAGEHEADING and COLHEADING.

Example

See the example for the STARTHEADING command for an example of a heading.