DataTrace
Set DBI to trace at the specified level.
Synopsis
The parameter is expected to be a positive integer.
Scope
This directive is only available for use in the global
(interchange.cfg) configuration file,
and will affect all websites running under the Interchange installation.
It will not work in a website's local (catalog.cfg)
configuration file.
Description
Set DBI to trace at the specified level.
Valid values are as follows:
| Level
|
Description
|
| 0
|
Trace disabled. |
| 1
|
Trace DBI method calls returning with results or errors. |
| 2
|
Trace method entry with parameters and returning with results. |
| 3
|
As above, adding some high-level information from the driver and some internal information from the DBI. |
| 4
|
As above, adding more detailed information from the driver.
Also includes DBI mutex information when using threaded Perl. |
| 5 and above
|
As above but with more and more obscure information. |
Trace level 1 is best for most Interchange debug situations.
|
Warning
The trace will only be enabled when DebugFile
is specified,
as the DebugFile is the target for the trace output.
|
|
Note
This directive only switches on tracing for locally-defined database tables.
Globally-defined tables cannot be traced at this time.
|
Example
Variable DEBUG 1
DebugFile /tmp/icdebug
DataTrace 1
|
