PM68798: The JAX-RPC web services option 'Do not overwrite loadable Java Classes' option is not accurately documented

Rational Application Developer for WebSphere Software 8.5.1
Rational Application Developer Standard Edition, Version 8.0.4.2

APAR status

• Closed as program error.

Error description

• Abstract:
  
  The JAX-RPC option 'Do not overwrite loadable Java Classes'
  option is not correctly documented in the Help system.  It
  states it only applies to the web services client wizard.
  
  Problem:
  
  The 'Do not overwrite loadable Java Classes' option, a web
  services workspace preference, is documented as being for a
  JAX-RPC Web Services (WS) client in the following help item:
  
  http://publib.boulder.ibm.com/infocenter/radhelp/v8/topic/com.ib
  m.webservice.doc/topics/core/rwebspherepref.html
  
  '...
  *  Do not overwrite loadable Java classes: when selected, the
  Web service client wizard will not write any Java classes to the
  target project that both:
  -    do not already exist in the project
  -    do exist in a project, module or JAR file that will be
  loadable from the target project when the application is running
  on the server.
  
  If this option is not selected, the wizards may write Java
  classes to the target project that will mask preexisting classes
  with the same name in other projects, modules or JAR files. This
  can result in runtime environment and compilation errors. Note
  that this setting does not apply to the Web services Java or EJB
  skeleton wizards, only the client wizard.
  ...'
  
  The concern is with the first and last sentence referring to the
  the Web service client wizard.
  The option is only meant for the JAX-RPC 'bottom up' web
  services wizard. As of v7.0 and above, the option is only
  necessary for J2EE 1.3 JAX-RPC applications utilizing complex
  user-defined types now. The option is listed under WSDL2Java
  since WSD2Java is also invoked when doing Java2WSDL.  It is only
  in 'bottom up' JAX-RPC web services wizard that it we will not
  overwrite development time artifacts.
  
  The 'Note:...' [box] under this option item refers to additional
  information regarding botton-up, but the overall option
  description is incorrect in stating it applies to the Web
  service client wizard.
  
  Local fix:
  
  This option, going back to v6.0/v7.0, is explained in detail in
  developerWorks article:
  
  - IBM Rational Application Developer Web Services Tooling Tips
  and Tricks
  Part 1: Be aware of the preferences page
  http://www.ibm.com/developerworks/rational/library/07/0508_cui/i
  ndex.html
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The documentation for the "Do not overwrite loadable Java
  Classes" JAX-RPC option is incomplete.
  

Problem conclusion

• Clarified documentation for the "Do not overwrite loadable
  Java Classes" JAX-RPC preference.
  
  The fix for this APAR is included in Rational Application
  Developer v8.0.4.2 and v8.5.1.
  

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

  RATL APP DEV WI

• Fixed component ID

  5724J1901

Applicable component levels

• R804 PSN

     UP