filename.messages

Definition/Access: General, Releases: AP

Contains system messages.

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.

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.

See Also

Command Name Type Description
filename.msgs File Synonym ('q-pointer') Synonym for 'messages' file.
filename.errmsg File Synonym ('q-pointer') Q-pointer to 'messages' file.
tcl.print-err Verb: Access Displays effect of error message.
basic.abort Statement Terminates program and PROC{s}.
messages.format Definition See 'messages file'.
tcl.print-error Verb: Access Prints error message from stacked data statements.
basic.stop Statement Terminates program.
UE.61A2 User Exit Toggles terminal output.
sib Definition Description of Secondary Input Buffer.
basic.error Statement Displays error message.
seq Definition Control item used by 'ms' processing code.
tcl.bformat Verb: Access reformats a Pick/BASIC source item
logon Definition

User Comments

What do you think?

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

Login to leave your comments.