ue.0192

User Exit/PROC, Releases: R83 3.1, R83 3.0, and R83 2.2

General output formatting capabilities.

Syntax

u0192 format.spec : -> t

Description

used for general output formatting.

Output values can be literals, attribute values, or converted attribute values.

'Format.spec' may be one or more of the following values:

h{nn} string

Places 'string' in the output buffer. If 'nn' is specified, the value is output starting at output column 'nn'. If 'nn' is omitted, the value is output at the current column position in the output buffer.

h{nn} %mm

Places the value located at the 'mmth' position of the primary input buffer into the current output buffer. If 'nn' is specified, the value is output starting at column 'nn'. If 'nn' is omitted, then the value is output at the current column position in the output buffer.

h{nn} #mm

Places the value located at the 'mmth' position of the primary output buffer into the current output buffer. If 'nn' is specified, the value is output starting at output column 'nn'. If 'nn' is omitted, the value is output at the current column position in the output buffer.

l

Re-routes output to the printer instead of the terminal. The terminal is re-selected for output at the end of the user exit.

p{nn}

Page-ejects. The value, 'nn', places 'nn' formfeeds in the current output buffer. If 'nn' is omitted, it is assumed to be one.

s{nn}

Vertical spacing. The value, 'nn', places 'nn' carriage return/line feeds in the current output buffer. If 'nn' is omitted, it is assumed to be one.

v{nn} file.reference item.reference attribute.mark.count

Retrieves a specific value from an attribute in an item. If 'nn' is specified, the value is output starting at output column 'nn'. If 'nn' is omitted, the value is output at the current column position in the output buffer.

x{nn}

Horizontal spacing. The value, 'nn', places 'nn' spaces in the current output line. If 'nn' is omitted, it is assumed to be zero.

*{nn} file.reference item.reference attribute.reference

Retrieves the specified value of an attribute in an item. If 'nn' is specified, the value is output starting at output column 'nn'. If 'nn' is omitted, the value is output at the current column position in the output buffer. This is similar to the 'v' format.spec, with the following important exceptions:

a) the value is referenced by attribute name instead of the attribute number, and

b) conversion is performed as specified by the dictionary v/conv entry, before output.

-> t{+}

Format specification terminator. A space is required between the '->' and the 't'. The 't' may optionally be followed by a '+' to suppress the final carriage return/line feed.

See Also

Command Name Type Description
proc.user.exits Command List of PROC user exits.
ue.01a6 User Exit Used for cursor control.
ue.5193 User Exit Beeps the terminal.
proc.t Command Terminal addressing and effect function.

User Comments

What do you think?

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

Login to leave your comments.