{HEADING}

Command

The HEADING command displays the page heading: either the default heading or the heading as defined with the STARTHEADING and ENDHEADING commands.

Syntax

{ HEADING }

Default Value

The default heading includes the page member heading, the column member heading, and, if applicable, the currency heading.

Description

This command displays the page heading, either the default heading or else 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 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.

Example

See the example for the STARTHEADING command for an example of a 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.

IMMHEADING produces a new page and column heading immediately, without waiting for the next non-suppressed output line.
A HEADING is normally comprises of the page heading (members of the PAGE dimension), and the column heading (comprising of the current members of the column dimensions). The last line of the column header is also underlined.
If STARTHEADING/ENDHEADING is used, this redefines the makeup of the HEADING.
If SUPHEADING is used, the PAGEHEADING or COLUMNHEADING can still be independently turned back on by the commands of the same name.