====== WRITER_DATA_LIFECYCLE QoS Parameter ======
[[ddsf:public:guidebook:06_append:02_quality_of_service:start|return to the Quality of Service (QoS) Parameters ]]

The WRITER_DATA_LIFECYCLE policy controls the behavior of the ''DataWriter'' with regards to the lifecycle of the data-[[ddsf:public:guidebook:06_append:glossary:i:instance|instances]] it manages, that is, the data-instances that have been either explicitly registered with the ''DataWriter'' using the register operations or implicitly by directly writing the data.

The autodispose_unregistered_instances flag controls the behavior when the DataWriter unregisters an instance by means of the unregister operations:

  * The setting ''**autodispose_unregistered_instances = TRUE**'' causes the DataWriter to dispose the instance each time it is unregistered. The behavior is identical to explicitly calling one of the dispose operations on the instance prior to calling the unregister operation.
  * The setting ''**autodispose_unregistered_instances = FALSE**'' will not cause this automatic disposition upon unregistering. The application can still call one of the dispose operations prior to unregistering the instance and accomplish the same effect. There are consequences of disposing and unregistering instances.

  ; Note
    : the deletion of a ''DataWriter'' automatically unregisters all data-instances it manages. Therefore the setting of the ''autodispose_unregistered_instances'' flag will determine whether instances are ultimately disposed when the ''DataWriter'' is deleted either directly by means of the ''Publisher::delete_datawriter'' operation or indirectly as a consequence of calling delete_contained_entities on the ''Publisher'' or the ''DomainParticipant'' that contains the ''DataWriter''. 
    
Source: [[https://www.omg.org/spec/DDS/1.4/PDF | DDS 1.4 Spec]]

/**=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
/* To add a discussion page to this page, comment out the line that says 
  ~~DISCUSSION:off~~
*/
~~DISCUSSION:on|Outstanding Issues~~
~~DISCUSSION:off~~