Product Documentation

c-treeRTG COBOL Edition User's Guide

Previous Topic

Next Topic

<debug>

The debug log option instructs the c-treeRTG to insert debug information in the log file.

Accepted Values

Value

Effect

Synonyms

yes

This value turns on the debug logging.

y, true, on, 1

no

This value turns on the debug logging.

n, false, off, 0

The debug log option also accepts the following Boolean (yes or no) sub-options to include or exclude certain types of debug information from the log file.

Children elements

Name

Description

Accepted Values

<cluster>

This value turns on logging of the result of function calls to set cluster options (such as ctSetClusterOption()). Also messages generated by c-tree internal clustering logic are logged and identified by a numeric opcode. This option is disabled by default.

yes and no

<config>

This value turns on configuration file debug logging. This option is disabled by default. This element also accepts an attribute named "full" that enables full configuration file debug logs. See the examples below to see how to use this attribute.

yes and no

<prefetch>

This value turns on prefetch debug information logging. This option is disabled by default.

yes and no

<batchaddition>

This value turns on batch addition debug information logging. This option is disabled by default.

 

<extfh>

The value turns on the logging of information about the ExtFH switcher. The following is logged: the loading of the library and function, the number of redirected instances, if the switcher is active on open (i.e., when there is at least one redirect instance), and if the calls are redirected or sent to c-tree.

yes and no

<file>

This option logs file open/create events. An entry is logged when a file is created and when it is opened. The entry includes the file name and the assigned file number. Entries are also logged when a file rule is matched and when file mapping rules are used.

yes and no

<generic>

This option disables generic debug log messages which are enabled by default when <log><debug> is not specifically set to no.

yes and no

<transaction>

This option logs all calls to TRANBEG, TRANEND, TRANABTX, and PUTHDR with parameter ctIICTbegin, ctIICTcommit, and ctIICTabort.

yes and no

<switcher>

This option logs all calls to the c-treeRTG switching logic, which is active when switching between c-tree and the native COBOL file handler.

yes and no

<startonread>

This option logs critical <startonread> events.

With <startonread> enabled, START always returns success; the next READ sequential performs the START and returns an error if START fails.

When enabled, this option logs: "previous START returned success due to <startonread> but should have returned error".

yes and no

<lock>

Enable diagnostics messages about record/file locking. Disabled by default. When enabled it writes a DEBUG LOCK message in the log each time a lock request is performed.

yes and no

<sqlize>

Enables debugging of sqlize specific messages.

yes and no

Examples

The following example enables the logging of debug information only:

<log file=mylog.txt>

<debug>yes</debug>

</log>

The following example enables debug logging of configuration and explicitly disables the debug logging of prefetch and batch addition operations:

<log file=mylog.txt>

<debug>

<config full="yes">yes</config>

<prefetch>no</prefetch>

<batchaddition>no</batchaddition>

</debug>

</log>

The following example enables debug logging each time c-treeRTG switches between c-tree and the native COBOL file handler:

<log>

<debug>

<switcher/>

</debug>

</log>

TOCIndex