i-net Clear Reports

Logging Properties

In this category you can enable / disable the logging of i-net Clear Reports and / or of the used JDBC driver. Also, you can specify log file and log level.

The log file is useful if you use i-net Clear Reports as servlet in a servlet engine or Application Server or if you need to send the log output to the i-net Clear Reports support.

Properties of Logging

Logging of Driver

Enable/disable the logging of the used JDBC driver.

Default value: false

Logging of Engine

Enable/disable the logging of i-net Clear Reports's report engine.

Default value: true

Log Level

Available log levels:

  • Status
    Log only server status changes and single logs for each time a report is rendered. Note that you can completely switch off logging with the property "Logging of Engine".
  • Error
    include error messages such as "report file could not be read; rendering aborted"
  • Warn
    include warning messages such as "font not found, using a replacement font"
  • Info
    include information messages such as the JDBC driver that i-net Clear Reports uses. This log level was default in version 3.x and below.
  • Debug
    Useful if you want to send bug reports to the i-net Clear Reports support at ClearReports@inetsoftware.de. Set this log level when prompted by i-net software's technical support or if you need detailed log messages to solve the problem.

Logging is enabled, only if "Logging of Engine" is enabled.

Default value: 1

File for Logging

This log file will be used for logging instead of the standard output stream (System.out).
Use a log file for instance if you use i-net Clear Reports as a servlet and you cannot use the standard output streams for logging.

/var/tmp/cc.log
C:/ClearReports/CC.log

Date Format for Logging

Defines the Date Format pattern for Logging in Java syntax. e.g. dd-MM-yyyy HH:mm:ss.S

Default value: M/d H:mm:ss

Max Size of the Log File

Sets the maximum size (in MB) a log file should reach before being archived as <original log file name>.<index>.zip. Enter 0 to not have a limit.

Default value: 100

Max Number of Archive Log Files

Defines how many archive log files are to be kept before deleting old ones when archiving. Enter 0 to not have a limit.

Default value: 10

Log Database Data

Enable logging of the database data ("save data of the report file"). It is strongly recommended to leave this off unless you are asked to switch it on by i-net software's technical support, since it is extremely performance-intensive.
If you switch on "Log Database Data", then i-net Clear Reports will create files called CCcore<engine-id> in the current directory (or in the directory that the parameter "Database Data Path" points to).
You can read back the data with the database class DatabaseCore (append: &dll=core.dll at the end of the request URL).

Default value: false

Database Data Path

The path and prefix for CCcore files. Note that if the path does not end with a slash, then the last part is treated as a prefix.
For example c:/cccoreDir/CCCore will dump the data in the directory "c:/cccoreDir" and the files written will have the name CCCore.<report-name>
Note that even if a cccore file might end with .rpt it is not a report file but only the data to be used for the report file.

See Also:


i-net software strives to provide accurate product documentation. Please give us your feedback using the form below.
NOTE: This form is for documentation feedback only. For technical assistance, please send an email to clearreports@inetsoftware.de.

 

© Copyright 1996 - 2012, i-net software; All Rights Reserved.