company logo

Application :: traceMassage - Write trace message

The function writes a message with timestamp to the trace.lst file in the directory defined in the TRACE option variable. The function is used to trace the application behavior in order to detect errors.

In order to write trace messages, the TraceMessages option has to be set to true (or YES).

Implementation details

Application  :: traceMassage ( odaba::String &sClassName, odaba::String sFunctionName, odaba::String &sText )

The trace message written to the trace file has the following format:

YYYY-MM-DD|HH:MM:SS.hh SDB-Trace:sClassname :: sFunctionName (sText)

  • sClassName - Class name

    The class name is the name of an implementation class (usually) defined in the database. Class names must not exceed 40 characters.

    In order to pass no class name, an empty string ( String() ) might be passed.

  • sFunctionName - Function name

    Name of the function to be executed.

  • sText - Text string

    The text string contains text with any kind of character encoding.