|
138
|
1 <refentry id="printerr">
|
|
|
2 <refnamediv>
|
|
|
3 <refname>PRINTERR</refname>
|
|
|
4 <refpurpose>Print Full Text Error Messages</refpurpose>
|
|
|
5 </refnamediv>
|
|
|
6
|
|
|
7 <refsynopsisdiv>
|
|
|
8 <cmdsynopsis>
|
|
|
9 <command>PRINTERR</command>
|
|
|
10 </cmdsynopsis>
|
|
|
11 </refsynopsisdiv>
|
|
|
12
|
|
|
13 <refsect1><title>Description</title>
|
|
|
14 <para>
|
|
|
15 This command replaces the basic OS-9 error printing routine (F$PERR
|
|
|
16 service request) which only prints error code numbers, with a
|
|
|
17 routine the reads and displays textual error messages from the file
|
|
|
18 "/d0/SYS/errmsg". Printerr's effect is system-wide.
|
|
|
19 </para>
|
|
|
20 <para>
|
|
|
21 A standard error message file is supplied with OS-9. This file can
|
|
|
22 be edited or replaced by the system manager. The file is a normal
|
|
|
23 text file with variable length line. Each error message line begins
|
|
|
24 with the error number code (in ASCII characters), a delimiter, and
|
|
|
25 the error message text. The error messages need not be in any
|
|
|
26 particular order. Delimiters are spaces or any character numerically lower then
|
|
|
27 $20. Any line having a delimiter as its first
|
|
|
28 character is considered a contintjation of the previous line(s) which
|
|
|
29 permits multi-line error messages.
|
|
|
30 </para>
|
|
|
31 <para>
|
|
|
32 WARNING: Once the printerr command has been used, it can not be undone. Once
|
|
|
33 installed, the PRINTERR module should not be unlinked.
|
|
|
34 PRINTERR uses the current user's stack for an I/O buffer, so users
|
|
|
35 are encouraged to reserve reasonably large stacks.
|
|
|
36 </para>
|
|
|
37 <para>
|
|
|
38 For more information see: 4.7, 6.2
|
|
|
39 </para>
|
|
|
40 </refsect1>
|
|
|
41 <refsect1><title>Examples</title>
|
|
|
42 <screen>
|
|
|
43
|
|
|
44 OS9: printerr
|
|
|
45
|
|
|
46 </screen>
|
|
|
47 </refsect1>
|
|
|
48 </refentry>
|
|
|
49
|
