filename.messages Definition/Access: General

filename.messages

Command filename.messages Definition/Access: General
Applicable release versions: AP
Category Access: General (65)
Description contains messages used by system processes to convey information to the user.

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

The "bnf" item is used by the BASIC processor.

The "logon" item is used by the Logon processor.

The "legend" item is used by the Output processor.

The "newmd" item is used to create new accounts.

The "seq" item is used by the "ms" Correlative processor.

Error Message Operands:

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

! Any line of an error message that begins with an "!" is ignored by the message handler. This feature was added in AP release 5.2.5RS and 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" blanks.

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" blanks.

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.
Syntax
Options
Example
1202
001 HNeeds to start printers.

This outputs: "Needs to start printers".

781
001 H'
002 A
003 H' added

This outputs: "'thing' added", where 'thing' is 
passed into the error message handler by the process that triggers this message.

B156
E Line 
A
H illegal to ENTER a subroutine.

This outputs: "[B156] Line (number) illegal to ENTER a subroutine.", 
where (number) is the actual program line number where the error occured.
Purpose
Related filename.msgs
filename.errmsg
tcl.print-err
basic.abort
messages.format
tcl.print-error
basic.stop
ue.61a2
sib
basic.error
seq
tcl.bformat
logon