tcl.legend

Verb: Access/TCL, Releases: AP

Toggles status of 'legend' output.

Syntax

legend {(options}

Description

displays the current status of 'legend' output, or toggles the display of the automatic page legend found in the item called 'legend' in the 'dm,messages,' file.

If present, the 'legend' item is output on the bottom of each page of OP (Output processor) reports directed to the spooler, unless 'legend suppress' ('leg-supp') is in effect.

The 'legend' is a static OP document stored as an item in 'dm,messages,'. This is in contrast to headings and footings, which are dynamic, changing with each page output.

Each user can have their own legend item, using 'legend*user-id' as the naming convention for the 'dm,messages,' item. For example, 'legend*bob'.

If the legend status is 'on', the system searches first for a user legend. If none exists, the default item, 'legend', is used.

Options

f Toggles legend off. Suppresses legend on Spooler output. This eliminates the need for the 'leg-supp' connective or 'k' option.

n Toggles legend on. Outputs legend on Spooler listings.

s Suppresses output of status message.

Example

legend
[1303] Legend output is suppressed.

legend (n
[1302] Legend output is active.

See Also

Command Name Type Description
tcl.legend-on Verb: Access Invokes 'legend' command with 'n' option.
user-id Definition Item-id for 'users' logon items.
access.legend-supp Modifier Suppresses 'legend' on output.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.