Migrating APIs and specifications

Migrating application programming interfaces (APIs) and specifications involves moving to the current Java component level as well as to other technologies that WebSphere Application Server Version 6.0.x supports.

Migrating APIs and specifications also includes moving to the most contemporary open specification levels. If your existing applications currently support different specification levels than those supported by this product version, you should review your applications for required changes to comply with the new specifications.

[z/OS] The following table summarizes potential migration areas.
Functional area Support in Version 4.0.1 Must migrate from Version 4.0.1? Must migrate from Version 5.x? Details
Enterprise beans EJB 1.1 No No Full support for EJB 1.1 is provided.
Java 2 Connectors Java 2 Connectors Yes No The preliminary Java 2 Connector support in Version 4.0 is completed in Version 6.0. Some changes might be necessary to take full advantage of this support. .
Java Database Connectivity (JDBC) API JDBC API Not applicable No Many applications can run unchanged in Version 6.0.x although some changes might be required or recommended.
JavaServer Pages (JSP) files JSP 1.0 Specification No No JSP 1.0 APIs are a pure subset of JSP 1.2.
JSP 1.1 Specification No No JSP 1.1 APIs are a pure subset of JSP 1.2.
Security IBM security Yes No Changes might be required due to J2EE security.
Servlets Servlet 2.1 Specification and IBM extensions Yes No Many Servlet 2.1 applications can run unchanged in Version 6.0.x although changes might be required or recommended.
Servlets Servlet 2.2 Specification No No Servlet 2.2 APIs are a pure subset of Servlet 2.3.
Sessions IBM sessions Yes No Many applications can run unchanged in Version 6.0.x although changes might be required or recommended.
Web services Apache SOAP 2.2 Yes No Apache SOAP Web services support provided in WebSphere Application Server z/OS Version 4.0.1 was deprecated in Version 5.0 and is not supported in Version 6.0.x.
XML parser XML 2.0.x supported Not applicable No Changes to move to the supported API XML4J Version 4.0.6 level are required.
XML parser XML4J Version 3.1 Yes No Recompilation is required to convert to XML4J Version 4.0.6.
Administrative console Administrative console Yes No Use the JMX support provided by wsadmin.
[AIX HP-UX Linux Solaris Windows] The following table summarizes potential migration areas.
Functional area Support in Version 4.0.x Must migrate from Version 4.0.x? Must migrate from Version 5.x? Details
Enterprise beans EJB 1.0 Not applicable Not applicable Many EJB 1.0 applications can run unchanged in Version 6.0.x although some changes might be required or recommended. .
EJB 1.1 No No Full support for EJB 1.1 is provided.
Java 2 Connectors Java 2 Connectors Yes No The preliminary Java 2 Connector support in Version 4.0 is completed in Version 6.0. Some changes might be necessary to take full advantage of this support.
Java Database Connectivity (JDBC) API JDBC API Not applicable No Many applications can run unchanged in Version 6.0.x although some changes might be required or recommended.
JavaServer Pages (JSP) files JSP 1.0 Specification No No JSP 1.0 APIs are a pure subset of JSP 1.2.
JSP 1.1 Specification No No JSP 1.1 APIs are a pure subset of JSP 1.2.
Security IBM security Yes No Changes might be required due to J2EE security.
Servlets Servlet 2.1 Specification and IBM extensions Yes No Many Servlet 2.1 applications can run unchanged in Version 6.0.x although changes might be required or recommended.
Servlets Servlet 2.2 Specification No No Servlet 2.2 APIs are a pure subset of Servlet 2.3.
Sessions IBM sessions Yes No Many applications can run unchanged in Version 6.0.x although changes might be required or recommended.
Transactions IBM transactions No No A change in the import statement. Also, one datasource connection cannot be used across multiple user transactions.
Web services Apache (SOAP) 2.2 Yes No Many applications can run unchanged although changes to use new support are recommended.
XML parser XML 2.0.x supported Not applicable Not applicable Changes to move to the supported API XML4J Version 4.0.6 level are required. See XML parser for Java code.
XML parser XML4J Version 3.1 Yes Not applicable Recompilation is required to convert to XML4J Version 4.0.6.
XML parser XML4J Version 4.0.6 Not applicable Yes Recompilation is required to convert to XML4J 4.2.2.
XML configuration tool XMLConfig Yes No Use the JMX support provided by wsadmin.
WebSphere Control Program WSCP Yes No Use the JMX support provided by wsadmin.
Notes on the use of JDK 1.4:
  • WebSphere Application Server began using JDK 1.4 in Version 5.1.
  • In general, existing Version 5.0.x applications are expected to run without change. However, JDK 1.4.1 has added interfaces to the Throwable class that might conflict with similar method calls that were provided by previous WebSphere Application Server releases. Applications using these interfaces might need to be changed.
  • Application binaries that were developed using JDK 1.3 are highly compatible and usually do not require modifications to run. However, recompilation of the JDK 1.3 applications at the JDK 1.4 level might necessitate modifications of the source code to conform to incompatible API changes present in JDK 1.4. As part of your migration planning, you should review the JDK compatibility restrictions that are documented by Sun Microsystems.
  • A mixed cell containing Version 5.0.x and Version 6.0.x nodes requires that all application binaries remain at the JDK 1.3 level. Although you can successfully migrate Version 5.0.x applications to Version 6.0.1, this is only meant to be a temporary state as you transition to Version 6.0.x. After you begin migration to Version 6.0.x, you should plan to complete the migration of the entire cell, update your tooling to Version 6.0.x, and update your applications to conform to JDK 1.4 requirements. This should be done prior to any further application changes. After you have completely migrated your cell to Version 6.0.x, you should upgrade your application binaries to the JDK 1.4 level the next time you make application modifications that require recompiling. This might require source code changes to your application to conform to the JDK 1.4 API changes as documented by Sun Microsystems.



Related tasks
Migrating and coexisting
Reference topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 9:31:45 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-mp&topic=rins_migtable
File name: rins_migtable.html