modules-conf-dir

Type: String Array
Default: None

The list of directories where module configuration files are located. %r, %h, %a, %n and %u are expanded if encountered within this option.

Note: The Transformer will always search the default path %r/etc first.

modules-dir

Type: String Array
Default: None

The list of directories where the Transformer's modules are located. %r, %h, %a, %n and %u are expanded if encountered within this option.

Note: The default location for Transformer modules %/lib will be searched after the list of configured directories.

datasrc-public-addresses

Type: String Array
Default: None

External address that we can be reached at

config-file

Short option: –f
Type: String
Default: transformer.conf

Main config file

application-root

Short option: –r
Type: String
Default: /builds/platform/cdev/rtas/build

Application Root

application-name

Short option: –n
Type: String
Default: transformer

Application Name

runtime-user

Type: String
Default: None

The user to run as

event-log

Type: String
Default: %a.log

The name of the main Transformer log file. This will be placed in the directory defined by log-dir.

full-version

Type: Boolean
Default: FALSE

List all library versions

expire-time

Type: Boolean
Default: FALSE

Report licence expiry time

info-log-interval

Type: Floating Point Value
Default: 300.000000

Interval to log information

preprocessor-binary

Type: String
Default: None

This option should refer to the full path to a binary or script that can preprocess configuration files prior to them being parsed by the datasource libraries.

Depending upon your choice of preprocessor, this allows variables to be substituted, extended logical conditions to be validated and generally reducing the configuration management requirements.

The preprocessor should take as its first argument the name of the file to process, and output a rewritten configuration file to standard out.

This feature has been extensively tested using the GNU M4 macro processor.

http-download-command

Type: String
Default: wget -nv -O -

HTTP config file download command

quiet-config

Short option: –q
Type: Boolean
Default: FALSE

This is now the default

verbose-config

Short option: –v
Type: Boolean
Default: FALSE

Report all messages for config files being loaded

ignore-missing-config-files

Short option: –i
Type: Boolean
Default: FALSE

Do not fail if configuration files do not exist

enable-threaded-callbacks

Type: Boolean
Default: FALSE

Release 4.4 of the Caplin Platform introduced a major new feature and an important pre-requisite for components that sit within the platform.

Prior to 4.4, all DataSource messages were serviced on a single thread and callbacks could be guaranteed to occur only on a single thread. With 4.4, multiple threads service DataSource messages, with the result that callbacks can occur on more than one thread and that more than one callback may be in progress at any point in time.

In order to maintain source compatibility with products built using older versions of DSDK, all callbacks into the application will occur on the thread that called ds_loop(), this naturally introduces a synchronisation point and will impact performance.

Enabling this option will remove the synchronisation point and performance will be increased, however the application must be threadsafe.

syslog-facility

Type: Integer
Default: 176
Acceptable Values:

Name	Value	Desc
auth	32
authpriv	80
cron	72
daemon	24
ftp	88
kern	0
lpr	48
mail	16
news	56
security	32
syslog	40
user	8
uucp	64
local0	128
local1	136
local2	144
local3	152
local4	160
local5	168
local6	176
local7	184

Syslog Facility

event-module

Type: Integer
Default: 4
Acceptable Values:

Name	Value	Desc
epoll	1	Use the epoll event manager (Linux only)
devpoll	2	Use the /dev/poll event manager (Solaris only)
poll	4	Use the poll event manager (Unix only)
select	8	Use the select event manager (not recommended)
iocomp	16	Use the IO completion event manager (Windows only)

This option defines the default event manager used by DataSource threads. It's not recommended to change the default; DSDK will automatically find the best event manager to use on a given platform.

thread-health-core-time

Type: Floating Point Value
Default: 60.000000

If any thread is delayed for this time stop the binary and create a core dump

disable-threadname-logging

Type: Boolean
Default: FALSE

Disable logging of thread names

daemon-enable

Short option: –d
Type: Boolean
Default: FALSE

Daemon mode enable

pid-filename

Type: String
Default: %r/var/%a.pid

Filename for the pid file

license-file

Type: String
Default: license-%a.conf

License file

java-log

Type: String
Default: java.log

Java Log filename

stringpool-hashtable-size

Type: Integer
Default: 100000

Size of hashtable for stringpool

add-apikey

Type: Function
Default: None

APIKey configuration

help

Short option: –h
Type: Boolean
Default: FALSE

Display Help Options

server-type

Type: String
Default: transformer

Server type (used for monitoring)

add-module

Type: Function
Default: None

Specify a module to load, it takes the following format:

add-module <module name> [module type]

<module name> is the name of the module to load, this may be specified with or with out the .so suffix.

[module type] is an optional parameter which specifies the type of the module. If it non-zero then the module is treated as an API extension module.

default-object-status-stale

Type: Boolean
Default: FALSE

Set if the default object status of all objects should be stale

permission-hash-size

Type: Integer
Default: 65536

Size of the type 2 hash table

heartbeat-symbol

Type: String
Default: None

Symbolname for the symbol heartbeat function.

heartbeat-symbol-time

Type: Floating Point Value
Default: 30.000000

Time between symbol heartbeats

peerdown-time

Type: Floating Point Value
Default: 60.000000

After a peer has disconnected, the Transformer must remove all subscriptions that the peer has made. In order to ensure that rapid connect-disconnect cycles do not affect any data feeds, the Transformer will not discard objects until peerdown-time seconds has elapsed. This time allows a peer time to reconnect and re-request symbols.

disable-peer-status

Type: Boolean
Default: FALSE

Disable status messages following transition of peer states

system-info-label

Type: String
Default: None

Identifier for system information

stats-time

Type: Floating Point Value
Default: 10.000000

Time between collating statistics

symboluser-hashsize

Type: Integer
Default: 63

Size of hashtable for holding the details of the functinons for the Module caching functionality functionality.

map-limited-status-to-ok

Type: Boolean
Default: FALSE

Forward a LIMITED status as an OK status