ermeseditor(1m)
_________________________________________________________________
ermeseditor
change or add error messages in the DG/UX system
_________________________________________________________________
SYNTAX
ermeseditor [-e] [-iINERMES] [-oOUTERMES] [-v] [-b] [-n]
file(s)
DESCRIPTION
Ermes_editor is designed specifically to change the system error
message files, /etc/ermes and /etc/extendedermes, on the DG/UX
system. These files are machine-readable ASCII files containing
the system error messages for certain products. Ermes_editor
provides a user interface for changing the messages. With
/etc/ermes_editor, you can change error messages when installing
software products. These files can be changed only by superuser.
The file /etc/ermes contains the messages for the DG/UX system
(including NFS), Fortran77, lang_rt, Pascal and C. In the
future, other products may be added. The file
/etc/extendedermes contains specific error messages only for the
DG/UX system.
Contents of the /etc/ermes File
The group codes have been established for existing products. The
same codes must be used for these products in the new file. (All
codes in the table are in octal.)
Product Group Code No. of Msg. MINMSG MAXMSG
DG/UX 0 144 1 143
Fortran77 26 1000 26000 26777
lang_rt 213 144 213000 213143
Pascal 216 1000 216000 216777
C 221 340 221000 221337
Data General reserves all group codes. By convention, the first
message (message 0) tells the product name, so it's not really
used as an error message. For example, the C message 0221000 is
:0221000 DG/UX C runtime error messages.
In normal use, only the product that "owns" the group will set
errno to its messages and the program will call perror to print
the message when an error occurs.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
ermeseditor(1m)
When adding or changing a group, the file must specify the number
of messsage slots to reserve for the group. No string need be
associated with the number. If no message exists, perror does
nothing. The new file must be called /etc/ermes for perror to
use it.
Contents of the /etc/extendedermes File
Customers should not add a new group to /etc/extendedermes
because Data General reserves all the codes.
For extended_perror(3C) to use the new file, the new file must be
installed as /etc/extendedermes.
OPTIONS
The following options can appear in any order (file(s) must be
specified last):
-e Add or change an error message in an extended group. If
this option is not used, the group being changed or added is
assumed not to be an extended group.
-i IN_ERMES
Change the file indicated by IN_ERMES. This file must be a
valid ermes file. The default files are /etc/ermes (if -e
is not selected) and /etc/extendedermes (if -e is
selected).
-o OUT_ERMES
Create the output file indicated by OUT_ERMES. The default
output files are /etc/ermes (if -e is not selected) and
/etc/extendedermes (if -e is selected). Ermes_editor will
overwrite the output file if it exists.
-v Produce verbose output. The ermes_editor prints statistics
about the ermes file.
-b Provide detailed data about the ermes_editor. This option
aids in debugging the ermes_editor.
-n Create a new ermes file. If -n is specified, no default
input ermes file will be used. If -n is not specified, the
default or specified ermes file is used (see -i option).
file(s)
Indicate the MASM source file or files containing the new
error messages for one group.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
ermeseditor(1m)
NOTE:
The name of the file must contain the .s suffix for the editor to
work.
EXAMPLES
Products ship their ermes source files(s) and invoke the
ermes_editor in their installation script. Sample invocations
for the DG/UX system, C, and lang_rt are as follows:
DG/UX system
/etc/ermes_editor /usr/lib/ermes/ermes_dgux.s
C /etc/ermes_editor cermes.s
lang_rt
/etc/ermes_editor parlang_rt.s lang_rtermes.s
FILES
/etc/ermes_editor shell script that is the user
interface to the editor
/etc/ermes the error message file
/etc/extended_ermes the extended error message file
/usr/lib/ermes/ermes_editor the actual editor
/usr/lib/ermes/ermes_converter.o object file containing code to
convert the format of the input
messages to the format used by
the ermes_editor.
/usr/lib/ermes/ermes_macros.s MASM source file containing
macros for the new messages
file
/usr/lib/ermes/extended_ermes_macros.s MASM source file containing
macros for the new extended
messages file
/usr/lib/ermes/ermes_dgux.s MASM source file containing the
error messages for DG/UX
(including NFS)
/usr/lib/ermes/extended_dgux_io.s MASM source file containing the
extended error messages for the
DG/UX IO subsystem
/usr/lib/ermes/extended_dgux_pn.s MASM source file containing the
extended error messages for the
DG/UX PN subsystem
RETURN VALUE
Upon a normal return, ermes_editor returns a value of 0.
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)
ermeseditor(1m)
Otherwise, a value of 1 is returned and a message is printed.
SEE ALSO
as(1), perror(3C) extended_perror(3C).
DG/UX 4.00 Page 4
Licensed material--property of copyright holder(s)