Issue 10674: In section 3.1.6.3.5 regarding the CacheListener clarify some things (data-distribution-rtf)
Source: PrismTech (Mr. Erik Hendriks, erik.hendriks(at)prismtech.com)
Nature: Clarification
Severity: 
Summary: Problem (1/3):
In the description for the on_begin_updates it says at the end '(assuming that updates_enabled is true)', which is a bit vague as to the context of that statement. Replace it with something like "This operation will only be triggered for a Cache which has updates_enabled set to true." That statement should also be added at the end of the on_end_updates operation.
This clarification is required because the other two operations are not dependant on the state of the updates_enabled…

Solution (1/3):
Replace:
o on_begin_updates indicates that updates are following. Actual modifications in the cache will be performed only when exiting this method (assuming that updates_enabled is true).
o on_end_updates indicates that no more update is foreseen.

With:
o on_begin_updates indicates that updates are following. Actual modifications in the Cache will be performed only when exiting this method. This operation will only be triggered for a Cache which has updates_enabled set to true.
o on_end_updates indicates that no more update is foreseen. This operation will only be triggered for a Cache which has updates_enabled set to true.


Problem (2/3):
The paragraph following the descriptions for all operations says: "In between, the updates ….". Since two new operations where added in the last spec revision this statement is now unclear. In between which operations? This should be clarified to state in between the on_begin_updates and on_end_updates.

Solution (2/3):
Replace:
In between, the updates are reported on home or selection listeners. Section 3.1.6.4, "Listeners Activation," on page 3-41 describes which notifications are performed and in what order.
With:
In between the on_begin_updates and the on_end_updates calls the updates are reported on home or selection listeners. Section 3.1.6.4, "Listeners Activation," on page 3-41 describes which notifications are performed and in what order.

Problem (3/3):
The description for the on_updates_enabled and on_updates_disabled both start with a wrong quotation mark. It should be removed.

Solution (3/3):
Replace:
o "on_updates_enabled - indicates that the Cache has switched to automatic update mode. Incoming data will now trigger the corresponding Listeners.
o "on_updates_disabled - indicates that the Cache has switched to manual update mode. Incoming data will no longer trigger the corresponding Listeners, and will only be taken into account during the next refresh operation.
With:
o on_updates_enabled - indicates that the Cache has switched to automatic update mode. Incoming data will now trigger the corresponding Listeners.
o on_updates_disabled - indicates that the Cache has switched to manual update mode. Incoming data will no longer trigger the corresponding Listeners, and will only be taken into account during the next refresh operation.

Resolution: 
Revised Text: 
Actions taken:
February 12, 2007: received issue
Discussion: 
In section 3.1.6.3.5 regarding the CacheListener clarify some things… And remove some typos
End of Annotations:=====
iler: QUALCOMM Windows Eudora Version 7.0.1.0
Date: Mon, 12 Feb 2007 14:53:54 -0500
To: issues@omg.org, data-distribution-rtf@omg.org
From: Juergen Boldt <juergen@omg.org>
Subject: issue 10674  - DDS RTF issue
X-Virus-Scanned: by amavisd-new-20030616-p10 (Debian) at omg.org


This is issue # 10674   From: "Erik Hendriks" <Erik.Hendriks@prismtech.com>


In section 3.1.6.3.5 regarding the CacheListener clarify some things
In section 3.1.6.3.5 regarding the CacheListener clarify some things. And remove some typos

Problem (1/3):
In the description for the on_begin_updates it says at the end '(assuming that updates_enabled is true)', which is a bit vague as to the context of that statement. Replace it with something like "This operation will only be triggered for a Cache which has updates_enabled set to true." That statement should also be added at the end of the on_end_updates operation.
This clarification is required because the other two operations are not dependant on the state of the updates_enabled.

Solution (1/3):
Replace:
o on_begin_updates indicates that updates are following. Actual modifications in the cache will be performed only when exiting this method (assuming that updates_enabled is true).
o on_end_updates indicates that no more update is foreseen.

With:
o on_begin_updates indicates that updates are following. Actual modifications in the Cache will be performed only when exiting this method. This operation will only be triggered for a Cache which has updates_enabled set to true.
o on_end_updates indicates that no more update is foreseen. This operation will only be triggered for a Cache which has updates_enabled set to true.


Problem (2/3):
The paragraph following the descriptions for all operations says: "In between, the updates ..". Since two new operations where added in the last spec revision this statement is now unclear. In between which operations? This should be clarified to state in between the on_begin_updates and on_end_updates.

Solution (2/3):
Replace:
In between, the updates are reported on home or selection listeners. Section 3.1.6.4, "Listeners Activation," on page 3-41 describes which notifications are performed and in what order.
With:
In between the on_begin_updates and the on_end_updates calls the updates are reported on home or selection listeners. Section 3.1.6.4, "Listeners Activation," on page 3-41 describes which notifications are performed and in what order.

Problem (3/3):
The description for the on_updates_enabled and on_updates_disabled both start with a wrong quotation mark. It should be removed.

Solution (3/3):
Replace:
o "on_updates_enabled - indicates that the Cache has switched to automatic update mode. Incoming data will now trigger the corresponding Listeners.
o "on_updates_disabled - indicates that the Cache has switched to manual update mode. Incoming data will no longer trigger the corresponding Listeners, and will only be taken into account during the next refresh operation.
With:
o on_updates_enabled - indicates that the Cache has switched to automatic update mode. Incoming data will now trigger the corresponding Listeners.
o on_updates_disabled - indicates that the Cache has switched to manual update mode. Incoming data will no longer trigger the corresponding Listeners, and will only be taken into account during the next refresh operation.

Juergen Boldt
Director, Member Services
Object Management Group
140 Kendrick St
Building A Suite 300
Needham, MA 02494
USA

tel: +1 781 444 0404 x 132
fax: +1 781 444 0320
email: juergen@omg.org
www.omg.org