Enabling an entity

To enable an DDSEntity

Checking if a status changed on an entity.

Given an DDSEntity and a DDS_StatusKind to check for, get the list of statuses that have changed since the last time they were respectively cleared.

Check if status_kind was changed since the last time it was cleared. A plain communication status change is cleared when the status is read using the entity's get_<plain communication status>() method. A read communication status change is cleared when the data is taken from the middleware via a TDataReader_take() call [see Changes in Status for details].

Changing the QoS for an entity

The QoS for an entity can be specified at the entity creation time. Once an entity has been created, its QoS can be manipulated as follows.

Get an entity's QoS settings using get_qos (abstract)

Change the desired qos policy fields

Set the qos using set_qos (abstract).

Changing the listener and enabling/disabling statuses associated with it

The listener for an entity can be specified at the entity creation time. By default the listener is enabled for all the statuses supported by the entity.

Once an entity has been created, its listener and/or the statuses for which it is enabled can be manipulated as follows.

User defines entity listener methods

Get an entity's listener using get_listener (abstract)

Enable status_kind for the listener

Disable status_kind for the listener

Set an entity's listener to entity_listener using set_listener (abstract). Only enable the listener for the statuses specified by the enabled_status_list.

Enabling/Disabling statuses associated with a status condition

Upon entity creation, by default, all the statuses are enabled for the DDS_StatusCondition associated with the entity.

Once an entity has been created, the list of statuses for which the DDS_StatusCondition is triggered can be manipulated as follows.

Given an entity, a status_kind, and the associated status_condition:
- Get the list of statuses enabled for the status_condition

Check if the given status_kind is enabled for the status_condition

Enable status_kind for the status_condition

Disable status_kind for the status_condition