EMA C++ RDM Usage Guide : 4 Source Directory Domain : 4.3 Data
 
4.3 Data
4.3.1 Source Directory Refresh and Update Payload
A list of services is represented by a Map. Each MapEntry represents a known service and is uniquely identified by its ServiceId (i.e., its key).
The information about each service is represented as a FilterList. Each FilterEntry contains one of six different categories of information. These categories should correspond to the Filter member of the refresh or update. These categories are described in Table 24.
 
Figure 7. Source Directory Refresh and Update Message Payload
 
Table 23: Source Directory Map Contents  
KEY TYPE
CONTAINER TYPE
PERMISSION DATA
DESCRIPTION
UInt for a service ID
FilterList
Not used
Contains information for each known service. The key is the service’s ServiceId.
There are six categories of information about a service, each represented by one FilterEntry. Categories can be added or updated in update messages (note that the clear action FilterEntry.Clear is not used, and that the Info category should not change) for Directory and Dictionary domain message models as part of a reissue. None of these categories use permission data. In the following table, the description for each FilterEntry includes whether the content is extensible.
 
Table 24: Source Directory MapEntry Filter Entries  
FilterEntry ID
(CORRESPONDING Filter BIT-VALUE)
TYPE
DESCRIPTION
SERVICE_INFO_ID=
(SERVICE_INFO_FILTER=)
ElementList
Provider applications must be able to provide this information.
Identifies a service and its available data. This content is extensible.
Refer to Section 4.3.1.1.
SERVICE_STATE_ID
(SERVICE_STATE_FILTER=
ElementList
Provider applications must be able to provide this information.
Describes the current state of a service (i.e., the service’s current ability to provide data). Can also change the status of all items associated with this service. This content is not extensible.
The effects of this category occur immediately. Therefore, the initiating UpdateMsg should set DoNotConflate to true.
Refer to Section 4.3.1.2.
SERVICE_GROUP_ID=
(SERVICE_GROUP_FILTER=)
ElementList
Manages group information. Can change the status of a group of items or merge items from one group to another. This content is not extensible.
The effects of this category occur immediately and only affect existing items. Therefore, the initiating UpdateMsg should set DoNotConflate and DoNotCache to true.
Refer to Section 4.3.1.3.
SERVICE_LOAD_ID=
(SERVICE_LOAD_FILTER=)
ElementList
Information about the current allowable workload of this service, including how many items are currently being serviced. This content is extensible.
Optionally, the initiating UpdateMsg can set DoNotConflate to true.
Refer to Section 4.3.1.4.
SERVICE_DATA_ID=
(SERVICE_DATA_FILTER=)
ElementList
Includes broadcast data that applies to all items requested from that service. This information is typically provided in a dedicated UpdateMsg and sent independently of other filter entries. The data filter is commonly used with ANSI Page-based data. This content is extensible.
Flag values DoNotConflate and DoNotCache can optionally be set to true to prevent conflation and caching of this content.
Refer to Section 4.3.1.5.
SERVICE_LINK_ID
(SERVICE_LINK_FILTER)
Map
Provides information about individual upstream sources that provide data for this service. This is primarily used by systems that aggregate sources (such as the LSEG Real-Time Advanced Distribution Hub) for identification and load balancing, and is not required to be processed by a consumer application. This content is not extensible.
Refer to Section 4.3.1.6.