itemStale

In the streamMap definition, the itemStale element identifies a column in the Event Stream Processor source stream that carries an indicator of whether or not incoming RMDS data has gone stale.

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

streamMap

Children

None

Attributes

Name	Description	Requirement
name	A string that appears in any adapter-related log entries	optional

Notes

Use this element in the streamMap if one of the columns in the source stream is a "stale" column.

RMDS itself does not supply a stale flag with regular market data, although it may pass along such a flag if it is provided by another service you are subscribing to via RMDS. If this element is used in the streamMap, the adapter sends a non-zero update value if it receives a stale flag from RMDS, or stops receiving any data from RMDS. It uses three sets of bits to indicate stale reasons.

Adapter Status Bits	Description
0	Unknown = initial state
1	ConnectionInLoss
2	ConnectionOutLoss
3–7	Reserved

Data Status Bits	Description
8	Data suspect
9	Unspecified (initializing)
10–15	Reserved

Stream Status Bits	Description
16	Unspecified = initializing
17	NonStreaming = configured as snapshot only
18	ClosedRecover = stream is closed but can be retried
19	Closed = stream is closed and not coming back
20	Redirected = part of failing over state
21	Stale = for OMM
22–24	Reserved

Example

<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>

The fourth column of the source stream is identified as the one that is updated if the adapter receives a "stale" notification or stops receiving data from RMDS.