RAPCache Subscriber Options

RAPCache subscriber options entered on the Subscribers Configuration page update XML elements in the rapcache.xml and opensubscriber.xml configuration files.

RAPCache database options
Option Description
Login Name

User name for connecting to the RAPCache database.

Login Password

Password for connecting to the RAPCache database.

Server Hostname

Name of the machine hosting the RAPCache database.

Server Port

Port number for the RAPCache database.

TDS Packet Size

Allows the configuration of the packets sent between the RAPCache subscriber and the RAPCache database. Valid values are multiples of 512 between 1024 and 32K. Up to a point, increasing packet sizes may result in marginally better load performance.

Other RAPCache subscriber configuration options
Option Description
Bulk Batch Size (msgs)

The number of rows that can be inserted in a table partition before a commit occurs.

Bulk Insert Array Size (msgs)

The number of rows inserted into a table partition at one time. This option must be a divisor of the batch size. Larger values generally yield better performance. The memory for the bulk-insert array is preallocated for each partition of each database table reference in the message templates.

Idle Buffer Write Delay (ms)

The number of milliseconds that a table partition may sit idle with uncommitted data available for insert.

Buffer Age Limit (ms) Forces the loading of any data which has been in existence longer than the time limit. The default value for this parameter is 10000 (10 seconds). The value cannot be lower than 1 or greater than 65.5.
Interlink Transfer Location

(Optional) Directory used by the RAPCache database to hold derived data files that are to be transferred to the RAP Store database. Must be an absolute path; otherwise the RAPCache subscriber exits with an error on start-up. If unspecified, the RAPCache subscriber cannot participate in high-speed derived data file transfers, however, loading of market data occurs as usual. The default rapcache.xml sets this option to $RAP/RAPCacheSubscriber/interlink, where $RAP is the RAP R4 installation location. The installer creates an empty interlink subdirectory of the RAPCache subscriber directory and changes this value to point to it.

Log Level
The level of logging. Valid values are:
  • Error - log only errors.
  • Warning - log warnings in addition to errors.
  • Info - log informational messages in addition to messages logged at the warning level.
  • Debug - log debugging messages in addition to messages logged at the info level.
Log File

Name and location of the log file. The file name can be relative or a full path.

Template Directory

Message template location.

Number of Packet Buffers

Number of network packet buffers to create per data channel. The size of one buffer is approximately the size of the Maximum Transmission Unit of the network interfaces being used. A larger number of packet buffers means that a larger burst of traffic can be handled without requiring resends. This setting can have a value from 1 - 4294967296.

Packet Window Size

Determines how many packets are tracked for resend purposes. This setting can have a value from 1 - 4294967296. The value should be 80 - 90% of the publishers NumPacketBuffers.

Latency Check Interval (seconds)

Determines in seconds how often the network latency between publisher and subscriber is checked. This setting can have a value from 1 - 65535.

Flush Interval (ms)

Indicates in milliseconds how long a data channel can sit idle before a check is made for dropped packets. This setting can have a value from 1 - 65535

Admin Port

Port number used by the UAF agent to communicate with the subscriber. The subscriber listens for incoming administration requests on this port.

Max Connections

Determines the number of concurrent connections to the AdminChannel. Defaults to 10. Value must be in the range of 1 - 65535.

Related tasks
Adding a Channel to a Subscriber
Registering a Publisher
Related reference
RAPStore Subscriber Options
Demo Subscriber Options