ACC Utilities Reference Guide

ZMLOG - Diagnostic Message Logging
ZCOM Diagnostic Message Logging Mechanism
Chapter 6 157
Setting Up Customized or Application Specific
Messages
Each message that can be generated by ZCOM, its daemons, its utilities,
or application programs using the ZCOM services, must have a
corresponding entry in the message file. The entries in the message file
are organized by program or module name, and message number within
that program or module. The message file is generated from one or more
text files.
When ZCOM is installed, a file default.txt is put in the directory
/opt/acc/msg. This file contains the list of text files used to make the
message file. The utility txt2msg takes this file and converts this to the
runtime message file. The file default.txt will contain entries such as
those shown below:
#include ”def.ltest.txt”
#include ”def.zmlog.txt”
#include ”def.zcom.txt”
#include ”def.zmon.txt”
#include ”def.ttgen.txt”
#include ”def.zscan.txt”
#include ”zerrmsg.txt”
#include ”zstatmsg.txt”
#include ”def.zcbug.txt”
#include ”def.watch.txt”
The convention for naming these files is:
<lang>.<program>.txt
Here <lang> is an indicator describing the language of the text and
<program> is the name of the program or module that generates the
messages. The default language is English and has the prefix of def.
When txt2msg is run, it is passed a parameter used to build the name of
the input file, and the name of the output or message file. For the default
language the run string would be:
txt2msg default
This uses the input file /opt/acc/msg/default.txt and generates the
output message file /opt/acc/msg/default.msg. For a French language
file, txt2msg might be run as follows:
txt2msg french