Top  Previous  Next


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





FOOTING {ON print.unit} text




print.unitidentifies 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.


textis 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.


CCenters text on the line.


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


GInsert 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.


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


LStart a new line


NInhibit automatic display pagination


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


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


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


TInserts 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.



See the RUN command for a discussion of how the page end pause on output to the screen may be affected by setting a page footing.



See also: