PM57968: Step 8 of the 'Changing a JPA 1.0 project to JPA 2.0' documentation is missing important details

Rational Application Developer for WebSphere Software 8.5
Rational Software Architect Interim Fix 1 for 8.0.4.2
Rational Software Architect for WebSphere Software Interim Fix 1 for 8.0.4.2

APAR status

• Closed as program error.

Error description

• Abstract:
  
  The documentation for 'Changing a JPA 1.0 project to JPA 2.0' is
  missing a necessary details in step 8 of the conversion steps
  involving the 'Upgrade document version' function.
  
  Problem:
  
  On the following documentation page:
  
  Changing a JPA 1.0 project to JPA 2.0
  http://publib.boulder.ibm.com/infocenter/radhelp/v8/topic/com.ib
  m.jpa.doc/topics/t_convert_jpa_version.html
  
  Step 8 states:
  
  'In the Enterprise Explorer view or another similar view, locate
  the persistence.xml file. Right-click the file and click Upgrade
  document version. The persistence.xml file is upgraded to
  version 2.0. Confirm the upgrade by opening the file in the
  Persistence XML editor and check that the version is 2.0.'
  
  and is not completely accurate.  It should state:
  
  'In the Enterprise Explorer view or another similar view for the
  JPA project:
  
  (a) Under the fully expanded '?-? JPA Content' icon:
  
  Right-click on the icon that is the logical representation of
  persistence.xml
  (and similarly for any orm.xml) and click 'Upgrade document
  version'
  
  or
  
  (b) In the src/META-INF or similar relevant source folder:
  
  Right click on the persistence.xml file (and similarly for any
  orm.xml) and click 'Upgrade document version'
  
  Local fix:
  
  Follow the correction provided above.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The topic was missing details on updating the version of
  mapping files.
  

Problem conclusion

• The topic was updated to include details on updating mapping
  files. The fix for this APAR is included in Rational
  Application Developer v8.0.4.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