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