ACC Utilities Reference Guide

ZMLOG - Diagnostic Message Logging
ZCOM Diagnostic Message Logging Mechanism
Chapter 6158
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 text. Use the -m
option or specify the environment variable LANG to make ZMLOG select
a message file other than the default. See the above description for the
-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 the messages generated by progx in the
file def.progx.txt.
Message Text File 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 line. 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.