© 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.
This file is available in the following national languages:
| Brazilian Portuguese |
Czech |
French |
German |
| Hungarian |
Italian |
Japanese |
Korean |
| Polish |
Russian |
Simplified Chinese |
Spanish |
Traditional Chinese |
The latest version of this document is available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rbd/70/docs/readme/readme.html.
IBM® Rational® Business Developer is designed to meet the needs of business oriented developers, providing a comprehensive development environment for the IBM Rational Enterprise Generation Language (EGL). EGL is a simplified high level programming language that promotes the rapid development of applications by helping developers focus on business problems instead of complex software technologies.
IBM Rational Business Developer provides tools to define, test and debug EGL applications and services, along with a generation engine that transforms the EGL source into Java™ or COBOL code optimized for deployment across various supported platforms
This section describes enhancements to the Rational Enterprise Generation Language (EGL) function contained in the Rational Business Developer product.
importstatements.
For information about installing Rational Business Developer Extension, Version 7.0, including hardware and software requirements, see the Rational Business Developer Extension Installation Guide (install.html) which can be viewed from the installation launchpad. This file is also stored in the documentation directory on the first product CD.
The latest version of the Rational Business Developer Extension Installation Guide is available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rbd/70/docs/install_instruction/install.html
Important: Ensure that you enable your license after you install the product.
For information about hardware requirements for installing Rational Business Developer Extension, see the Installation Guide.
For information about software requirements for installing Rational Business Developer Extension, see the Installation Guide.
Important: If you purchased IBM Rational Business Developer (Rational Business Developer Extension and a limited licensed copy of Rational Application Developer), then when you install Rational Application Developer you should clear all Rational Application Developer features selected by default and install only the following features:
Any additional features of Rational Application Developer that you install will expire at the end of the 60 day trial period; this might interfere with your use of the licensed features. For example, when you run the product you will get dialog windows telling you that features have expired. To stop the dialog windows, you must uninstall the expired features with the Modify Packages wizard in Installation Manager.
In order to compile EGL COBOL generated applications on iSeries™, the iSeries computer must have APAR SE26597 installed (for version 5.3 use PTF SI23518; for version 5.4 use PTF SI23523) on the COBOL compiler.
In some cases the performance and layout of I4GL reports is not as expected when this type of project is migrated to use EGL Console User Interface.
If an application being converted from Informix® 4GL to EGL contains GOTO statements, then when you try to generate it you will get an error message similar to this:
IWN.VAL.4282.e 12/0 The GOTO statement is not supported for target system WIN.
Listed here are the unsupported parameter types for the following platforms:
- WebSphere®/J2EE 1.3: Date, Time, and interval.
- Tomcat/AXIS: Multidimensional Arrays, Date, Time, and Interval.
- CICS: Multidimensional Arrays
Hex(2) arrays inside structured records are not supported in iSeriesc Web service clients.
A runtime exception will occur when an EGL Web service client is deployed to WebSphere Application Server unless the EAR deployment descriptor is manually modified. By default, the WAR file for the Web project in the EAR has its classloader mode set to PARENT_FIRST. EGL Web Service clients must run under classloader mode PARENT_LAST.
To change the classloader mode:
- Open the EAR file's deployment descriptor.
- Select the "Deployment" tab, and then select the "Application" group.
- Click on the EAR in the tree and make sure that "WAR classloader policy" is set to "MODULE".
- Click on the WAR files that container EGL Web Service clients, and then change the "classloader mode" to "PARENT_LAST".
Also we have found that our deployed Web services to WebSphere Application Server require a classloader mode of PARENT_FIRST. This means that at this time, we do not support Web Service clients and Web Services to be in the same Web project.
Java and ISeriesc Web service and Web service clients automatically convert EGL time and Timestamp data types to and from GMT to the SOAP messages that are sent to and received from Web services. CICS Web service and Web service clients do not support conversion to and from GMT. This causes a problem when EGL Web services and EGL Web service clients are running on different platforms.
The work around is to send Time and Timestamp data as String data and convert them back to Time and Timestamp data in the service logic.
Rational Business Developer Extension, Version 7.0 is not currently compatible with the version 7.0.0.2 release of Rational Application Developer or Rational Software Architect. If you already installed version 7.0.0.2 of Rational Application Developer or Rational Software Architect, then you must revert to an earlier version before you install Rational Business Developer Extension, Version 7.0.
IBM Rational Software Support provides you with technical assistance.
For contact information and guidelines or reference materials that you will need when you require support, read the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/handbook.html.
For FAQs, lists of known problems and fixes, and other support information, visit the product support page for Rational Business Developer Extension at www-306.ibm.com/software/awdtools/developer/business/support/index.html.
For product news, events, and other information, visit the product home page for Rational Business Developer Extension at www-306.ibm.com/software/awdtools/developer/business/.
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:
- What software versions were you running when the problem occurred?
- Do you have logs, traces, or messages that are related to the problem?
- Can you reproduce the problem? If so, what steps do you take to reproduce it?
- Is there a workaround for the problem? If so, be prepared to describe the workaround.
© Copyright IBM Corporation 2000, 2007. All rights reserved.
Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
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 document 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 document. The furnishing of this document does not grant 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 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.
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.
Trademarks and service marks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
- CICS
- ClearCase
- IBM
- iSeries
- Informix
- Rational
- WebSphere
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Other company, product or service names, may be trademarks or service marks of others.