ACC Utilities Reference Guide

Chapter 7 177
ZMLOG - Diagnostic Message Logging
ZCOM Diagnostic Message Logging Mechanism
The messages are written by the drivers or program s in a bi nary form
which is passed to ZMLOG via the device file /dev/zmlog.Themessages
can b e optionally logged in the binary form or converted to text using the
message file, and then either logged to a file or displayed to a device.
The messages are time stamped by the LDM at the time they are
generated. The time stamped messages are written to the appropriate
text or binary log file, and optionally written to one or more device files.
Thedevicefilesmaybeusedtowritetoahardcopylogortodisplaythe
messages for the system monitoring.
The text a nd priority of the error messages are customizable. The user
can set up customer specific message information into the message file
(or one of its include files). For detailed information, see the Setting Up
Customized or Application Specific Messages.
Daily Message Files
The messages are saved into daily files. Each file contains messages
generated on a particular day. These files are kept in the directory
/var/opt/acc/log. There are 2 8 possible log files in this directory, one for
each weekday in both binary and text formats plus an .old version of
each.
Usually, the text log files a re: mon.tlog, tue.tlog, wed.tlog, thu.tlog,
fri.tlog, sat.tlog, sun.tlog , and the binary log files are: mon.blog, tue.blog,
wed.blog, thu.blog, fri.blog, sat.blog, sun.blog. All files are recycled after
1week.
As messages are logged, when a file grows to a pre-defined size limit, the
file is renamed to have an “.old”suffix(e.g.mon.blog.old, mon.tlog.old),
and t he subsequent messages are logged into a new file with the original
name (i.e. mon.blog,ormon.tlog.old). If that new file exceeds the
limit again, it will be renamed to replace the .old file. This can
cause a loss of messages as the disk space is recycled. For a single
day, the total disk space used by all the binary or text log files could be up
twice the per-file limit. The file size limit of a single binary and text log
file can be set by the zmlog -B and -T options, respectively (with a default
of 1Gb). This provides a mechanism to control the maximum disk space
used by the message files.
After 7 days, the system reuses the daily files . When files must be saved
for longer than 7 days, they must be moved or renamed so they do not get
recycled.