tcl.print-err Verb: Access/TCL

tcl.print-err

Command tcl.print-err Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
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.
Syntax print-err file.reference msg.list {(options)}
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.
Purpose
Related tcl.print-error
filename.messages
filename.errmsg
basic.error
ue.8193.r83