This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRIS, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions page (login required).

Inserts a heading on each page of displayed output.

## Synopsis

HEADING "text['code']"


## Description

The HEADING clause causes the specified heading to be displayed (or printed) at the top of each page of CMQL output. This heading can consist of any combination of literal text and code characters. Note that heading literal text is in outer quotes and code characters are in nested quotes.

The available outer quotes are "text" or \text\. Inner (nested) quotes must be single quotes. Therefore, to display a text and a page number heading you must specify a heading such as "This is page 'P' of my report" or \This is page 'P' of my report\.

A heading specified in the HEADING clause replaces the default page heading provided with many commands. This default page heading can be suppressed using the (H or (C letter code options or the HDR-SUPP or COL-HDR-SUPP keyword options. These letter code and keyword options do not suppress a page heading specified using the HEADING clause.

The HEADING clause ignores the setting of SP-CONDUCT bit 1024. HEADING always behaves as if bit 1024 is not set.