RTI Connext DDS Micro C++ API  Version 3.0.1
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups
DDS_HistoryQosPolicy Struct Reference

<<cert>> Specifies the behavior of RTI Connext DDS Micro in the case where the value of a sample changes (one or more times) before it can be successfully communicated to one or more existing subscribers. More...

#include <dds_c_infrastructure.h>

List of all members.

Public Attributes

DDS_HistoryQosPolicyKind kind
 Specifies the kind of history to be kept.
DDS_Long depth
 Specifies the number of samples to be kept, when the kind is DDS_KEEP_LAST_HISTORY_QOS.

Detailed Description

<<cert>> Specifies the behavior of RTI Connext DDS Micro in the case where the value of a sample changes (one or more times) before it can be successfully communicated to one or more existing subscribers.

This QosPolicy controls whether RTI Connext DDS Micro should deliver only the most recent value, attempt to deliver all intermediate values, or do something in between.

On the publishing side this policy controls the samples that should be maintained by the DDSDataWriter on behalf of existing DDSDataReader entities.

On the subscribing side it controls the samples that should be maintained until the application "takes" them from RTI Connext DDS Micro.

RTI Connext DDS Micro supports DDS_KEEP_LAST_HISTORY_QOS kind.

Entity:
DDSTopic, DDSDataReader, DDSDataWriter
Properties:
RxO = NO
Changeable = NO
See also:
DDS_ReliabilityQosPolicy
DDS_HistoryQosPolicy

Usage

This policy controls the behavior of RTI Connext DDS Micro when the value of an instance changes before it is finally communicated to some of its existing DDSDataReader entities.

For kind set to DDS_KEEP_LAST_HISTORY_QOS, RTI Connext DDS Micro will only attempt to keep the latest values of the instance and discard the older ones. In this case, the value of depth regulates the maximum number of values (up to and including the most current one) RTI Connext DDS Micro will maintain and deliver. The default (and most common setting) for depth is 1, indicating that only the most recent value should be delivered.

Consistency

The setting of HISTORY depth must be consistent with the RESOURCE_LIMITS max_samples_per_instance. For these two QoS to be consistent, they must verify that depth <= max_samples_per_instance.

See also:
DDS_ResourceLimitsQosPolicy

Member Data Documentation

DDS_HistoryQosPolicyKind DDS_HistoryQosPolicy::kind

Specifies the kind of history to be kept.

[default] DDS_KEEP_LAST_HISTORY_QOS

DDS_Long DDS_HistoryQosPolicy::depth

Specifies the number of samples to be kept, when the kind is DDS_KEEP_LAST_HISTORY_QOS.

If a value other than 1 (the default) is specified, it should be consistent with the settings of the RESOURCE_LIMITS policy. That is:

depth <= DDS_ResourceLimitsQosPolicy::max_samples_per_instance

[default] 1

[range] [1,2147483647]


RTI Connext DDS Micro C++ API Version 3.0.1 Copyright © Thu Oct 24 2019 Real-Time Innovations, Inc