publication

The publication element specifies basic publishing information for this instance of the adapter.

Summary

adapter                                      (required, limit one)
  |----publication                           (required, limit one)
  |----streamMaps                            (required, limit one)
  |      '----streamMap                      (required)
  |             |----dataField               (required)
  |             |----hiResTimestampField     (optional)
  |             |----imageField              (required for L2 data)
  |             |----itemName                (required, limit one)
  |             |----itemStale               (optional)
  |             |----marketByOrderKeyField   (required)
  |             |----marketByPriceKeyField   (required)
  |             |----marketMakerKeyField     (required)
  |             |----nullField               (optional)
  |             |----respTypeNumField        (optional)
  |             |----sequenceNumber          (optional)
  |             |----serviceName             (optional)
  |             '----updateNumber            (optional)
  |----rfa                                   (required, limit one)
  '----itemLists                             (required, limit one)
         '----itemList                       (required)
                '----item                    (optional)

Parent

adapter

Children

None

Attributes

Name Description Requirement
flushInterval Specify the number of microseconds the adapter allows events to accumulate before sending them to the Event Stream Processor. A nonzero flushInterval makes event accumulation time-based. Optional (the default is 1000)
intraSubscribeDelay Specify the number of milliseconds the adapter pauses between subscription requests. Optional (the default is 100)
maxRecordsPerBlock Specify the maximum number of accumulated events that the adapter sends to the Event Stream Processor at a time. This reduces the size of each transaction or envelope fragment when there is a large number of accumulated events. For example, if 140 events have accumulated and maxRecordsPerBlock is set to 50, the adapter sends the envelope or transaction as three fragments. Optional (the default is 256)
name Specify a string that identifies the adapter instance in log file entries. Optional
pendingLimit Specify the number of events that may accumulate before the adapter sends them in to the Event Stream Processor. Using a pendingLimit makes the event accumulation count-based. Optional (the default is 256)
retryInterval Specify the number of seconds for which the adapter waits between attempts to connect to RMDS before shutting down. Optional (the default is 5)
sendAsTransactions Set to true to treat a group of updates as a single transaction or false to treat them as separate rows within an envelope. Optional (the default is false)

Notes

You can optimize the adapter's performance using the pendingLimit and flushInterval attributes, along with the maxRecordsPerBlock and sendAsTransactions attributes from the Pub/Sub interface that the adapter uses to communicate with the Event Stream Processor. See Performance Tuning for details.

Some venues send initial images as multipart messages, which may produce large data sets. The intraSubscribeDelay attribute provides the ability to pace these subscriptions and prevents the adapter from being overwhelmed by initial images. The default value is zero, which is suitable for short RIC lists. When intraSubscribeDelay is set to a nonzero value, the adapter pauses between subscription requests for the specified number of milliseconds. The suggested value is ten (10).

Example

<publication name="RMDS Adapter - low latency" retryInterval="5"
        flushInterval="0" pendingLimit="0" sendAsTransactions="0" />