LoggingProp

This resource class provides access to Jigsaw logging properties. It allows you to change the logging properties of Jigsaw.

Inherits

The LoggingProp class inerits from the following classes:

Attributes description

The LoggingProp defines the following attributes:

org.w3c.jigsaw.logger

semantics: This property gives the name of the logger class to use. The logger class can be any class that implements the logger interface. Right now, the only implemented logger is the CommonLogger. If undefined, Jigsaw will not log any requests, and emit a warning at startup time.
type: This attribute is an editable ClassAttribute
default value: This attribute defaults to null.

org.w3c.jigsaw.logger.errlogname

semantics: This property should give the name of the error log file. The error log file is used when some abnormal situation is encoutered inside the server. Abnormal, here, means a situation that the server can't cope with (i.e., implementation bugs), rather than just HTTP errors (which are logged in the above log file). This file is also used by the server to trace important configuration actions.
type: This attribute is an editable FileAttribute
default value: This attribute defaults to <w3c.jigsaw.root>/logs/errlog

org.w3c.jigsaw.logger.logname

semantics: This property should give the name of the log file to which the logging record will be emited. Note that this property is a property of the CommonLogger (and any of its subclasses), rather than a property of the logging system as a whole.
type: This attribute is an editable FileAttribute
default value: This attribute defaults to <w3c.jigsaw.root>/logs/log

org.w3c.jigsaw.logger.tracelogname

semantics

This property should provide the name of the trace log. The trace log is used to output debugging information when the server is turned into debug mode. To turn the server into debug mode, two properties have to be turned to true (depending on what part of the server you want to debug):

org.w3c.jigsaw.trace Make the core server emit traces.
org.w3c.jigsaw.client.debug Make every clients emit traces.

type

This attribute is an editable FileAttribute

default value

This attribute defaults to <w3c.jigsaw.root>/logs/tracelog.

org.w3c.jigsaw.logger.logdirname

semantics: This property gives the name of name of the directory where to put the log files.
type: This attribute is an editable FileAttribute
default value: This attribute defaults to null. Default inferred value is vv<instdir>/Jigsaw/logs/

org.w3c.jigsaw.rotateLevel

semantics

This property gives the level of log rotation used in the logger.

0 - log name is defined by org.w3c.jigsaw.logger.logname, no rotation done
1 - log name is as above with _yyyy added, rotation done every year on January 1st 00:00.
2 - log name as 0 with _yyyy_mm added, rotation done every month on the 1st at midnight.
3 - log name as 0 with _yyy_mm_dd added, rotation done every day at 00:00.
If set to 0, the name of the logfile will be the one defined by

type

This attribute is an editable IntegerAttribute

default value

This attribute defaults to 0.

org.w3c.jigsaw.logger.bufferSize

semantics: The size of the log buffer to use. This property defines the size of the buffer used before flushing the output log. It is highly recommended to keep this value at least as high as it is. You may still, however, set it to 0 in order to prevent any buffering of log writing.
type: This attribute is an editable IntegerAttribute
default value: This attribute defaults to 8192.

Jigsaw Team
$Id: org.w3c.jigsaw.http.LoggingProp.html,v 1.2 1998/03/27 08:19:56 bmahe Exp $