[Bug 8075] New: Enum: MaxTime could be clearer

http://www.w3.org/Bugs/Public/show_bug.cgi?id=8075

           Summary: Enum: MaxTime could be clearer
           Product: WS-Resource Access
           Version: FPWD
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Enumeration
        AssignedTo: public-ws-resource-access-notifications@w3.org
        ReportedBy: dug@us.ibm.com
         QAContact: public-ws-resource-access-notifications@w3.org


Current definition of MaxTime is:
- - - - - - - - - -
[Body]/wsen:Pull/wsen:MaxTime

    This OPTIONAL element (of type xs:duration) indicates the maximum amount of
time the initiator is willing to allow the data source to assemble the Pull
response. When this element is absent, the data source is not required to limit
the amount of time it takes to assemble the Pull response.

    This is useful with data sources that accumulate elements over time and
package them into a single Pull response. 
- - - - - - - - - -

and at the end of the Pull section it says:
- - - - - - - - - -
Upon receipt of a Pull request message, the data source MAY wait as long as it
deems necessary (but not longer than the value of the wsen:MaxTime element, if
present) to produce a message for delivery to the consumer. The data source
MUST recognize the wsen:MaxTime element and return a wsen:TimedOut fault if no
elements are available prior to the request message's deadline. 
- - - - - - - - - -

This is fairly inconsistent.  The defn of MaxTime has nothing normative in it,
but the paragraph at the end of the Pull section comes really close to saying
something useful.

Proposal:
Move the sentence at the end of the Pull section into the Pull/MaxTime defn:

This OPTIONAL element (of type xs:duration) indicates the maximum amount of
time the initiator is willing to allow the data source to assemble the Pull
response. When this element is absent, the data source is not required to limit
the amount of time it takes to assemble the Pull response. **The data source 
MUST recognize the wsen:MaxTime element and return a wsen:TimedOut fault if no
elements are available prior to the request message's deadline. **


-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.

Received on Monday, 26 October 2009 16:49:57 UTC