ACC Utilities Reference Guide

178 Chapter7
ZMLOG - Diagnostic Message Logging
ZCOM Diagnostic Message Logging Mechanism
Running Without ZMLOG
Usually the ZCOM system uses ZMLOG as the message logging daemon,
however ZCOM will work correctly without ZMLOG - and will discard all
the messages that are generated. Alternatively, a user supplied program
may read t he error log device file (/dev/zmlog)inplaceofzmlog.
If a user program is used to replace ZMLOG it is responsible for
expanding the binary data stream to text, and t o log the messages to files
if required.
Setting Up ZMLOG
The ZMLOG program is usually started when the system is first booted,
but may be started or restarted at any time. It uses the time zone from
the environment in which it is started. If this is not already set, this
must be set before ZMLOG startup. For example:
TZ=PST8PDT
export TZ
/etc/zmlog
If ZMLOG is started with no options it will use its default parameters.
These are as follows:
• Text logging only
•Messagessenttosystemconsole(/dev/console)
• Default message file /opt/acc/msg/default.msg -(messagetextread
from here)
• Message log files created in path /var/opt/acc/log
• Priority set to zero - i.e., all messages logged
• Messages read from device file /dev/zmlog
The default options are equivalent to using the following run string for
ZMLOG:
/etc/zmlog -t -nb -p 0 -z /dev/zmlog -m /opt/acc/msg/default.msg \
-l /var/opt/acc/log -d /dev/console