Text for the two new issues

[Peter Niblett <peter_niblett@uk.ibm.com>]

Sanjay

We agreed to raise new issues for "Substantive changes" 5 and 10.

5.  Pull-Style Notification faults (BaseNotification).  Operations on the
SubscriptionManager and PublisherRegistrationManager interfaces can return
the wsrf:ResourceUnknownFault, but  the text states that this is only sent
if the resource is a WS-Resource, and operations in these interfaces
include additional faults e.g. UnableToDestroySubscriptionFault.

The PullPoint interface does not follow this pattern. It has two operations

i)    GetMessages (line 954) lists only the wsrf:ResourceUnknownFault, and
implies that it is to be used regardless of whether the resource is a
WS-Resource
ii)   DestroyPullPoint (line 1017) lists only the
wsn:UnableToDestroyPullPointFault

Approach Agreed. Make PullPoint's faults look like SubscriptionManager's.
This means:

a) Rewrite the description of the GetMessages ResourceUnknownFault to say
the following "The PullPoint is acting as a WS-Resource, and the resource
identified in the request message is not known to the Web service. This
fault is specified by the WS-Resource [WS-Resource] specification."

b) Give GetMessages a new generic Fault, called "UnableToGetMessages". Its
description is "The PullPoint was unable to return messages for some
reason".

c) Give Destroy Pull Point a ResourceUnknownFault, with the following
description  ResourceUnknownFault to say the following "The PullPoint is
acting as a WS-Resource, and the resource identified in the request message
is not known to the Web service. This fault is specified by the WS-Resource
[WS-Resource] specification."

10. BrokeredNotification line 677  says “If PublisherRegistrationManager is
a WS-Resource, the following resource properties MAY be modified by the
requestor.. ”  This is not what was intended, as it reads as though anyone
supporting these ResourceProperties is required to make them mutable (as
opposed to "these are the ones that MAY be made mutable"). Also the text
that follows (line 680) refers to a RP called TopicExpression, but this has
been renamed to Topic.


Approach Agreed:

Reword lines 677 onwards to say “If a PublisherRegistration is exposed as a
WS-Resource, the PublisherRegistrationManager MAY permit the following
resource properties to be modified by a requestor, by sending a
SetResouceProperties request message as defined in the
WS-ResourceProperties specification: /wsn-br:Topic and /wsn-br:Demand".
Leave the note at the end of the section as that's ok.

Thank you

Peter