FairCom RTG BTRV User Guide

yes

This value turns on the debug logging.

y, true, on, 1

no

This value turns on the debug logging.

n, false, off, 0

<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

<extfh fcd>

This attribute of <log><debug><extfh> indicates whether the FCD data structure should be dumped to the RTG log file. This option is disabled by default, meaning that only the EXTFH opcode is written to the RTG log file.

yes and no

<file>

This option logs file open/create events. An entry is logged when a file is created, opened, closed, renamed, or copied. 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 FairCom RTG 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