<refentry id="printerr">
<refnamediv>
<refname>PRINTERR</refname>
<refpurpose>Print Full Text Error Messages</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>printerr</command>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
This command replaces the basic OS-9 error printing routine (F$Perr
service request) which only prints error code numbers, with a
routine the reads and displays textual error messages from the file
<filename>/d0/SYS/errmsg</filename>. Printerr's effect is system-wide.
</para>
<para>
A standard error message file is supplied with OS-9. This file can
be edited or replaced by the system manager. The file is a normal
text file with variable length line. Each error message line begins
with the error number code (in ASCII characters), a delimiter, and
the error message text. The error messages need not be in any
particular order. Delimiters are spaces or any character numerically lower then
$20. Any line having a delimiter as its first
character is considered a continuation of the previous line(s) which
permits multi-line error messages.
</para>
<warning>
<para>
Once the <command>printerr</command> command has been used,
it can not be undone. Once
installed, the <command>printerr</command> module should not be unlinked.
<command>Printerr</command> uses the current user's stack for an I/O buffer, so users
are encouraged to reserve reasonably large stacks.
</para>
</warning>
<para>
For more information see: <xref linkend="sec4.7"/>, <xref linkend="sec6.2"/>.
</para>
</refsect1>
<refsect1><title>Examples</title>
<screen>

OS9: printerr

</screen>
</refsect1>
</refentry>