messages File

The messages file contains messages used by system processes to convey information to the user.

Synonym(s)

errmsg

msgs

Description

The item-IDs are the message numbers referenced by system processors.

Item

Description

bnf

Used by the BASIC Processor.

logon

Used by the Logon Processor.

legend

Used by the Output Processor.

newmd

Used to create new accounts.

seq

Used by the ms Correlative processor.

Error Message Operands

The items in the messages file use these codes to format messages in the output buffer before displaying them:

!

Any line of an error message that begins with an ! (exclamation point) is ignored by the message handler. This feature allows storing comments within the message.

a{(n)}

Inserts into the output buffer the next parameter from the list of parameters passed with the message. The parameter is left justified in a field of n spaces.

b

Rings the terminal bell.

c

Clears the terminal screen.

d

Places the current date in the output buffer.

e

Inserts the message number (item-ID in the messages file) into the output buffer.

hstring

Places a literal string in the output buffer, with no carriage return or line feed.

l{(n)}

Prints the output buffer, followed by n-1 blank lines.

r{(n)}

Inserts the next parameter right-justified in a field of n spaces.

s(n)

Inserts n spaces in the output buffer.

t

Places the current time in the output buffer.

x

Skips a parameter in the parameter list.

Example(s)

The following example:

1202

001 HNeeds to start printers.

outputs:

Needs to start printers.

The following example:

781

001 H’

002 A

003 H’ added

outputs:

bob  added

where bob is passed into the error message handler by the process that triggers this message.

The following example:

B156

E Line

A

H illegal to ENTER a subroutine.

outputs:

[B156] Line ( number ) illegal to ENTER a subroutine.

where ( number ) is the actual program line number where the error occurred. Additional internal comments are not output.

See Also

abort Statement, bformat Command, errmsg Pointer, error Statement, Logon, print-err Command, print-error Command, Secondary Input Buffer, seq, stop Statement, u61a2 User Exit