IBM J2EE Connector Tools Feature Version 6.0.1.5 - Readme

For IBM Rational Application Developer 6.0.1, 6.0.1.1 or 6.0.1.2 and IBM Rational Software Architect 6.0.1, 6.0.1.1, or 6.0.1.2

© Copyright International Business Machines Corporation 2000, 2007. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

1.0 About this release
   1.1 Product fix history
     1.1.1 Deadlock fix
2.0 Installation information
   2.1 Hardware requirements
   2.2 Software requirements
   2.2.1 WebSphere Application Server
   2.2.2 Resource adapters
   2.2.3 CICS Transaction Gateway
3.0 Known limitations, problems, and workarounds
4.0 IBM Rational Software Supportt
5.0 Notices and trademarks

1.0 About this release

The J2EE Connector (J2C) Architecture tools allow you to create J2EE applications that integrate and extend operations and data on existing Enterprise Information Systems (EIS).

This release does not contain any updates to neither IMS nor CICS® resource adapters included in IBM® Rational® Application Developer and IBM Rational Software Architect. After applying the update:

To view the latest version of this file, see the readme file at: www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/html/J2C6015/readme_6015.html

1.1 Product fix history

The following fixes are included in this release of the J2EE Connector Tools Feature:

1.1.1 Deadlock fix

There is a fix provided to prevent a deadlock situation when a huge workspace is used.

For the fixes to the resource adapters, see the readme file for the version 6014 release at: http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/html/J2C6014/readme_6014.html

2.0 Installation information

For information about installing the J2EE Connector Tools feature, see the installation instructions at: www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/install_instruction/J2C6015/install.html

2.1 Hardware requirements

Refer to the installation instructions for the hardware requirements for installing the J2EE Connector Tools feature.

2.2 Software requirements

You must have one of the following products installed before you can install this feature:

If you develop an application using the J2C tools and run it on WebSphere® Application Server Version 5, ensure that you have the required maintenance applied to WebSphere Application Server Version 5. See Section 2.2.1 WebSphere Application Server for details.

Refer to the installation instructions for more details on software and specifications that are supported by the J2EE Connector Tools feature.

For details on software and specifications that are supported by a specific tool in Rational Application Developer or Rational Software Architect, refer to the online help.

2.2.1 WebSphere Application Server

WebSphere Application Server V5.0 and WebSphere Application Server V5.1 support J2C 1.0. The WebSphere Application Server service levels required to use the J2EE Connector Tools are listed in the table below.

The back-level test environments available with Rational Application Developer V6.0 or Rational Software Architect V6.0 require the service listed under the WebSphere Application Server Distributed Service Level Required column in the table.

WebSphere Application Server cumulative fixes, for example WebSphere Application Server 5.0.2.8, are available from the WebSphere Application Server support site: www.ibm.com/software/webservers/appserv/was/support.

The Integration Edition RunTime Fixes for 5.0 and 5.1 are available from www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&dc=D410&dc=D420&uid=swg24004796&loc=en_US&cs=utf-8&lang=en.

WebSphere Application Server for z/OS® PTFs are available from the WebSphere Application Server for z/OS support site: www.ibm.com/software/webservers/appserv/zos_os390/support/

WebSphere Application Server WebSphere Application Server Distributed Service Level Required WebSphere Application Server for z/OS Service Level Required
5.0.x
  • Cumulative Fix 5.0.2.8
  • Integration Edition RunTime Fixes for 5.0
W502023 (PTF UK00329)
5.1.x
Integration Edition RunTime Fixes for 5.1
W510205 (PTF UK0028)

WebSphere Application Server V6 supports J2C 1.5 applications.

2.2.2 Resource adapters

The following resource adapters are supported in the J2C tools:

2.2.3 CICS Transaction Gateway

The supported software for CICS Transaction Gateway (CICS TG) is located in www-1.ibm.com/support/docview.wss?uid=swg21239203

3.0 Known limitations, problems, and workarounds

3.1 The limitations found in the IBM J2EE Connector Tools Feature Version 6.0.1 also apply to this release.

3.2 In many cases updates to the IMS resource adapter may require corequisite APARs for IMS Connect and IMS. For information about corequisite APARs, see the following Web site: www.ibm.com/ims.

3.3 You cannot have multiple versions of a resource adapter in any version of WebSphere Application Server. The problem is that there is only a single classpath/loader in WebSphere Application Server, so it will actually mix classes up from the 2 levels and you will get undefined behavior.

3.4 PMR 03591:Annotation Builder Performance Issue

The annotation builder will automatically rebuild all your data binding classes if you make changes to the annotation tag.

In some cases, when the data binding classes contain many get/set methods, a rebuild can take a very long time. CPU usage reaches 100 percent and the tool or system might appear to be locked up. However, it is not locked up and it will be available after the rebuild is completed. This rebuild process can take 20 minutes, depending on how many methods are in your data binding classes.

Workaround:

Try one of the following methods:

3.5 Incomplete method body in migrated artifacts when you use the command line WSADSIE to RAD J2C migration tool.

If you use the command line tool J2CMigration.bat or J2CMigration.sh to migrate your WSDL files to J2C Java Beans or Data Binding, then you might find that some of the method body is empty even though the doclets tags are generated in the methods.

The writer has returned to the command line tool before the annotation builder has completed the code generation of the method body based on the doclets tags.

Workaround:

Open the migrated workspace in the workbench. Then, the annotation builder will rebuild and all of the method bodies will be generated and compiled.

4.0 IBM Rational Software Support

IBM Rational Software Support provides you with technical assistance.

When you contact customer support, the support representative will require the versions of the installed products or interim features on your system.

To determine the versions:

  1. Start IBM Rational Product Updater and complete one of the following steps:
  2. Click the Installed Products tab.

The product home page for Rational Application Developer is www.ibm.com/software/awdtools/developer/application/. For FAQs, lists of known problems and fixes, and other support information, visit the support page at www.ibm.com/software/awdtools/developer/application/support/.

The product home page for Rational Software Architect is www.ibm.com/software/awdtools/architect?swarchitect/. For FAQs, lists of known problems and fixes, and other support information, visit the support page at www.ibm.com/software/awdtools/architect/swarchitect/support/.

Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

5.0 Notices and trademarks

© Copyright IBM Corporation 2000, 2007. All Rights Reserved.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this documentation. The furnishing of this documentation does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product or service names, may be trademarks or service marks of others.