Transformer SDK For C
7.1.0.310211
|
modules-conf-dir
Type: String Array
Default: None
The directory where module configuration files are located. %r, %h, %a, %n and %u are expanded if encountered within this option.
modules-dir
Type: String Array
Default: None
The directory where the Transformer's modules are located. %r, %h, %a, %n and %u are expanded if encountered within this option.
modules-conf-dir
Type: String
Default: %r/etc
The directory where module configuration files are located. %r, %h, %a, %n and %u are expanded if encountered within this option.
config-file
Short option: –f
Type: String
Default: transformer.conf
Main config file
application-root
Short option: –r
Type: String
Default: /space/home/build/workspace/CDev-Transformer-7.1-linux/CDev/V-7_1/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.
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 | |
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.
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
rmi-registry-port
Type: Integer
Default: -1
Port for the RMI registry
rmi-client-port
Type: Integer
Default: -1
Port for the RMI registry
rmi-server-hostname
Type: String
Default: None
RMI server host name
stringpool-hashtable-size
Type: Integer
Default: 100000
Size of hashtable for stringpool
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
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
contrib-return
Type: Boolean
Deprecated: Yes
Default: FALSE
If the Transformer receives a contribution (i.e. data from a peer that it usually sends data to), then this option will enable the update to be returned to the peer.