- From: Katy Warr via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 May 2009 08:40:20 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv306
Modified Files:
wseventing.html wseventing.xml
Log Message:
Issue 6472 (add RetryAfter fault detail)
Index: wseventing.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wseventing.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -d -r1.38 -r1.39
--- wseventing.xml 12 May 2009 19:43:48 -0000 1.38
+++ wseventing.xml 13 May 2009 08:40:18 -0000 1.39
@@ -2049,6 +2049,35 @@
</S11:Envelope> </eg>
</example>
+ <div2 id="FaultDetailRetryElement">
+ <head>Fault Detail RetryAfter Element</head>
+ <p>
+ The following element is used to convey additional information in the faults.
+ </p>
+
+ <glist>
+ <gitem>
+ <label> /wse:RetryAfter</label>
+ <def>
+ <p>
+ This element (whose content is of type xs:unsignedLong) is a suggested
+ minimum duration in milliseconds to wait before retransmitting the message.
+ Omission of this element indicates that a retry is never likely to succeed.
+ </p>
+ </def>
+ </gitem>
+ <gitem>
+ <label> /wse:RetryAfter/@any</label>
+ <def>
+ <p>
+ Optional extensibility attributes that do not affect processing.
+ </p>
+ </def>
+ </gitem>
+ </glist>
+
+ </div2>
+
<div2 id="ModeUnavailable">
<head>DeliveryModeRequestedUnavailable</head>
@@ -2262,7 +2291,10 @@
<tr>
<td><kw>[Detail]</kw></td>
- <td><emph>none</emph></td>
+ <td>
+ <wse:RetryAfter> ?
+ <emph>(Optional)</emph>
+ </td>
</tr>
</tbody>
</table>
@@ -2298,7 +2330,10 @@
</tr>
<tr>
<td><kw>[Detail]</kw></td>
- <td><emph>none</emph></td>
+ <td>
+ <wse:RetryAfter> ?
+ <emph>(Optional)</emph>
+ </td>
</tr>
</tbody>
</table>
@@ -3433,6 +3468,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6788">6788</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/05/13 </td>
+ <td> KW </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6472">6472</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Index: wseventing.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wseventing.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -d -r1.46 -r1.47
--- wseventing.html 28 Apr 2009 21:00:19 -0000 1.46
+++ wseventing.html 13 May 2009 08:40:17 -0000 1.47
@@ -59,16 +59,17 @@
4.5 <a href="#SubscriptionEnd">Subscription End</a><br/>
5 <a href="#Notifications">Notifications</a><br/>
6 <a href="#Faults">Faults</a><br/>
- 6.1 <a href="#ModeUnavailable">DeliveryModeRequestedUnavailable</a><br/>
- 6.2 <a href="#InvalidExpirationTime">InvalidExpirationTime</a><br/>
- 6.3 <a href="#UnsupportedExpirationType">UnsupportedExpirationType</a><br/>
- 6.4 <a href="#FilteringNotSupported">FilteringNotSupported</a><br/>
- 6.5 <a href="#FilteringRequestedUnavailable">FilteringRequestedUnavailable</a><br/>
- 6.6 <a href="#EventSourceUnableToProcess">EventSourceUnableToProcess</a><br/>
- 6.7 <a href="#UnableToRenew">UnableToRenew</a><br/>
- 6.8 <a href="#InvalidMessage">InvalidMessage</a><br/>
- 6.9 <a href="#DeliveryFormatRequestedUnavailable">DeliveryFormatRequestUnavailable</a><br/>
- 6.10 <a href="#EmptyFilter">EmptyFilter</a><br/>
+ 6.1 <a href="#FaultDetailRetryElement">Fault Detail RetryAfter Element</a><br/>
+ 6.2 <a href="#ModeUnavailable">DeliveryModeRequestedUnavailable</a><br/>
+ 6.3 <a href="#InvalidExpirationTime">InvalidExpirationTime</a><br/>
+ 6.4 <a href="#UnsupportedExpirationType">UnsupportedExpirationType</a><br/>
+ 6.5 <a href="#FilteringNotSupported">FilteringNotSupported</a><br/>
+ 6.6 <a href="#FilteringRequestedUnavailable">FilteringRequestedUnavailable</a><br/>
+ 6.7 <a href="#EventSourceUnableToProcess">EventSourceUnableToProcess</a><br/>
+ 6.8 <a href="#UnableToRenew">UnableToRenew</a><br/>
+ 6.9 <a href="#InvalidMessage">InvalidMessage</a><br/>
+ 6.10 <a href="#DeliveryFormatRequestedUnavailable">DeliveryFormatRequestUnavailable</a><br/>
+ 6.11 <a href="#EmptyFilter">EmptyFilter</a><br/>
7 <a href="#Security">Security Considerations</a><br/>
7.1 <a href="#MessageSecurity">Message Security</a><br/>
7.2 <a href="#AccessControl">Access Control</a><br/>
@@ -378,11 +379,11 @@
</a></td><td>
XML Schema <a href="#XMLSchema1">[XML Schema, Part 1]</a>, <a href="#XMLSchema2">[XML Schema, Part 2]</a></td></tr></tbody></table><p>
The working group intends to update the value of the Web Services
- Transfer namespace URI each time a new version of this document is
+ Eventing namespace URI each time a new version of this document is
published until such time that the document reaches Candidate
Recommendation status. Once it has reached Candidate Recommendation
status, the working group intends to maintain the value of the
- Web Services Transfer namespace URI that was assigned in the
+ Web Services Eventing namespace URI that was assigned in the
Candidate Recommendation unless significant changes are made that
impact the implementation or break post-CR implementations of the
specification. Also see
@@ -1260,7 +1261,16 @@
</S11:Fault>
</S11:Body>
</S11:Envelope> </pre></div></div><div class="div2">
-<h3><a name="ModeUnavailable" id="ModeUnavailable"/>6.1 DeliveryModeRequestedUnavailable</h3><p>
+<h3><a name="FaultDetailRetryElement" id="FaultDetailRetryElement"/>6.1 Fault Detail RetryAfter Element</h3><p>
+ The following element is used to convey additional information in the faults.
+ </p><dl><dt class="label"> /wse:RetryAfter</dt><dd><p>
+ This element (whose content is of type xs:unsignedLong) is a suggested
+ minimum duration in milliseconds to wait before retransmitting the message.
+ Omission of this element indicates that a retry is never likely to succeed.
+ </p></dd><dt class="label"> /wse:RetryAfter/@any</dt><dd><p>
+ Optional extensibility attributes that do not affect processing.
+ </p></dd></dl></div><div class="div2">
+<h3><a name="ModeUnavailable" id="ModeUnavailable"/>6.2 DeliveryModeRequestedUnavailable</h3><p>
This fault is sent when a Subscribe request specifies a
delivery mode that is not supported by the event source.
Optionally, this fault may contain a list of supported delivery
@@ -1269,22 +1279,22 @@
<wse:SupportedDeliveryMode> +
<br/><em>Optional; one per delivery mode supported by the
receiver</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="InvalidExpirationTime" id="InvalidExpirationTime"/>6.2 InvalidExpirationTime</h3><p>
+<h3><a name="InvalidExpirationTime" id="InvalidExpirationTime"/>6.3 InvalidExpirationTime</h3><p>
This fault is sent when a Subscribe request specifies an
expiration time that is in the past or an expiration duration of
zero.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wse:InvalidExpirationTime</td></tr><tr><td><b>[Reason]</b></td><td>The expiration time requested is invalid.</td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="UnsupportedExpirationType" id="UnsupportedExpirationType"/>6.3 UnsupportedExpirationType</h3><p>
+<h3><a name="UnsupportedExpirationType" id="UnsupportedExpirationType"/>6.4 UnsupportedExpirationType</h3><p>
This fault is sent when a Subscribe request specifies an
expiration time and the event source is only capable of accepting
expiration durations; for instance, if the event source does not
have access to absolute time.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wse:UnsupportedExpirationType</td></tr><tr><td><b>[Reason]</b></td><td>Only expiration durations are supported.</td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="FilteringNotSupported" id="FilteringNotSupported"/>6.4 FilteringNotSupported</h3><p>
+<h3><a name="FilteringNotSupported" id="FilteringNotSupported"/>6.5 FilteringNotSupported</h3><p>
This fault is sent when a Subscribe request contains a filter
and the event source does not support filtering.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wse:FilteringNotSupported</td></tr><tr><td><b>[Reason]</b></td><td>Filtering is not supported.</td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="FilteringRequestedUnavailable" id="FilteringRequestedUnavailable"/>6.5 FilteringRequestedUnavailable</h3><p>
+<h3><a name="FilteringRequestedUnavailable" id="FilteringRequestedUnavailable"/>6.6 FilteringRequestedUnavailable</h3><p>
This fault is sent when a Subscribe request specifies a filter
dialect that the event source does not support. Optionally, this
fault may contain a list of supported filter dialect URIs in the
@@ -1293,25 +1303,29 @@
<wse:SupportedDialect> +
<br/><em>Optional; one per filter dialect supported by the
receiver</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="EventSourceUnableToProcess" id="EventSourceUnableToProcess"/>6.6 EventSourceUnableToProcess</h3><p>
+<h3><a name="EventSourceUnableToProcess" id="EventSourceUnableToProcess"/>6.7 EventSourceUnableToProcess</h3><p>
This fault is sent when the event source is not capable of
fulfilling a Subscribe request for local reasons unrelated to the
specific request.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Receiver</td></tr><tr><td><b>[Subcode]</b></td><td>wse:EventSourceUnableToProcess</td></tr><tr><td><b>[Reason]</b></td><td><em>Text explaining the failure; e.g., "The event
- source has too many subscribers".</em></td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="UnableToRenew" id="UnableToRenew"/>6.7 UnableToRenew</h3><p>
+ source has too many subscribers".</em></td></tr><tr><td><b>[Detail]</b></td><td>
+ <wse:RetryAfter> ?
+ <em>(Optional)</em></td></tr></tbody></table></div><div class="div2">
+<h3><a name="UnableToRenew" id="UnableToRenew"/>6.8 UnableToRenew</h3><p>
This fault is sent when the event source is not capable of
fulfilling a Renew request for local reasons unrelated to the
specific request.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Receiver</td></tr><tr><td><b>[Subcode]</b></td><td>wse:UnableToRenew</td></tr><tr><td><b>[Reason]</b></td><td><em>Text explaining the failure; e.g., "The event
- source has too many subscribers".</em></td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="InvalidMessage" id="InvalidMessage"/>6.8 InvalidMessage</h3><p>
+ source has too many subscribers".</em></td></tr><tr><td><b>[Detail]</b></td><td>
+ <wse:RetryAfter> ?
+ <em>(Optional)</em></td></tr></tbody></table></div><div class="div2">
+<h3><a name="InvalidMessage" id="InvalidMessage"/>6.9 InvalidMessage</h3><p>
If a request message does not comply with the corresponding
outline listed above, the request MUST fail and the event source
or subscription manager MAY generate the following fault
indicating that the request is invalid:
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wse:InvalidMessage</td></tr><tr><td><b>[Reason]</b></td><td>The message is not valid and cannot be processed.</td></tr><tr><td><b>[Detail]</b></td><td><em>The invalid message</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="DeliveryFormatRequestedUnavailable" id="DeliveryFormatRequestedUnavailable"/>6.9 DeliveryFormatRequestUnavailable</h3><p>
+<h3><a name="DeliveryFormatRequestedUnavailable" id="DeliveryFormatRequestedUnavailable"/>6.10 DeliveryFormatRequestUnavailable</h3><p>
This fault is sent when a Subscribe request specifies a delivery
mode that is not supported by the event source. Optionally, this
fault may contain a list of supported delivery mode URIs in the
@@ -1319,7 +1333,7 @@
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wse:DeliveryFormatRequestedUnavailable</td></tr><tr><td><b>[Reason]</b></td><td>The requested delivery format is not supported.</td></tr><tr><td><b>[Detail]</b></td><td>
<wse:SupportedDeliveryFormat> +
<br/><em> Optional, one per delivery format supported by the receiver.</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="EmptyFilter" id="EmptyFilter"/>6.10 EmptyFilter</h3><p>
+<h3><a name="EmptyFilter" id="EmptyFilter"/>6.11 EmptyFilter</h3><p>
This fault MAY be generated when an Event Source detects a
wse:Subscribe request containing a filter that, for whatever
reason, will never evaluate to true.
@@ -1970,4 +1984,5 @@
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6715">6715</a></td></tr><tr><td> 2009/04/22 </td><td> KW </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6739">6739</a></td></tr><tr><td> 2009/04/28 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6787">6787</a></td></tr><tr><td> 2009/04/28 </td><td> DD </td><td> Added resolution of issue
- <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6788">6788</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6788">6788</a></td></tr><tr><td> 2009/05/13 </td><td> KW </td><td> Added resolution of issue
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6472">6472</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
Received on Wednesday, 13 May 2009 08:40:28 UTC