IBM WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0.1, Readme file


Questo documento non è disponibile in italiano. In annesso una versione in inglese.

Contents

About this release
Before you begin
System requirements
Prerequisite iSeries server PTFs
Installation of WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0
Installation of WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0.1
Installation of WebSphere Development Studio Client Lite for iSeries Technology Preview
Starting the product
Updates, limitations, and known problems
Help System
IBM WebFacing Tool
Rational Application Developer information
Support information
Downloading Web updates
Posting questions on a newsgroup
Contacting IBM Software Support
Determine the business impact of your problem
Describe your problem and gather background information
Submit your problem
Notices
COPYRIGHT LICENSE:
Programming interface information
Trademarks and service marks

About this release

WebSphere(R) Development Studio Client for iSeries(TM) Advanced Edition, Version 6.0.1 consists of updates and new features that are delivered via Rational Product Updater and are applied to WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0. Therefore, WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0 must be installed before the 6.0.1 updates can be installed

This document contains prerequisite information for IBM(R) WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0 and Version 6.0.1, and information not included in the product documentation.

WebSphere Development Studio Client for iSeries Advanced Edition Version 6.0 and Version 6.0.1 include the following Eclipse-based components:

  1. All components of IBM Rational(R) Application Developer for WebSphere Software V6.0 and V6.0.1
  2. Remote System Explorer
  3. IBM WebFacing Tool
  4. iSeries Java Tools
  5. iSeries Web Tools
  6. IBM Toolbox for Java
  7. Integrated iSeries Debugger
  8. Enterprise Generation Language (EGL) (Java generation)

WebSphere Development Studio Client for iSeries Advanced Edition Version 6.0 also includes the following components on a separate CD:

  1. CoOperative Development Environment (CODE)
  2. VisualAge(R) RPG
  3. Distributed Debugger

The announcement letters of WebSphere Development Client for iSeries Advanced Edition, Version 6.0. and Version 6.0.1 are available on the Web at http://www.ibm.com/common/ssi. See the announcement letters for the following types of information:

For more information, see the iSeries Development Family Web site at ibm.com/software/awdtools/iseries.

Before you begin

The latest English version of this document is available on the Web.

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:

System requirements

Refer to the Installation Guide for the system requirements for installing WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0. Similar system requirements apply for WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0.1

For WebSphere Development Studio Client Advanced Edition, installation requires a minimum of 7.5 GB of disk space. Some of this disk space (3.5 GB) is used only during the installation process and can be recovered after the installation is complete.

The WebSphere Development Studio Client Lite Tech Preview, an optional feature, requires an additional 500 MB of free hard drive space.

Prerequisite iSeries server PTFs

You can find information about any required iSeries server PTFs in two ways:

Installation of WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0

Here is a list of the contents of the WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0 package. Items listed as optional are additional workstation components. Install them only if you are doing development tasks that require them. You can install these components as part of the initial installation, 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 application 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

  • Application Server
  • IBM HTTP Server
  • Web server plug-ins
  • Application Client for WebSphere Application Server
  • DataDirect technologies JDBC Drivers for Microsoft(R) SQL Server 2000

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,

  • Professional Edition (English)
  • Professional Edition (Japanese)
  • Embedded Edition (English and Japanese)

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.

Installation of WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0.1

WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0.1 is installed by Web update. Use Rational Product Updater, which you can access after installing Version 6.0 of 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.

Installation of WebSphere Development Studio Client Lite for iSeries Technology Preview

The WebSphere Development Studio Client Lite for iSeries Technology Preview shipped in this release allows users who are developing native i5/OS applications to install a much lighter-weight Integrated Development Environment consisting of the base Eclipse IDE with the Remote System Explorer and Debug plug-ins

Refer to the Readme file for WebSphere Development Studio Client Lite for iSeries Technology Preview for installation instructions.

Starting the product

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.

Since WebSphere Development Studio Client for iSeries Advanced Edition is built on IBM Rational Application Developer, 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.

Updates, limitations, and known problems

Updates, limitations, and known problems about WebSphere Development Studio Client for iSeries Advanced Edition, Version 6.0 and Version 6.0.1, 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.

Help System

The help system operates using a lightweight HTTP Server on your local machine. If you are not able to launch the Help, one reason might be that your firewall settings may not allow help to be displayed.

Refer to Cannot access online help due to proxy server for a possible solution.

IBM WebFacing Tool

Refer to the technotes for the WebFacing Tool for updates, limitations, and known problems.

Customers who take advantage of the new extensions that allow the WebFacing Tool and Host Access Transformation Services (HATS) technologies to work together in an integrated fashion, will find that deployment for the new functions is limited to two user connections for testing purpose only. To enable the new functions for deployment to production, customers must purchase IBM WebFacing Deployment Tool for WebSphere Development Studio - with HATS Technology, Version 6.0.1.

Rational Application Developer information

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,

Support information

Downloading Web updates

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.

Posting questions on a newsgroup

To post your questions on the newsgroups, use the following resources.

News server:

Suggested newsgroups:

Other suggested forum:

Contacting IBM Software Support

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:

  1. Ensure that you have installed the latest fixes available from the Web.
  2. Determine the business impact of your problem.
  3. Describe your problem and gather background information.
  4. Submit your problem to IBM Software Support or through the IBM Support Assistant.

Determine the business impact of your problem

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.

Describe your problem and gather background information

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:

Submit your problem

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.

Notices

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 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:

Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7

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.

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. 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, 2006. All rights reserved.

Programming interface information

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.

Trademarks and service marks

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
* eserver graphic * 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.