log
Appends a record to the system log
Index > Books > Declarative Development Guide > Reference Library > Accessor Listing > log

Rate this page:
Really useful
Satisfactory
Not helpful
Confusing
Incorrect
Unsure
Extra comments:


Module

urn:org:ten60:netkernel:ext:sys

Definition

Active URI Base

active:log

Format

<instr>
  <type>log</type>
  <operand>foo.xml</operand>
  <operator>
    <log>
      <string />
      <warning />
    </log>
  </operator>
</instr>

Syntax

ArgumentRulesDescription
typeMandatory log
operandMandatory the resource to be serialized to the log
operatorOptional optional configuration document

The log accessor is used to serialize the operand resource to the system log. It is useful for debuging, for critical failure reports or for status messages. System loggers are configured by the administrator. Log entries created using this accessor are created at the APPLICATION level.

Operator Syntax

The log accessor takes an optional operator.

If the /log/string element exists then the text of the root element of the operand is serialized. If it doesn't exist or there is no operator then the whole operand is serialized to the log.

An optional info, warning, or severe element sets the logging severity. By default the logging level is application.

Example

Write a Message to the Log

<instr>
  <type>log</type>
  <operand>
    <message>Entering critical processing section</message>
  </operand>
  <operator>
    <log>
      <string />
    </log>
  </operator>
</instr>

An example of writing a message to the log


(C) 2003, 1060 Research Limited
© 2003-2005, 1060 Research Limited. 1060 registered trademark, NetKernel trademark of 1060 Research Limited.