# <Logging>

Use the Logging element to turn logging of conversion and connection messages on or off.

## Full element example

      <Logging>
        <Conversion>
          <Log                  value="no"/>
          <Path>c:\convert.log</Path>
          <MaxPrevLogSize       value="64"/>
        </Conversion>
        <Connection>
          <Log                  value="no"/>
          <Path>c:\connect.log</Path>
        </Connection>
      </Logging>

## Sub-element summary

Tag | Type | Default | Description
--- | --- | --- | ---
`<Conversion>` | n/a | n/a | Conversion log settings container element
`<Log>` | value | no | Whether to log conversion messages
`<Path>` | string | n/a | Path of conversion log file
`<MaxPrevLogSize>` | value | 64 | Maximum previous log size
`<Connection>` | n/a | n/a | Connection log settings container element
`<Log>` | value | no | Whether to log connection messages
`<Path>` | string | n/a | Path of connection log file

## <Conversion> sub-element descriptions

Conversion messages occur while content is being converted. The most common type of conversion message you may encounter is one that tells you that a file could not be opened. The referenced file is probably the target of a broken hyperlink. Such messages can help you verify what parts of your document might be broken.

### <Log>

Description
Set the value attribute of the tag to either `yes` or `no` to respectively enable or disable logging of conversion messages. If you enable logging of conversion messages, make sure to specify the path to the log file using the Path element.
Examples
This example specifies that conversion messages should be logged.

      <Log                  value="yes"/>

This example specifies that conversion messages should not be logged.

      <Log                  value="no"/>

### <Path>

Description
Set the content of the element to the path of the conversion message log file to write. Note that conversion message logging only occurs if you set the value attribute of the Log element to `yes`.
Examples
This example specifies the path of the conversion message log file.

      <Path>c:\convert.log</Path>

### <MaxPrevLogSize>

Description
Set the value attribute of the tag to the number of kilobytes of the previous log file contents to keep.

After a new conversion on a document list, if the size of the current log file exceeds the given maximum size, only the last part of the old log up to the specified maximum size is kept and then the new log is appended to the end of it.
Examples
This example specifies that 256 kilobytes of the previous log file contents should be kept.

      <MaxPrevLogSize       value="256"/>

## <Connection> sub-element descriptions

Connection messages are mainly the messages exchanged when downloading content from web servers. These messages may help in troubleshooting HTTP communication problems.

### <Log>

Description
Set the value attribute of the tag to either `yes` or `no` to respectively enable or disable logging of connection messages. If you enable logging of connection messages, make sure to specify the path to the log file using the Path element.
Examples
This example specifies that connection messages should be logged.

      <Log                  value="yes"/>

This example specifies that connection messages should not be logged.

      <Log                  value="no"/>

### <Path>

Description
Set the content of the element to the path of the connection message log file to write. Note that connection message logging only occurs if you set the value attribute of the Log element to `yes`.
Examples
This example specifies the path of the connection message log file.

      <Path>c:\connect.log</Path>

©1999-2017 DC & Co. All rights reserved.