Product Documentation

c-treeRTG COBOL Edition User's Guide

Previous Topic

Next Topic

<localinstance>

The <localinstance> element specifies instance-wide configurations for the standalone driver.

Note: This element is only used for standalone versions of the product.

Attributes

Attribute

Description

Default value

bufs

Specifies the number of index file cache buffers. Minimum of 3 required. Maximum is 32,767. Increasing these values can improve performance during bulk data loading.

1280

dbufs

Specifies the number of data file cache buffers. Minimum of 3 required. Maximum is 32,767. Increasing these values can improve performance during bulk data loading.

1280

fils

Specifies the initial block of file structures to allocate. Whenever the number of files required exceeds this initial amount, another block of file structures using this number is automatically allocated. Each index, whether it is a member of an index file or in a file by itself counts toward this parameter.

32

sect

Specifies the number of node sectors. Minimum of 1 required. This parameter multiplied by 128 equals the index node size. (The default of 256 = 32,768 bytes.)

256

logpath

Specifies the file path for the transaction processing log files.

""

temppath

Specifies the file path for storing temporary files.

""

sortmem

Specifies the size of sort buffers used by the local database instance.

100 MB

Example

<localinstance bufs="1000" fils="64" sect="128" dbufs="1000" logpath="/data/logs">

...

</localinstance>

Requirement

<localinstance> support requires the presence of a FairCom Standalone DLL or .SO, named ctreestd.dll or ctreestd.so for Linux/Unix systems. Contact FairCom for availability options.

Limitations

  • Standalone usage does not support transactions. In essence, any update performed on a file defined under <localinstance> is committed immediately and cannot be rolled back. A "ROLLBACK TRANSACTION" operation is ignored and a warning message is logged.
  • Standalone usage does not support <runitlockdetect>.
  • Standalone usage does not support turning off <optimisticadd>, i.e., <optimisticadd>no</optimisticadd>

TOCIndex