DDS_ReliableReaderActivityChangedStatus Struct Reference

<<eXtension>> <<cert>> Describes the activity (i.e. are acknowledgements forthcoming) of reliable readers matched to a reliable writer. More...

#include <dds_c_publication.h>

Data Fields
DDS_Long	active_count
	The current number of reliable readers currently matched with this reliable writer.
DDS_Long	inactive_count
	The number of reliable readers that have been dropped by this reliable writer because they failed to send acknowledgements in a timely fashion.
DDS_Long	active_count_change
	The most recent change in the number of active remote reliable readers.
DDS_Long	inactive_count_change
	The most recent change in the number of inactive remote reliable readers.
DDS_InstanceHandle_t	last_instance_handle
	The instance handle of the last reliable remote reader to be determined inactive.

---

Detailed Description

<<eXtension>> <<cert>> Describes the activity (i.e. are acknowledgements forthcoming) of reliable readers matched to a reliable writer.

Entity:

DDS_DataWriter

Listener:

DDS_DataWriterListener

This status is the reciprocal status to the DDS_LivelinessChangedStatus on the reader. It is different than the DDS_LivelinessLostStatus on the writer in that the latter informs the writer about its own liveliness; this status informs the writer about the "liveliness" (activity) of its matched readers.

All counts in this status will remain at zero for best effort writers.

---

Field Documentation

DDS_Long DDS_ReliableReaderActivityChangedStatus::active_count

The current number of reliable readers currently matched with this reliable writer.

DDS_Long DDS_ReliableReaderActivityChangedStatus::inactive_count

The number of reliable readers that have been dropped by this reliable writer because they failed to send acknowledgements in a timely fashion.

A reader is considered to be inactive after is has been sent heartbeats DDS_RtpsReliableWriterProtocol_t::max_heartbeat_retries times, each heartbeat having been separated from the previous by the current heartbeat period.

DDS_Long DDS_ReliableReaderActivityChangedStatus::active_count_change

The most recent change in the number of active remote reliable readers.

DDS_Long DDS_ReliableReaderActivityChangedStatus::inactive_count_change

The most recent change in the number of inactive remote reliable readers.

DDS_InstanceHandle_t DDS_ReliableReaderActivityChangedStatus::last_instance_handle

The instance handle of the last reliable remote reader to be determined inactive.