Proposed resolution to issue BINDINGS-31

[Simon Holdsworth <simon_holdsworth@uk.ibm.com>]

Proposed resolution to issue BINDINGS-31:
What is a "plain name" for a connection factories or activation
specs, and how is one distinguished from a JNDI name? 

Applies to the JMS binding specification
cd01:

rename "name" attribute to
"jndiName".

Describe the jndiName attribute (in
this example for a Destination) as follows:

• binding.jms/destination/@jndiName – the JNDI name of the JMS Destination that the binding uses to send or receive messages.  The behaviour of this attribute is determined by the value of the @create attribute as follows:
  • If the @create attribute value is "always" then the @jndiName attribute is optional; if the destination cannot be created at the specified location then the SCA runtime MUST treat this as an error.  If the @jndiName attribute is omitted this specification places no restriction on the JNDI location of the created resource.
  • If the @create attribute value is "ifnotexist" then the @jndiName attribute is mandatory and specifies the location of the possibly existing destination; if the destination does not exist at this location, but cannot be created there then the SCA runtime MUST treat this as an error.  If the jndiName refers to a resource other than a JMS Destination of the specified type then the SCA runtime MUST treat this as an error.
  • If the @create attribute value is "never" then the @jndiName attribute is mandatory and specifies the location of the existing destination; If the destination is not present at the location, or the location refers to a resource other than a JMS Destination of the specified type then the SCA runtime MUST treat this as an error.
  
  The "plain name" referred to in the current spec is really there to be an attribute of the created resource.  I think it makes more sense then for that to be amongst the properties that are children of the element, and not a standard attribute.
  
  Remove the sentences that say "This can either be a JNDI name or a plain connection factory name.".  as they are currently describing elements, not the name attribute of those elements and so are just incorrect.
  
  Update the examples to rename the "name" attribute to "jndiName", and/or move to inside the resource element for creation examples as appropriate.
  
  Update the XML schema to rename "name" to "jndiName", and make the value type "anyURI".
  
  Simon Holdsworth
  STSM, SCA Bindings Architect; Master Inventor; OASIS SCA Bindings TC Chair
  MP 211, IBM UK Labs, Hursley Park, Winchester SO21 2JN, UK
  Tel +44-1962-815059 (Internal 245059) Fax +44-1962-816898
  Internet - Simon_Holdsworth@uk.ibm.com
  
  
  

  ---

  
  
  

  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