Product Documentation

Database Administrator's Guide

Previous Topic

Next Topic

Advanced Configuration

The FairCom DB Server Configuration File gives the Administrator much more control over the operation of the FairCom DB Server than covered so far. The following detailed list of additional keywords is provided with explanations and default values for each. For completeness, all configuration options supported by the FairCom DB Server are included in this manual. The keywords in this section are listed in alphabetical order.

Note: The options listed in this section require in-depth knowledge of the operating system and hardware configurations of the specific computing environment the FairCom DB process is operating in and, as such, are intended for the appropriate personnel as required. We assume the FairCom DB Administrator will coordinate with the application developer and other members of their operations team as needed.

 
CONTEXT_HASH

Overrides the default number of hash bins for each user.

 
CRITICAL_SECTION_SPIN

Specifies the spin count for FairCom DB critical sections on Windows.

 
DH_THREAD_STACK_SZ_KB

Sets the thread stack size in kilobytes on Unix/Linux (non-Windows) systems.

 
DIST_COUNT_SEC

Sets the time interval between calls to the aggregating functions.

FLEXREC_OPTMIZE

Controls performance optimizations for tables supporting HOT ALTER TABLE.

 
LATCH_SLEEP

Specifies the sleep time for a thread synchronization object on Solaris systems (latch). Requires a custom build.

 
LATCH_SPIN

Specifies the spin count for a thread synchronization object on Solaris systems (latch). Requires a custom build.

 
LOCK_HASH

Specifies the number of hash bins available to the lock hash algorithm.

LOCK_HASH_MAX

Sets the maximum number of lock hash bins.

LOCK_HASH_LOADFAC

Sets the average number of locks in each hash bin.

LOCK_HASH_REHASHFAC

Sets the fraction of the hash bins to be reorganized.

 
MAX_FILE_WAIT_SECS

Sets the number of seconds a user thread waits for the internal threads to close the file before retrying.

 
MAX_HANDLES

Specifies the maximum number of file handles to store keys that do not fit in memory.

 
MAX_K_TO_USE

Specifies the value in kilobytes that can be used for storing key values in memory.

MAX_SQL_ISOLATION_LEVEL

Sets the maximum transaction isolation level at which SQL clients can operate.

MAX_STORE

The MAX_STORE keyword limits the per-connection amount of temporary disk space available for SQL query execution.

 
NODE_DELAY

Reuses empty index nodes after the specified number of seconds.

 
NODEQ_SEARCH

Specifies how deep (the number of nodes) to inspect the delete node queue for previously deleted index nodes before adding already existing deleted nodes to the queue.


NONTRAN_DATA_FLUSH_SEC

Sets the time limit in seconds that a data cache page can remain dirty before it is written to the file system cache.


NONTRAN_INDEX_FLUSH_SEC

Sets the time limit in seconds that an index buffer can remain dirty before it is written to the file system cache.

 
PARTITION_ESTIMATE_LIMIT

Estimates the distinct key count for a partitioned index file instead of calculating the exact distinct key count by summing the distinct key counts for each partition of that index.

 
PREIMAGE_HASH

Specifies the number of hash bins available to the preimage hash algorithm.

PREIMAGE_HASH_REHASHFAC

Sets the fraction of hash bins to be reorganized.

 
PRESYNC_THRESHOLD

Enables a feature to perform a checkpoint file system flush without blocking all of the mutexes.

QUIET_MAX_WAIT

Limit the time the server will wait before failing a ctQUIET() call.

 
SERVER_DIRECTORY

Deprecated as of FairCom DB V9.3. See LOCAL_DIRECTORY (LOCAL_DIRECTORY, LOCAL_DIRECTORY).

 
SESSCHG_ENABLE

OEM-specific abilities to change the number of sessions under program control. Not for general use.


SETENV

Can be used to limit JVM memory.

SETENV DH_DO_AHEAD

Enables logic to prepare more resultset rows than requested by the client.

 
SKIP_CTADDWORK

Disables internal thread synchronization (add work/remove work) logic in early V9 server lines. Consult with the FairCom engineering team.

SQL_OPTION AUTO_CHANGEID

Enable or disable SQL to add the changeid field to new tables.

SQL_OPTION DEL_MRT_HOST

Deletes the MRT host (physical file) when performing drop table from SQL of the last MRT defined on the table.

SUBSYSTEM SQL LATTE

Marks a section in the server configuration file ctsrvr.cfg to configure the LATTE sorting subsystem for FairCom DB SQL.

 
SYNC_DELAY

Specifies the number of seconds between log flushes. FairCom does NOT recommend the use of this option.

 
TASKER_SLEEP

Reduces FairCom DB Server CPU activity level in non-preemptive environments, thus controlling when to put itself to sleep and when to wake up.


TRAN_DATA_FLUSH_SEC

Sets the time limit in seconds that a data cache page can remain dirty before it is written to the file system cache.


TRAN_INDEX_FLUSH_SEC

Sets the time limit in seconds that an index buffer can remain dirty before it is written to the file system cache.

 
UDEFER_64YIELD_USEC

Specifies the microsecond duration of 64 consecutive yield calls. See the full explanation under UDEFER_THRESHOLD_USEC.

 
UDEFER_THRESHOLD_USEC

Specifies in microseconds the value below which yield calls are used.

 
VLEN_ERR_RETRY_LIMIT

Specifies the number of times to retry an ISAM add or update operation that fails with error VLEN_ERR. This option is disabled at compile-time by default.

In This Section

CONTEXT_HASH

CRITICAL_SECTION_SPIN

DH_THREAD_STACK_SZ_KB

DIST_COUNT_SEC

FLEXREC_OPTMIZE

LATCH_SLEEP

LATCH_SPIN

LOCK_HASH

LOCK_HASH_MAX

LOCK_HASH_LOADFAC

LOCK_HASH_REHASHFAC

MAX_FILE_WAIT_SECS

MAX_HANDLES

MAX_K_TO_USE

MAX_SQL_ISOLATION_LEVEL

MAX_STORE

NODE_DELAY

NODEQ_SEARCH

PARTITION_ESTIMATE_LIMIT

PREIMAGE_HASH

PREIMAGE_HASH_REHASHFAC

PRESYNC_THRESHOLD

QUIET_MAX_WAIT

SERVER_DIRECTORY

SESSCHG_ENABLE

SETENV

SETENV DH_DO_AHEAD

SKIP_CTADDWORK

SQL_OPTION AUTO_CHANGEID

SQL_OPTION DEL_MRT_HOST

SUBSYSTEM SQL LATTE

SYNC_DELAY

TASKER_SLEEP

UDEFER_64YIELD_USEC

UDEFER_THRESHOLD_USEC

VLEN_ERR_RETRY_LIMIT

TOCIndex