streamMap

The streamMap element of the input map file defines the mappings between the columns of an Event Stream Processor source stream and the RMDS FIDs being subscribed to by 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

streamMaps

Children

The following child elements are defined for streamMap. These child elements can occur in any order, but for a specific streamMap, the order of the child elements must mirror the order of the columns of the source stream (as defined in the project). This is how the adapter is configured to deliver RMDS updates to the appropriate rows in the source stream.

Name Requirement
dataField One required, two or more supported
dateTimeField Zero or more supported
imageField Required for Level 2 data
itemName One required, two or more supported
itemStale Zero or one supported
marketByOrderKeyField Required for Level 2 MARKET_BY_ORDER messages
marketByPriceKeyField Required for Level 2 MARKET_BY_PRICE messages
marketMakerKeyField Required for Level 2 MARKET_MAKER messages
nullField Zero or more supported
respTypeNumField Zero or more supported
sequenceNumber Zero or more supported
serviceName Zero or more supported
updateNumber Zero or more supported

Attributes

Name Description Requirement
name Identifies the source stream to which the RMDS updates are mapped; must match the name of a source stream defined in the Event Stream Processor project Required
sendAsTransactions 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

None

Example

<streamMaps>
        <streamMap name="marketByOrderStream">
                <itemName key="true"/>
                <!-- serviceName / -->
                <sequenceNumber />
                <itemStale/>
                <dataField name="BID"/>
                <dataField name="ASK"/>
                <dataField name="TRDPRC_1"/>
                <dataField name="ACVOL_1"/>
                <dateTimeField timeName="TIMACT" dateName="ACTIV_DATE"/>
        </streamMap>
</streamMaps>

This example maps a set of the adapter's updates to an Event Stream Processor source stream named marketByOrderStream. All updates going to this source stream are added using the upsert opcode.

The RICs for which updates are sent to this source stream are specified in an itemList elsewhere in the map file that also references marketByOrderStream.