The LoggingProp reference manual

All resources All frames

# 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:

- Resource
- PropertySet

## Attributes description

The LoggingProp defines the following attributes:

- org.w3c.jigsaw.logger
- org.w3c.jigsaw.logger.errlogname
- org.w3c.jigsaw.logger.logname
- org.w3c.jigsaw.logger.tracelogname
- org.w3c.jigsaw.logger.logdirname
- org.w3c.jigsaw.logger.rotateLevel
- org.w3c.jigsaw.logger.bufferSize

`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 $