FOOTING

The FOOTING statement defines text to be printed or displayed at the foot of each page of output.

Format

FOOTING {ON print.unit} text

where

print.unit

identifies the logical print unit in the range -1 to 255 to which the footing text is to be applied. If omitted, the default print unit (unit 0) is used.

text	is the footing text. This may include control tokens as described below.

The FOOTING statement defines the text of a page footing and, optionally, control information determining the manner in which the text is output. A page footing is output whenever the bottom of the page is reached or on execution of a PAGE statement to terminate the current page.

The footing text may include the following control tokens enclosed in single quotes. Multiple tokens may appear within a single set of quotes.

C	Centres text on the line.

D	Inserts the date. The default format is dd mmm yyyy (e.g. 24 Aug 2005) but can be changed using the DATE.FORMAT command.

Insert a gap. Spaces are inserted in the footing line at the position of each G control token such that the overall length of the line is the same as the printer unit width. A single use of the G token will right justify the subsequent text. Multiple G tokens will distribute spaces as evenly as possible.

When a footing line uses both G and C, the footing is considered as a number of elements separated by the G control options. The element that contains the C option will be centered. The items either side of the centered element are processed separately when calculating the number of spaces to be substituted for each G option.

Hn	Sets horizontal position (column) numbered from one. Use of H with C or with a preceding G token may have undesired results.

L	Start a new line

N	Inhibit automatic display pagination

O	Reverses the elements separated by G tokens in the current line on even numbered pages. This is of use when printing double sided reports.

Pn	Insert page number. The page number is right justified in n spaces, widening the field if necessary. If omitted, n defaults to four.

Sn	Insert page number. The page number is left justified in n spaces, widening the field if necessary. If omitted, n defaults to one.

T	Inserts the time and date in the form hh:mm:ss dd mmm yyyy. The format of the date component can be changed using the DATE.FORMAT command.

Unrecognised control tokens are ignored. A quotation mark may be inserted in the printed text by using two adjacent quotation marks in the text string.

There is no limit to the length of a footing text. Each line will be truncated at the width of the print unit. The effect of using a footing which will not fit on to the physical page is undefined.