tcl.print-err
Displays effect of error message.
Syntax
print-err file.reference msg.list {(options)}
Description
provides a means of displaying messages from the 'messages' file in their 'output' format.
Messages are generally kept in the 'dm,messages,' file, but the process may specify any file which contains items with a similar format to the items in 'dm,messages,'. See 'messages, file, Definition' for more information on how error messages are constructed and interpreted.
'file.reference' is the name of the file, usually 'messages', that contains the message list.
'msg.list' indicates one or more item-ids of items in the 'messages' file.
Options
n No pause. Suppresses pause at end of page on terminal display.
p Directs output to printer, via the Spooler.
s Used in Pick/BASIC to allow stacked input.
Example
print-err messages 3
[3] The verb 'A' is not defined.
This looks like it did NOT work. It actually did. Message '3' prints
when an invalid verb is issued. The 'A' is where the invalid verb
would appear.
print-err messages 333
[333] The file of files cannot be cleared or deleted.
print-err messages 659 536
[659] Line printer ready.
[536] already logged off
data 'stuff'
execute 'print-err dm,messages, 201'
This Pick/BASIC code produces the output:
[201] 'stuff' is not a file name.
See Also
User Comments
What do you think?
Share your experience or ask a question by using the form below.
Login to leave your comments.