ACC Utilities Reference Guide

ZMLOG - Diagnostic Message Logging
ZCOM Diagnostic Message Logging Mechanism
Chapter 6 163
NOTE ZMLOG internally uses sprintf() to convert the arguments to display
text. However, due to technical difficulty with sprintf() in supporting
arbitrary 64-bit parameters (i.e. ZCOM_AT_INT64 or
ZCOM_AT_UINT64), ZMLOG can only display the value of the lower
32-bit for each 64-bit argument logged. This means a program may log a
message with 64-bit arguments, say, using Zc_INT64(value), but the
message text should use conversion specification, say %d, for such
arguments. %ld or %lld should not be used. When this technical problem
is resolved in the future, the message text can then be modified to
accommodate 64-bit conversion specification.
Format of Message Displays
The basic format of the messages displayed by ZMLOG is:
[HH:MM:SS] [Program_Name][Error#] [Level#] [Error message text]
Where the following fields are used:
[HH:MM:SS] Time that acclog read the error message
[Program_Name] Name of program or module that generated message
[Error#] Error number of the message for reference 0-99999
[Level#] Priority level of the message
[Message text] 1 to 200 character message text
For example a message generated by the zcom driver would look like:
19:23:18 zcom 00000 _ System bootup
The priority level for this message is 0 and is displayed as a blank in the
message. In this example the position is shown by the _ character.