Updates, limitations, and known problems
This document contains prerequisite information for IBM(R) WebSphere(R) Development Studio Client for iSeries(TM) Advanced Edition, Version 6.0. In addition, it includes any limitations of the product and information not included in the documentation.
This product includes the following Eclipse-based components:
The product also includes the following components on a separate CD:
The announcement letter of WebSphere Development Client for iSeries Advanced Edition, Version 6.0 is available on the Web at http://www.ibm.com/common/ssi. See the announcement letter for the following types of information:
For more information, see the iSeries Development Family Web site at ibm.com/software/awdtools/iseries.
The latest English version of this document is available on the Web.
This file is also available in the following national languages:
| Brazilian Portuguese | Simplified Chinese | Traditional Chinese |
|---|---|---|
| German | Spanish | French |
| Italian | Japanese | Korean |
From the Web, you can get updated lists of prerequisite iSeries PTFs, other support information, and information about available services.
Key information is available in the following places:
Refer to the Installation Guide for the system requirements for installing WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0.
You can find information about any required iSeries server PTFs in two ways:
Here is a list of the contents of your package. Items listed as
optional are additional workstation products. Install them only if you
are doing development tasks that require them. You can install these
products now or later.
| Label | Description |
|---|---|
|
WebSphere Development Studio Client for iSeries Advanced Edition V6.0 Disk 1-7 or DVD WebSphere Development Studio Client for iSeries Product Installation Code
|
Integrated set of Windows-based development, testing, and deployment tools for iSeries RPG, COBOL, CL, DDS, Java, and Web development. On your workstation, insert Disk 1 or the DVD first. Depending on
installation options selected, you might not require all CDs. Follow
the prompts.
|
| Optional |
|
|
WebSphere Development Studio Client for iSeries Advanced Edition V6.0 Agent Controller for Windows(R)
|
Daemon that provides application data to remote testing tools such as the
Rational Developer products.
|
|
WebSphere Development Studio Client for iSeries Advanced Edition V6.0 Embedded Messaging Client and Server
|
Feature that combines a subset of IBM MQSeries(R) with Java code to
provide queuing, publication, and subscription support. Sometimes
referred to as the WebSphere JMS Provider.
|
|
WebSphere Development Studio Client for iSeries Advanced Edition V6.0 WebSphere Test Environment V5.x, Disk 1-2
|
Local instance of WebSphere Application Server V5.x. You can
use this environment to test applications, such as J2EE and WebFacing
applications, that will be deployed to an earlier version of WebSphere
Application Server.
|
|
WebSphere Development Studio Client for iSeries Advanced Edition V6.0 WebSphere Portal V5.0 Test Environment
|
Test environment for portal applications.
|
|
WebSphere Development Studio Client for iSeries V6.0 CoOperative Development Environment and VisualAge RPG
|
Set of classic Windows tools for iSeries development.
|
|
Host Access Transformation Services V6.0
|
Tool to transform screens of a server application into a Web application
that can be deployed to a Web server.
|
|
DB2(R) UDB Express Edition CPU Option V8.2 DB2 Universal Database(TM) Express Edition
|
Sophisticated database to store and query data.
|
|
WebSphere Application Server for Developers V6.0
|
Set of tools that provides support for Java servlets, Java Server Pages
(JSP), Java Message Service (JMS) and Enterprise JavaBean (EJB) and core Web
Services standards like XML, SOAP, WSDL, and WSIF for developing dynamic
e-business solutions.
|
|
Crystal Enterprise V10,
|
Tool for building and deploying secure, interactive reports and
distributing analysis across the enterprise.
|
|
WebSphere Portal for Multiplatform V5.1 Setup
Portal Install
|
Install code for Portal development.
|
|
WebSphere Portal for Multiplatform V5.1 Disk 2
Portal Server V5.1
|
Install code for Portal development.
|
|
WebSphere Portal for Multiplatform V5.1, Disk 3
LWWCM V2.1 and Personalization V5.1
|
Web-based, multi-user authoring environment tool used to create, control,
and publish company Web sites.
|
|
WebSphere Portal for Multiplatform V5.1, Disk 1-15
WebSphere Business Integration Server Foundation V5.1 Fix Pack 1, WebSphere Application Server V5.1 Fix Pack 1, Cumulative Fix for Windows
|
Tested collection of fixes to update the WebSphere Application
Server.
|
|
WebSphere Portal for Multiplatform V5.1, Disk 1-1, Disk 1-2
WebSphere Business Integration Server Foundation for Windows V5.1
|
Tool to develop and deploy composite applications within a service-oriented
architecture.
|
If you have a beta version of WebSphere Development Studio Client for iSeries, or any version of WebSphere Development Tools, please remove it before installing WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0.
In this release, the CoOperative Development Environment (CODE) and VisualAge RPG are shipped on a separate CD and are separately installable. There is no requirement to install the full WebSphere Development Studio Client product when using the classic tools only. Please refer to the CODE and VisualAge RPG Installation Guide. If you cannot access the Web site, look for file cinstall.htm in the root directory of the CODE and VisualAge RPG CD for details.
Since WebSphere Development Studio Client for iSeries Advanced Edition is built on IBM Rational Application Developer V6.0, the default is to install the product code in a folder called IBM\ Rational in your workstation Program Files directory. If you accepted the installation defaults, you can expand the local directory:
\Program Files\IBM\Rational\SDP\6.0
The Start menu contains a shortcut for the product in the IBM Rational folder. When you expand this folder, you can see the IBM WebSphere Development Studio Client for iSeries Advanced Edition V6.0 subfolder.. This contains the Installation Guide, Migration Guide, Readme file and the product shortcut.
To start, click Start->Programs->IBM Rational->IBM WebSphere Development Studio Client Advanced Edition for iSeries V6.0 -> WebSphere Development Studio Client Advanced Edition for iSeries.
Refer to the Migration Guide for information on migrating from WebSphere Development Studio Client Version 5.1 or 5.1.2. You can also find additional information in the form of technotes on the IBM Support Web site http://www.ibm.com/software/awdtools/wdt400/support.
In case you encounter performance problems, refer to the performance hints and tips for Rational Developer product components. Also visit the support page of this product for specific tips on the iSeries related tools.
Updates, limitations, and known problems about WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0, are documented in the form of technotes on the IBM Support Web site http://www.ibm.com/software/awdtools/wdt400/support.
As limitations and problems are discovered and resolved, the IBM Software Support team updates the knowledge base. By searching the knowledge base, you can quickly find workarounds or solutions to problems that you experience. The Technotes link in the Self Help section of the WebSphere Development Studio Client for iSeries Web site launches a customized query of the live Support knowledge base. To narrow your search, specify V6 as the search term. To create your own query, go to the Advanced search page on the IBM Software Support Web site.
Refer to the technotes for the WebFacing Tool for updates, limitations, and known problems.
Starting with Version 5.1.2, the index.html file has been replaced with index.jsp. Once placed in your project, the index.jsp is not updated by the WebFacing Tool. The changes to the html to add or remove program launch entries are done to a separate file, invocations.jsp, that is included by index.jsp. When a program invocation is added or removed, the invocations.jsp file is regenerated but index.jsp is not changed. If you wish to customize the appearance of your index.jsp file and not have it change when CL commands are added or removed, you can delete the inclusion of the invocations.jsp and copy the parts of invocations.jsp that you need into the index.jsp. Then you can customize index.jsp to suit your needs.
The default way to invoke a CL program in Version 5.1.2 is to use a form. If you have parameters, the form submission correctly handles the submission of them as well. To invoke your converted application from outside of the Web application, you can get the proper format of the form using the browser's View source option when the index.jsp page is displayed.
With imported projects that had a customized index.html page, we recommend that you do the customizations to the index.jsp page. The index.html page should still work with the imported project but it is not updated by WebFacing with any changes to CL commands. To use your old index.html page, either point your browser to it directly (http://your-server/your-app/index.html) or update the welcome file list in the Web application's web.xml file.
You can find additional information on known problems and workarounds in the Rational Web Application Developer Readme file, at http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/60/html/readme.html,
For Web updates for this product, use Rational Product Updater, which you can access after installing the product by clicking Start > Programs > IBM Rational > Rational Product Updater. See the Installation Guide for more information.
If you have any trouble getting updates from Rational Product Updater, you can visit the support Web pages at ibm.com/software/awdtools/wdt400/support. Follow the Support & Downloads link at the top of the page.
To post your questions on the newsgroups, use the following resources.
News server:
Suggested newsgroups:
Other suggested forum:
IBM Software Support provides assistance with product defects.
Before you submit your problem to IBM Software Support, ensure that your company has an active IBM software maintenance contract, and that you are authorized to submit problems to IBM. The type of software maintenance contract that you need depends on the type of product you have:
If you are not sure what type of software maintenance contract you need, call 1-800-IBMSERV (1-800-426-7378) in the United States. From other countries, go to the "Contacts" page of the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/contacts.html, and click the name of your geographic region for phone numbers of people who provide support for your location.
To contact IBM Software Support, follow these steps:
When you report a problem to IBM, you are asked to supply a severity
level. Therefore, you need to understand and assess the business impact
of the problem that you are reporting. Use the following
criteria:
| Severity 1 | The problem has a critical business impact: You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution. |
| Severity 2 | This problem has a significant business impact: The program is usable, but it is severely limited. |
| Severity 3 | This problem has some business impact: The program is usable, but less significant features (not critical to operations) are unavailable. |
| Severity 4 | The problem has minimal business impact: The problem causes little impact on operations, or a reasonable circumvention to the problem was implemented. |
When describing a problem to IBM, be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions:
You can submit your problem to IBM Software Support in one of two ways:
If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the Software Support Web site daily, so that other users who experience the same problem can benefit from the same resolution.
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 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 LicensingFor 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 CorporationThe 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:
Lab DirectorSuch 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.
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.
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. 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 IBM's application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2000, 2005. All rights reserved.
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:
| * AIX | * IBMLink | * S/390 |
| * DB2 | * iSeries | * Tivoli |
| * DB2 Universal Database | * Lotus | * VisualAge |
| *
| * Passport Advantage | * WebSphere |
| * IBM | * pSeries | * zSeries |
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Rational is a trademark of International Business Machines Corporation and Rational Software Corporation(R), in the United States, other countries or both.
Microsoft, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product, and service names may be trademarks or service marks of others.