OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-bindings message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [sca-bindings] [BINDINGS-154]: Clarify optionality of MAY statementsin JMS binding spec


Logged as: http://www.osoa.org/jira/browse/BINDINGS-154

-Eric.

On 4/11/11 2:58 AM, Simon Holdsworth wrote:
OF85B3D059.A71B4A6F-ON8025786F.00350DA7-8025786F.0036BE95@uk.ibm.com" type="cite">Target:  sca-jmsbinding-1.1-csd05.pdf

Description:

The JMS binding specification has several normative statements using the MAY keyword.  Clarification is needed as to whether these refer to needed optional features of the specification.

Proposal:

There are 4 normative statements in the JMS binding specification which include MAY keywords: BJM30006, BJM30028, BJM40001, BJM40007

Summary of the proposal:  replace all these statements with non-normative text.

BJM30006:

SCA runtimes MAY allow other values of the @correlationScheme attribute to indicate other correlation schemes [BJM30006].

Change the text to: "SCA runtimes supporting other correlation schemes can allow additional values for the @correlationScheme attribute."

BJM30028:

SCA runtimes MAY place restrictions on the properties of the resource adapter Java bean that can be set using the resourceAdapter element [BJM30028].

Change the text to: "The resource adapter and SCA runtime together define the set of valid properties for configuring the resource adapter via the JMS binding."

BJM40001:

The SCA runtime MUST support the default JMS wire format and operation selector behavior, and MAY provide additional means to override it [BJM40001].

Remove the MAY clause from the statement. Add the following sentence at the end of the paragraph currently ending on line 368:  "The operationSelector and wireFormat elements allow a binding element to specify behaviour defined by the binding specification or custom behaviour provided by an SCA runtime."

BJM40007:

When using the default wire format an SCA runtime MAY provide additional configuration to allow selection between JMS text or bytes messages to be sent [BJM40007].

Change the text to: "The default wire format allows a choice of text or bytes format when sending messages; an SCA runtime can restrict this to one or other via additional configuration.

Given that some of these statements are now non-normative, additional changes to the documents are required:

1) Remove  BJM30006, BJM30028, BJM40007 from the table at the end of the JMS binding spec.

2) Remove test assertions BJM-TA-30006, BJM-TA-30028, BJM-TA-40007 from the JMS binding testcase specification, including entries in the tables in Appendix B and C

3) Update test case description for BJM-TA-40001 to remove the MAY clause, and remove the "D" from the testcase name (editorial).

---------------------------------


Simon Holdsworth






Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU








[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]