ACC Utilities Reference Guide

182 Chapter7
ZMLOG - Diagnostic Message Logging
ZCOM Diagnostic Message Logging Mechanism
This uses the input file /opt/acc/msg/french.txt and generates the
output file /opt/acc/msg/french.msg.
The txt2msg output file is used by ZMLOG to expand the binary log
messages generated by ZCOM subsystem to readable t ext. Use t he -m
option or specify the environment variable LANG to make ZMLOG select
a message file other than the default. See the above description for t he
-m option.
To add an application program text file for a program called progx,
include a line such as:
#include ”def.progx.txt”
in the default.txt file. Then put t he messages generated by progx in the
file def.progx.txt.
Message Text F ile Format
The message text file is an ASCII file. It uses C-style comments, i.e.
/*...*/. Comments, blank or empty lines are ignored. It is pre-processed by
cpp (C Pre-Processor), hence it supports #define, #include, #ifdef .. as in
C files.
Apart from comments or blank lines, each line uses a $ as the first
character of the l ine. Lines begin with $NAME defines the program
name associated with the messages following it. Multiple $NAME
sections are allowed. Program name is case-sensitive.
Lines begin with $(...) define a message, using one of the following forms:
•$(m) text
•$(m)$ text
•$(m,p) text
•$(m,p)$ text
Where:
m is the message number (-99999 to 99999)
p is the message priority, -127 to 127 (if not specified, defaults to 0)
text is the message body
Note:
1. Leading and trailing spaces of message text are ignored (see 3 below).
2. No trailing LineFeed (0xA) is inserted unless a \n is specified.
3. In (b),(d), the second $ is ignored. It is used t o mark the beginning of
message text. This mechanism allows leading s paces to be specified.