OnixS Thomson Reuters Matching API (MAPI) Market Data Handler for C++  1.6.0.0
Public Member Functions | Public Attributes | List of all members
ConnectionConfig Struct Reference

Connection settings. More...

Public Member Functions

 ConnectionConfig ()
 Initialize default instance.
 
std::string toString () const
 Returns the string representation.
 

Public Attributes

std::string type
 Specifies the connection type.
 
std::string position
 Client network position. in common case its "<IP>/net". For example, "1.2.3.4/net".
 
std::string host
 Host.
 
std::string port
 Port.
 
std::string tokenId
 An RFA authentication token is required to logon to P2PS system. More...
 
std::string appId
 DACS application id.
 
std::string instanceId
 Is used to differentiate applications running on the same client host. More...
 
bool traceMsgToFile
 Logs RSSL messages to file. More...
 
std::string traceMsgFileName
 Sets user defined trace message file name. More...
 
std::string serverList
 A comma- or space-delimited list of hostname:port combinations, each of which functions as a Standby server node in the group to which the adapter can connect. More...
 
int responseQueueBias
 Default value: 50. More...
 
long responseQueueBatchInterval
 Default value: 1. More...
 
long responseQueueMaxBatchSize
 Default value: 1000. More...
 

Detailed Description

Connection settings.

Member Data Documentation

std::string instanceId

Is used to differentiate applications running on the same client host.

If there is more than one non-interactive provider instance running on the same host, they must be set as a different value by the provider application. Otherwise, the infrastructure component which the providers connect to will reject a login request that has the same InstanceId value and cut the connection.

long responseQueueBatchInterval

Default value: 1.

Acceptable values: >0. This parameter will set RFA/Session parameter with the same name A Timer interval that reduces thread context switches when dispatching response messages. When there are less response messages in the queue than the value of responseQueueMaxBatchSize, a timer triggers at this interval and notifies the Session thread to dispatch messages. Thus it functions as a performance-tuning parameter which balances the throughput/latency tradeoff. Different settings may have different performance results across operating systems. Setting this number higher causes a higher amount of latency when the response queue is less than responseQueueMaxBatchSize. While setting this number lower increases CPU usage, it ideally lowers latency in situations where there are less than responseQueueMaxBatchSize messages in the response queue. This parameter doesn’t apply If threadModel is set to Single.

int responseQueueBias

Default value: 50.

This parameter will set RFA/Session parameter with the same name The number of response messages that the Session will attempt to dispatch each time it is notified to dispatch. The Session is notified to dispatch by either the responseQueueMaxBatchSize number of responses being put onto the queue or by the responseQueueBatchInterval amount of time passing. Performance tuning parameter which balances the throughput / latency tradeoff. Different settings may have different performance results across operating systems. Setting this number higher will cause RFA to dispatch more response messages each time it is notified to dispatch, instead of checking if request messages are available to dispatch. This parameter doesn’t apply If threadModel is set to Single. (Or MPPerfMode is set to Latency)

long responseQueueMaxBatchSize

Default value: 1000.

Acceptable values: >=0. This parameter will set RFA/Session parameter with the same name Sets the number of messages that must be reached in the response queue before the Session thread is notified to dispatch the responses from the queue. Effectively, this is a performance tuning parameter that balances the throughput/latency tradeoff. Different settings may have different performance results across operating systems. When set to a lower value, RFA’s session will be notified to dispatch after receiving a smaller number of messages, and will continue to be notified to dispatch until it dispatches all queued messages. Ideally, a low value produces a lower latency and higher CPU usage, and vice versa for a higher setting of this parameter. If this is set too low, it can cause starvation for the Adapter threads, and can result in network disconnects. This parameter doesn’t apply If threadModel is set to Single.

std::string serverList

A comma- or space-delimited list of hostname:port combinations, each of which functions as a Standby server node in the group to which the adapter can connect.

std::string tokenId

An RFA authentication token is required to logon to P2PS system.

RFA authentication token is received by a FIX session user during FIX logon. Each permissioned RFA client is required to login into Matching FIX Gateway once per trading session to obtain a valid RFA authentication token. The same RFA authentication token can be used to login your RFA application one or more times within a given weekly trading session.

std::string traceMsgFileName

Sets user defined trace message file name.

A process ID and .xml extension will be added to this filename. Only used when traceMsgToFile is set to true.

bool traceMsgToFile

Logs RSSL messages to file.

The default file name contains the Connection name, a Process ID, and a .xml extension.

Note
Enabling this provides debugging information, but negatively impacts performance.