4
Calendar SDK Configuration Settings

This chapter contains detailed information on Oracle Calendar SDK configuration settings. These settings may be placed in a text file, the name of which must be passed to the function CSDK_SetConfigFile. The structure of the file is:

[<section>]

<keyword>=<value>

...

Example 4-1 Configuration Settings Text File

[CAPI]
client_name = mycool.fcgi
client_version = 1.0
[LOG]
log_activity = true
log_modulesinclude = {CAPI}

The supported configuration settings are:

• blocking
• client_name
• client_version
• cncachesize
• direntrycachesize
• emailcachesize
• itemcachesize
• log_activity
• log_modulesinclude
• max_caldomain
• max_masternode
• max_sysop
• max_user
• securitycachesize
• tzcachesize

blocking

Used to configure whether a connection request will block or return an error if there are no available connections.

Section

CONNPOOL

Values

true/false

Default Value

true

client_name

Used to set the application name which be visible in the server stats.

Section

CAPI

Values

any string

Default Value

""

client_version

Used to set the application version which be visible in the server stats.

Section

CAPI

Values

any string

Default Value

""

cncachesize

Used to set the maximum number of entries to hold in common name cache.

Section

CACHE

Values

[0..U32MAX]

Default Value

512

direntrycachesize

Used to set the maximum number of entries to hold in the directory entry cache.

Section

CACHE

Values

[0..U32MAX]

Default Value

512

emailcachesize

Used to set the maximum number of entries to hold in the e-mail address cache.

Section

CACHE

Values

[0..U32MAX]

Default Value

512

itemcachesize

Used to set the maximum number of entries to hold in the item cache.

Section

CACHE

Values

[0..U32MAX]

Default Value

512

log_activity

Used to enable "activity" (high-level) logging.

Section

LOG

Values

true/false

Default Value

false

See also:

log_modulesinclude

log_modulesinclude

Used to control which modules have logging enabled.

This should be set to "{CAPI}", otherwise no logging will be performed even if it is enabled (e.g. via log_activity = true)

Section

LOG

Values

"" or "{ CAPI }"

Default Value

""

max_caldomain

Used to set the maximum # of caldomainserver connections for the given server name/node ID in the connection pool.

Section

CONNPOOL

Values

[0..S32MAX]

Default Value

0

max_masternode

Used to set the maximum number of masternode connections for the given server name/node ID in the connection pool.

Section

CONNPOOL

Values

[0..S32MAX]

Default Value

0

max_sysop

Used to set the maximum number of Calendar SYSOP connections for the given server name/node ID in the connection pool.

Section

CONNPOOL

Values

[0..S32MAX]

Default Value

0

max_user

Used to set the maximum number of user connections for the given server name/node ID in the connection pool.

Section

CONNPOOL

Values

[0..S32MAX]

Default Value

none, value required to use connection pooling

securitycachesize

Used to set the maximum number of entries to hold in the security record cache.

Section

CACHE

Values

[0..U32MAX]

Default Value

512

tzcachesize

Used to set the maximum number of entries to hold in the time zone record cache.

Section

CACHE

Values

[0..U32MAX]

Default Value

256