EMA C++ RDM Usage Guide : 4 Source Directory Domain : 4.3 Data : 4.3.1 Source Directory Refresh and Update Payload : 4.3.1.2 Source Directory State Filter Entry
 
4.3.1.2 Source Directory State Filter Entry
The State filter entry (SERVICE_STATE_FILTER, SERVICE_STATE_ID) conveys information about the current state of a service. This information usually has some bearing on the availability of data from a service. If a service becomes temporarily unavailable or becomes available again, consumers are informed via updates to this category.
A State filter entry should be present in the initial refresh, and then updated whenever needed.
 
NOTE: The LSEG Real-Time Advanced Distribution Hub does not track services that are brought down. If you bring up a service after having brought it down, you must include the Info filter entry (refer to Section 4.3.1.1).
The Status element can change the state of items provided by this service. Prior to changing a service status, LSEG recommends that you issue item or group status messages to update item states. For example, before bringing down a service, a provider application should change the Status element of all items to OmmState.ClosedRecover.
Any default behavior is explained in the Element’s description.
 
Table 26: Source Directory State FilterEntry Elements  
ELEMENT NAME
TYPE
RANGE/EXAMPLE
DESCRIPTION
ServiceState
UInt
0 | 1
Required. Indicates whether the original provider of the data is available to respond to new requests. Changes to ServiceState do not affect streams that are already open.
Available values are:
0: Service is Down
1: Service is Up
Refer to Section 4.4.3.
AcceptingRequests
UInt
0 | 1
Indicates whether the immediate provider can accept new requests and/or handle reissue requests on already open streams. Existing streams remain unaffected, however new requests may be rejected. AcceptingRequests defaults to 1.
Available values are:
0: The provider cannot accept new requests on existing streams.
1: The provider can accept new requests on existing streams.
Refer to Section 4.4.3.
Status
State
e.g., OmmState.Open, OmmState.Ok, OmmState.None, “OK”
Specifies a status change to apply to all items provided by this service. It is equivalent to sending a StatusMsg for each item.
The StreamState is only allowed to be OmmState.Open or OmmState.ClosedRecover.
This status only applies to item streams that have received a refresh or status of OPEN/OK.
Refer to Section 4.4.4.1.