ISSUE-19: Normative statements 3001, 3002, 3003 overlap and/or are redundant

3001, 3002, 3003 overlap

Normative statements 3001, 3002, 3003 overlap and/or are redundant

State:
CLOSED
Product:
Raised by:
Eric Johnson
Opened on:
2009-10-26
Description:
From email:
http://lists.w3.org/Archives/Public/public-soap-jms/2009Oct/0025.html

Description:

Normative statement 3001:
"Various JMS properties described in the SOAP/JMS binding specification
may be set in three places in the WSDL — the binding, the service, and
the port. Values specified at the service will propagate to all
ports/endpoints. Values specified at the binding will propagate to all
ports/endpoints using that binding."

(Note that the above has no RFC 2119 keywords used appropriately)

Normative statement 3002:
"If a property is specified at multiple levels, the most specific
setting MUST take precedence (port first, then service, then binding)."

Normative statement 3003:
"Properties expressed in the URI [IETF RFC 3987] MUST override any
values set in the markup as described above."

>From the above, 3001 indicates how values propagate (binding, service,
port), 3002 indicates which ones take priority (port, service, binding),
and then 3003 throws the URI into the mix (URI, port, service, binding).

This boils down to three normative statements about almost exactly the
same thing, which is confusing and redundant.

Proposal:

Section 3.4.4:

Replace:

"Various JMS properties described in the SOAP/JMS binding specification
may be set in three places in the WSDL — the binding, the service, and
the port. Values specified at the service will propagate to all
ports/endpoints. Values specified at the binding will propagate to all
ports/endpoints using that binding.† For example, the
jndiInitialContextFactory may be indicated for a wsdl11:service, and it
is then implied for all of the contained wsdl11:port elements.

If a property is specified at multiple levels, the most specific setting
MUST take precedence (port first, then service, then binding). †"

--- with ---

Various JMS properties described in the SOAP/JMS binding specification
can be set in four places in the WSDL — the binding, the service, the
port, and the URI for the port. Values specified at the service will
propagate to all ports/endpoints. Values specified at the binding will
propagate to all ports/endpoints using that binding. For example, the
jndiInitialContextFactory may be indicated for a wsdl11:service, and it
is then implied for all of the contained wsdl11:port elements.

If a property is specified at multiple levels, the most specific setting
MUST take precedence (URI first, then port, then service, then binding). †

---

In addition, remove the normative statement 3003:
"Properties expressed in the URI [IETF RFC 3987] MUST override any
values set in the markup as described above.†"

---

Note that the above collapses three normative statements into one.
Related Actions Items:
No related actions
Related emails:
  1. Agenda for the 2010-01-12 conference call (from eric@tibco.com on 2010-01-11)
  2. Re: Agenda for the 2009-12-15 conference call (from eric@tibco.com on 2009-12-15)
  3. RE: Agenda for the 2009-12-15 conference call (from Derek.Rokicki@softwareag.com on 2009-12-15)
  4. Re: Agenda for the 2009-11-03 conference call (from phil_adams@us.ibm.com on 2009-12-14)
  5. Agenda for the 2009-12-15 conference call (from eric@tibco.com on 2009-12-14)
  6. Re: Agenda for the 2009-11-03 conference call (from eric@tibco.com on 2009-12-14)
  7. Agenda for the 2009-11-03 conference call (from eric@tibco.com on 2009-12-14)
  8. Re: Agenda for 2009-12-08 conference call (from alewis@tibco.com on 2009-12-08)
  9. Re: Agenda for 2009-12-08 conference call (from M8PHILLI@uk.ibm.com on 2009-12-08)
  10. Issue-19: update available (from phil_adams@us.ibm.com on 2009-12-07)
  11. Agenda for 2009-12-08 conference call (from phil_adams@us.ibm.com on 2009-12-07)
  12. Agenda for the 2009-12-01 conference call (from peaston@progress.com on 2009-11-30)
  13. Agenda for the 2009-11-17 conference call (from M8PHILLI@uk.ibm.com on 2009-11-16)
  14. Re: Agenda for the 2009-11-03 conference call (from eric@tibco.com on 2009-11-03)
  15. RE: Agenda for the 2009-11-03 conference call (from Derek.Rokicki@softwareag.com on 2009-11-03)
  16. Agenda for the 2009-11-03 conference call (from eric@tibco.com on 2009-11-02)
  17. RE: Agenda for 2009-10-27 conference call (from peaston@progress.com on 2009-10-27)
  18. Action-119 - Raised two new issues, action complete. (from eric@tibco.com on 2009-10-26)
  19. Agenda for 2009-10-27 conference call (from eric@tibco.com on 2009-10-26)
  20. ISSUE-19 (3001, 3002, 3003 overlap): Normative statements 3001, 3002, 3003 overlap and/or are redundant (from sysbot+tracker@w3.org on 2009-10-26)

Related notes:

Opened as per: http://www.w3.org/2009/10/27-soap-jms-minutes.html

Eric Johnson, 2 Nov 2009, 21:32:34

Accepted application of issue as per minutes of http://www.w3.org/2010/01/12-soap-jms-minutes.html

Eric Johnson, 19 Jan 2010, 01:52:54

Completing record: Issue resolution approved on
http://www.w3.org/2009/12/01-soap-jms-minutes.html

Eric Johnson, 11 Oct 2010, 23:39:51

Display change log ATOM feed


Chair, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 19.html,v 1.1 2013-09-16 14:06:34 carine Exp $