heading Modifier

The heading modifier designates a text string composed of literals and special options to output at the top of each page.

Syntax

heading "{{text} {’options’}...}"

Synonym(s)

header

Parameter(s)

text

Text to display in the footing.

options

''

(Two single quotation marks) Outputs (one) single quotation mark.

'attr.name'

Inserts the value of the attribute name. Processes any conversion codes, but not correlatives in the attribute-defining item.

b

Inserts the value of the attribute causing the break if the b option has been specified with roll-on or break-on.

c

Centers the output line.

d

Retrieves the current date (dd mmm yyyy format).

f{n}

Inserts the file name in a field of n spaces.

j

Right-justifies the rest of the line.

l

Issues a CR/LF.

n

Prevents the pause at the end of each page (such as nopage modifier).

p

Retrieves the current page number, right-justified in a field of four spaces.

p{n}

Retrieves the page number, right-justified in a field of n spaces (default n=4).

r

Retrieves the Roman numeral page number.

s

Toggles on italics mode.

t

Retrieves the current time and date (hh:mm:ss dd mmm yyyy format).

u

Toggles on underline mode on a dumb terminal.

v

Toggles on boldface mode on a dumb terminal.

xc

Used with the c option to center a segment. The xc delimits the end of the segment.

xs

Toggles off italics mode on a dumb terminal.

xu

Toggles off underline mode on a dumb terminal.

xv

Toggles off boldface mode on a dumb terminal.

Example(s)

This heading modifier first issues a line feed, and then centers doolittle enterprises on the output device. It then issues another line feed and centers customer report on the next line. The last l forces a blank line between the heading text and the output on the report.

list customers heading "’lc’doolittle enterprises’lc’customer report’l’"

See Also

footing Modifier

listc Command