PI06184: REMOTEEXCEPTION SUBCLASSES ARE NOT ALLOWED AS EJB APPLICATION EX CEPTIONS

8.5.5.2: WebSphere Application Server V8.5.5 Fix Pack 2
8.5.5.3: WebSphere Application Server V8.5.5 Fix Pack 3
8.5.5.4: WebSphere Application Server V8.5.5 Fix Pack 4
8.5.5.5: WebSphere Application Server V8.5.5 Fix Pack 5
8.5.5.6: WebSphere Application Server V8.5.5 Fix Pack 6
8.5.5.7: WebSphere Application Server V8.5.5 Fix Pack 7
8.5.5.8: WebSphere Application Server V8.5.5 Fix Pack 8
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21

APAR status

• Closed as new function.

Error description

• CNTR5102E: The com.ibm.test.TestException application
  exception that is defined on the doTest method of the
  com.ibm.test.TestIntf interface must not be defined as a
  subclass of the java.rmi.RemoteException exception.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  IBM WebSphere Appplication Server users of  *
  *                  remote Enterprise Java Beans (EJBs)         *
  ****************************************************************
  * PROBLEM DESCRIPTION: RemoteException subclasses are not      *
  *                      allowed as EJB application exceptions   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The EJB specification states that application exceptions may
  not be a subclass of java.rmi.RemoteException, and including
  an exception on the throws clause of a method designates an
  exception as an application exception.  The EJB container
  validates declared application exceptions, issues a CNTR5102E
  message if any erroneous application exceptions are found, and
  it relies on this validation elsewhere to avoid exceptions
  from being misclassified.  However, some applications
  developed for other products need to be able to declare
  application exceptions that subclass java.rmi.RemoteException,
  and they cannot be easily changed.
  

Problem conclusion

• The EJB container has been changed to conditionally allow
  application exceptions to subclass java.rmi.RemoteException if
  a system property is specified.
  
  1. Open the administrative console.
  2. Select Servers -> Server Types -> WebSphere application
  servers.
  3. Select the server you want to configure.
  4. In the Server Infrastructure area, select Java and Process
  Management -> Process definition.
  5. In the Server Infrastructure area, select Process Definition.
  6. In the Additional Properties area, select Java
  Virtual Machine.
  7. In the Additional Properties area, select Custom Properties.
  8. Select the New box.
  9. In the Name entry field, type:
  com.ibm.websphere.ejbcontainer.declaredRemoteAreApplicationExcep
  tions
  10. In the Value entry field, type: true
  11. Select OK.
  12. Restart the server.
  
  Note, this property applies to EJB 3.0 local and remote
  business interfaces, but it does not apply component interfaces.
  
  The fix for this APAR is currently targeted for inclusion in
  fix pack 8.5.5.2.  Please refer to the Recommended Updates
  page for delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  WEBS APP SERV N

• Fixed component ID

  5724H8800

Applicable component levels

• R850 PSY

     UP