Name

DataTrace — trace DBI calls with variable granularity

SYNOPSIS

granularity

DESCRIPTION

Trace Perl DBI calls with variable granularity. As this tends to produce large amounts of output, only use it if there's a strong chance that your problem is related to DBI.

Setting of 0 disables tracing.
Setting of 1 traces DBI method calls with return values (or errors).
Setting of 2 traces as (1) plus the parameters used in method calls.
Setting of 3 traces as (2) plus some high-level information from the driver, and some internal information from the DBI
Setting of 4 traces as (3) plus more detailed information from the driver. Also includes DBI mutex information when using threaded Perl
Setting of 5 traces as (4) plus more and more obscure information.

Trace level of 1 is suitable in most situations.

DIRECTIVE TYPE AND DEFAULT VALUE

Global directive

EXAMPLES

Example: Enabling DataTrace

Variable DEBUG 1
DebugFile /tmp/icdebug

DataTrace 1

NOTES

Keep in mind that, since the trace output is directed to the debug file, you need to have the DEBUG global variable defined, and DebugFile properly set.

AVAILABILITY

DataTrace is available in Interchange versions:

4.6.0-5.9.0 (git-head)

SOURCE

Interchange 5.9.0:

Source: lib/Vend/Config.pm
Line 504

['DataTrace',     'integer',        0],

Source: lib/Vend/Config.pm
Line 3973 (context shows lines 3973-3980)

sub parse_integer {
my($var, $value) = @_;
$value = hex($value) if $value =~ /^0x[\dA-Fa-f]+$/;
$value = oct($value) if $value =~ /^0[0-7]+$/;
config_error("The $var directive (now set to '$value') must be an integer\n")
  unless $value =~ /^\d+$/;
$value;
}

AUTHORS

Interchange Development Group

SEE ALSO

DebugFile(7ic), DEBUG(7ic), DumpStructure(7ic), EncryptProgram(7ic)

DocBook! Interchange!