HEADING and FOOTING Modifiers
The HEADING and FOOTING modifiers specify text that is to be used at the top or bottom, respectively, of each report page. The text may also include head/foot options enclosed in single quotes.
Syntax
HEADING "{{text}{'option{option}...'}..."
FOOTING "{{text}{'option{option}...'}..."
HEADER is a synonym for HEADING.
Syntax Elements
text Comprises all printable characters except return, line feed, double quote, and the system delimiters. Two successive single quotes are displayed in the output as one single quote.
Note
The ^, ] and \ characters have special meanings when used in a HEADING or FOOTING modifier. This behaviour can be changed with the NOOLDHEADER environment option.
option A HEADING and FOOTING option.
Options
B Functions only if a BREAK-ON modifier with a B option is also included in the sentence. The B option can be used in either the header or the footer. The first value of the BREAK-ON attribute on the page replaces the B in the header or footer as appropriate.
C{n} Centralizes the heading or footing text. The text is centred according to the number of columns (characters) specified for the printer or terminal. For example, if the printer is set up for 132-character page widths, the heading appears centred at character position 66.
To centre the text differently, specify the number of columns
(n) for the heading line on which the centre is to be based. For
example, C80 positions the text centred about character position 40.
It is recommended that you allow the centring to be determined by the printer or terminal setup.
D Inserts the current system date in the format dd mmm yyyy.
F Inserts the file name.
I Inserts the current item-id. The last item-id listed on the page is inserted in the footing; the first item-id on the page is inserted in the heading.
L Specifies that a new line is to start where the L appears.
N Specifies for a FOOTING to suppress automatic paging. Ignored for HEADING.
P Inserts the current page number, left-aligned, expanding to the right as the number increases.
PP Inserts the current page number right-aligned in a field of four blank spaces.
T Inserts the current system time and date in the format hh:mm:ss dd mmm yyyy.
Formatting of Options
Options that specify a value should be entered in the order in which they are to appear in the heading or footing. Do not separate options with blank spaces or commas.
Text spaces are not required between option codes. However, options that
represent values, such as page or date, are then strung together without spaces.
For example: 'PD' would be printed on the first page as: 113
Feb 1999.
To put a space between the page and the date, enter: 'P' 'D'
Example
The BREAK-ON modifier with the B option and the HEADING B option are both used.
:SORT ROOMS BY RATE WITH ROOM-CODE "ST" GUEST-NAME BED-TYPE BREAK-ON RATE "'BL'" HEADING "SUITES 'C80' 'BDL'" FOOTING "PAGE - 'PC80'" (P SUITES 82.00 25 Nov 1999 ROOMS Current Guest.. Bed........... Rate.... Type 234 McSweeney King 82.00 354 Taylor King 82.00 355 Taylor King 82.00 444 Curtis King 82.00 478 Kolman King 82.00 *** 222 O'Brien WaterBed 104.00 318 Petrillo WaterBed 104.00 365 Ferguson WaterBed 104.00 600 WaterBed 104.00 *** ***