REOPEN ISSUE: Resolution for JAVA-125 was incomplete

[Simon Nash <oasis@cjnash.com>]

TARGET: SCA-J Common Annotations and APIs

DESCRIPTION: Resolution for JAVA-125 was incomplete

As discussed in
  http://www.oasis-open.org/apps/org/workgroup/sca-j/email/archives/200906/msg00098.html
the revised resolution for JAVA-125 did not update the description of
the @remotable attribute of <interface.java> in chapter 3 of JavaCAA.

This currently reads as follows:

  – indicates whether or not the interface is remotable.  A value of
  “true” means the interface is remotable and a value of “false” means
  it is not.  This attribute does not have a default value.  If it is
  not specified then the remotability is determined by the presence or
  absence of the @Remotable annotation.  The @remotable attribute
  applies to both the interface and any optional callbackInterface.
  The @remotable attribute is intended as an alternative to using the
  @Remotable annotation.  The value of the @remotable attribute on the
  <interface.java/> element does not override the presence of a
  @Remotable annotation on the interface class and so if the interface
  class contains a @Remotable annotation and the @remotable attribute
  has a value of "false", then the SCA Runtime MUST raise an error and
  MUST NOT run the component concerned. [JCA30005]

When this paragraph was written, it was correct based on the valid
usage of the @Remotable annotation at that time.  The revised resolution
to JAVA-125 has changed the usage of @Remotable to allow it to appear
in additional places.  It is therefore necessary to further qualify
this description to preserve its original meaning of using the
@Remotable annotation on the interface class.

PROPOSAL:

Change the above paragraph by inserting the words "on the interface
class" at the end of the fourth sentence and the end of the sixth
sentence.  The resulting text is:

  – indicates whether or not the interface is remotable.  A value of
  “true” means the interface is remotable and a value of “false” means
  it is not.  This attribute does not have a default value.  If it is
  not specified then the remotability is determined by the presence or
  absence of the @Remotable annotation on the interface class.  The
  @remotable attribute applies to both the interface and any optional
  callbackInterface.  The @remotable attribute is intended as an
  alternative to using the @Remotable annotation on the interface class.
  The value of the @remotable attribute on the <interface.java/> element
  does not override the presence of a @Remotable annotation on the
  interface class and so if the interface class contains a @Remotable
  annotation and the @remotable attribute has a value of "false", then
  the SCA Runtime MUST raise an error and MUST NOT run the component
  concerned. [JCA30005]