EMA C++ RDM Usage Guide : 4 Source Directory Domain : 4.3 Data : 4.3.1 Source Directory Refresh and Update Payload : 4.3.1.3 Source Directory Group Filter Entry
 
4.3.1.3 Source Directory Group Filter Entry
The Group filter entry (SERVICE_GROUP_FILTER, SERVICE_GROUP_ID) conveys item group status and item group merge information. Every item stream is associated with an item group as defined by the ItemGroup provided with the item’s RefreshMsg or StatusMsg. If some kind of change impacts all items within the same group, only a single group status message need be provided. For more information on item group use and handling, see the Enterprise Message API C++ Edition Developers Guide.
If multiple group FilterEntrys are received in a single FilterList, then they should be applied in the order in which they were received.
Any default behavior is explained in the Element’s description.
 
Table 27: Source Directory Group FilterEntry Elements  
ELEMENT NAME
TYPE
RANGE/EXAMPLE
DESCRIPTION
Group
Buffer
e.g., 1.26.102
Required. Specifies the ItemGroup with which this information is associated.
This is typically represented as a series of 2-byte unsigned integers (i.e., two-byte unsigned integers written directly next to each other in the buffer). The example provided in the RANGE / EXAMPLE column of this table shows such a series, with inserted dots to help indicate two-byte value. When encoded into a buffer, do not include these dots.
MergedToGroup
Buffer
e.g., 1.26.110
Changes all items whose group currently matches the Group element to the specified MergedToGroup.
Status
State
e.g., StreamState::OpenEnum,
DataState::OkEnum,
StatusCode::NoneEnum, OK
A status change to be applied to all items whose ItemGroup matches the Group element. It is equivalent to sending a StatusMsg to each item.
The StreamState is only allowed to be OmmState.Open or OmmState.ClosedRecover.
If you need to convey group status Text or code information without changing the data state, use the value DataState::NoChangeEnum.
If present in the same message as a MergedToGroup element, this change should be applied before the merge.
This change only applies to item streams that have received a refresh or status with a state of OPEN/OK.
Refer to Section 4.4.4.2.