To view the latest version of this file, see the readme at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/html/J2C6014/readme_6014.html
This file is available in the following national languages:
Brazilian Portuguese | Chinese - Simplified | Chinese - Traditional |
French | German | Italian |
Japanese | Korean | Spanish |
1.0
About this release
1.1
Product fix history
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
Customer support
5.0
Notices and trademarks
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 contains fixes and applies maintenance to both IMS™ and CICS® resource adapters included in Rational® Application Developer and Rational Software Architect. After applying the update:
The following fixes are included in this release of the J2EE Connector Tools Feature:
IMS Connector for Java Versions 9.1.0.1.3b and 9.1.0.2.2b are included, for development purposes, in the J2EE Connector Tools Feature Version 6.0.1.4 for IBM Rational Application Developer Version 6.0.1.2. 6.0.1.1 or 6.0.1. These are maintenance only (no new function) releases and include the following updates:
If an application tries to override the Commit Mode value from 0 to 1 using the same IMSInteractionSpec object instance, the interaction will be executed using Sync level Confirm instead of Sync level None. With this fix, IMS Connector for Java will ensure that it uses Sync level None for executing the IMS transaction when Commit Mode 1 is used.
APARs addressed in these versions :- On distributed platforms, this level includes PTFs for APARs:
And on z/OS, this level includes PTFs for APARs
Migrated code for managed connection exposed Connection properties is not correct.
If you exposed the password and userid in connection properties, the migrated code will not pass the values when you execute the code resulting in password and userid is invalid.
IGYPS2121-S ERRORS WHEN ENTERPRISE WEB SERVICES GENERATED -CONVERTER DRIVER PROGRAM IS COMPILED
Webphere Developer for zSeries 6.0.1.4 - When using Enable Enterprise Web Services wizard, with compiled XML conversion,the generated converter program is generated without the input and output datastructures which causes compile errors. The following are some examples of these errors: 916 IGYPS2121-S "PROGRAM-INPUTS" was not defined as a data-name. The statement was discarded.1149 IGYPS2121-S "INPUT-CICS-TRAN OF PROGRAM-INPUTS" was not defined as a data-name. The statement was discarded. 2653 IGYPS2121-S "PROGRAM-OUTPUTS" was not defined as a data-name. The statement was discarded. 2697 IGYPS2121-S "R-RC OF STATUS-AREA OF PROGRAM-OUTPUTS" was not defined as a data-name. The statement was discarded.The COBOL program that is used as input to the Enable Enterprise Web Services wizard contains the following COPY statements. EJECT COPY EVC1000I. EJECT COPY EVC1000O. The data structures defined in the these copybooks are missing from the generated converter driver program. Local Fix: The following are the options to workaround this: - Put both the copybooks into one file and import that file - Declare at least the 01 level in the program and copy in its contents - Add the copy statements for the input/output data structures to the generated converter driver program.
For information about installing the J2EE Connector Tools feature, refer to www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/install_instruction/J2C6014/install.html
Refer to the installation instructions for the hardware requirements for installing the J2EE Connector Tools feature.
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. Refer to 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.
WebSphere V5.0 and WebSphere 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 or Rational Software Architect V6.0 require the service listed under WAS Distributed Service Level Required column in the table. WebSphere Application Server cumulative fixes, for example WAS 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 | WAS Distributed Service Level Required | WAS for z/OS Service Level Required |
---|---|---|
5.0.x |
|
W502023 (PTF UK00329) |
5.1.x |
Integration Edition RunTime Fixes for
5.1 |
W510205 (PTF
UK0028) |
WebSphere V6 supports J2C 1.5 applications.
The following resource adapters are supported in the J2C tools:
The limitations found in the IBM ® J2EE Connector Tools Feature Version 6.0.1 also apply to this release.
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.
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 behaviour.
PMR 03591:Annotation Builder Performance Issue
Problem descriptionThe annotation builder will automatically rebuild all your data binding classes if you make changes to the annotation tag.
There are cases when the data binding classes contains many get/set methods, any rebuild will take a very long time. The CPU will go up 100% and
The user may think that the tool/ system is hanging. Actually, it is not hanging and it will come back after the rebuild is completed . Sometimes it may take 20 minutes depnending on how many methods are in your data binding classes.
Work Around1.Be Patient
2.Try to reduce the number of methods in one data binding if possible.
Incomplete method body in migrated artifacts when you use the command line WSADSIE to RAD J2C migration tool.
Problem descriptionIf you use the command line J2CMigration.bat/J2CMigration.sh to migrate your WSDLs to J2C Java Beans or Data Binding. You will find that some of the method body is empty eventhough 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.
Work Around
You will need to bring up the migrated workspace using the workbench, Then the annotation builder will rebuild and all the method bodies will be generated and compiled.
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/.
© Copyright IBM Corporation 2000, 2006. All Rights Reserved.
The
XDoclet Documentation included in this IBM product is used with permission and
is covered under the following copyright attribution statement: Copyright ©
2000-2006, XDoclet Team. All rights reserved.
Portions based on
Design Patterns: Elements of Reusable Object-Oriented Software, by
Erich Gamma, Richard Helm, Ralph Johnson and John Vlissides, Copyright © 1995 by
Addison-Wesley Publishing Company, Inc. 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.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
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.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurements may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available
sources. IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBM's future direction or intent are subject to
change or withdrawal without notice, and represent goals and objectives
only.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples may
include the names of individuals, companies, brands, and products. All of these
names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2000, 2006. All rights reserved.
If you are viewing a soft copy of this information, the photographs and color
illustrations may not appear.
Programming interface information is intended to help you create application software using this program.
General-use programming interfaces allow you to write application software that obtain the services of this program's tools.
However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification, and tuning information is provided to help you debug your application software.
Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.
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.
Windows® and Windows NT® are trademarks of Microsoft® Corporation in the United States, other countries, or both.
Intel® and Pentium® are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States, other countries, or both.
UNIX® is a registered trademark of The Open Group in the United States and other countries.
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.