IBM Branch Transformation Toolkit for WebSphere Studio v5.2.0.1 readme

Before using this information and the product it supports, be sure to read the general information under Notices.

This edition applies to version 5, release 2, modification 0, fix pack 1, of IBM Branch Transformation Toolkit for WebSphere Studio (5724-H82) and to all subsequent releases and modifications until otherwise indicated in new editions.

IBM welcomes your comments. You can send to the following address:

IBM China Software Development Lab
Branch Transformation Toolkit Product
Diamond Building, ZhongGuanCun Software Park, Dongbeiwang West Road No.8,
ShangDi, Haidian District, Beijing 100094 P. R. China

Include the title and order number of this book, and the page number or topic related to your comment.

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

Table of Contents

About this fix pack
Platform upgrade
Product fix history
Installation information
System requirements
Hardware requirements
Software requirements
Installation instructions
Installation package structure
Installing the Branch Transformation Toolkit on a development workstation
Known limitations, problems, and workarounds
Frequently Asked Questions and Answers
Notices
Trademarks and service marks


Compilation date: 2007/06/28

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

---

About this fix pack

This document contains detailed information about version 5.2.0.1 of IBM^(R) Branch Transformation Toolkit for WebSphere^(R) Studio (Branch Transformation Toolkit), fix pack of Branch Transformation Toolkit version 5.2.0.

---

Platform upgrade

• Support for WebSphere Application Server 6.1.0.7 and Rational^(R) Application Developer 7.0.0.2.

Note:
This fix pack is certified on JDK 1.5 based IBM products such as WebSphere Application Server V6.1 and Rational Application Developer V7.0. The latest versions of WebSphere Portal Server, WebSphere Process Server and WebSphere Integration Developer are JDK 1.4 based. As a result, this fix pack does not support Portal Extension, which is provided by WebSphere Portal Server and BPEL feature, which is provided by WebSphere Process Server and WebSphere Integration Developer. To use these features, you need to use BTT V5.2.0 which supports WebSphere Portal Server V5.1.x, WebSphere Process Server V6.0.2 and WebSphere Integration Developer V6.0.2.

• Support for DB2 V9.
• Support for Microsoft^(R) SQL Server 2005.

---

Product fix history

The following APARs are addressed by this fix pack:

Table 1. Closed APARs against V5.2.0 or earlier releases

APAR	Description
JR20304f_1	BTT fails to refer to keyedCollection in self-defined processor.
JR20101f_1	The problem occurs on the client application if the state of long running processors changes frequently.
JR20645f_1	The problem occurs when multiple entries exist in the IndexedCollection and subsequent entries do not have all the fields populated.
JR21340f_1	The Client/Server Mechanism does not make use of the Event Manager because the Client/Server was built before the Event Manager, which causes the BTT DB event multicaster to cast exception.
JR22056f_1	Since SWING is not thread safe, sometimes there is deadlock between BTT thread and Swing thread.
JR22951f_1	SpPanel overrides setvisible() method. It does not record visible attribute of it's child component. Every time this method is called, all child components' visible attributes will be reset again.
JR26373	NameNotFoundException is thrown from Context. The JMS function of BTTEvent is turned on by default. So, if JMS queue is not configured in WebSphere Application Server, there will be exceptions.
JR26375	The API of getElementAt() is absent from OperationStep.
JR26378	Several GUI problems are restricting the use of the application. When using the DSEGuiBeans for the Java(TM) Client, frequent screen freezes and unexpected behaviour with text fields and combo boxes are encountered.
JR26627	java.lang.ClassCastException is thrown when using org.apache.struts.ActionMapping and com.ibm.btt.struts.BTTActionMapping together in BTT 5.2.0.
JR26283	Two new JCA verbs are added to get the LU name from LU62 connection: SYNC_GET_LOCAL_LU_NAME, and SYNC_GET_PARTNER_LU_NAME. Verb SYNC_GET_LOCAL_LU_NAME is used to get local LU name for the LU62 conversation Verb SYNC_GET_PARTNER_LU_NAME is used to get remote LU name for the LU62 conversation. For the two new verbs, BTT will call SNA CPI-C APIs: Extract_Local_LU_Name, Extract_Partner_LU_Name by JNI call. Note: The two APIs only apply to AIX(R) and Linux(R) platforms of Communication Server. Following is the sample code for the two verbs: Lu62InteractionSpec ixnSpec = new Lu62InteractionSpec(); Lu62Record outgoingData = new Lu62Record(); Lu62Record returnData = new Lu62Record(); ixnSpec.setInteractionVerb(ixnSpec.SYNC_GET_LOCAL_LU_NAME); connection.execute(ixnSpec, outgoingData, returnData); System.out.println("Local LU name :"+returnData.getData());
JR26917	Java client side does not support failover in BTT 5.2.0.
JR26918	Framework does not support remote context in self-defined server operation XML files.
JR26942	BTT should support pure memory CHA mode.

---

Installation information

This section provides information about system requirements, product installation information for IBM Branch Transformation Toolkit version 5.2.0 fix pack 1.

System requirements

Hardware requirements

Hardware requirements for Server

Note:
These memory and disk requirements listed below are for the IBM WebSphere Application Server.

For Microsoft Windows^(R) 2003

• Intel^(R) Pentium^(R) III processor at 1 GHz, or faster
• Minimum 1 GB RAM; 2 GB recommended
• Minimum 1 GB of free disk space for installation (includes SDK)

For Linux (Intel)

• Intel Pentium processor at 500 MHz, or faster
• Minimum 1 GB RAM; 2 GB recommended
• Minimum 1 GB of free disk space for installation (includes SDK)

For AIX

• IBM pSeries^(R) or iSeries^(TM) system at 375 MHz, or faster
• Minimum 1 GB RAM; 2 GB recommended
• Minimum 1 GB of free disk space for installation (includes SDK)

For Solaris

• SPARC workstation at 440 MHz, or faster
• Minimum 512 MB RAM; 1 GB recommended
• Minimum 1 GB of free disk space for installation (includes SDK)

For additional software products, for example DB2 ^(R), IBM Communications Server or WebSphere MQSeries ^(R) Integrator, refer to the respective product documentation.

Hardware requirements for Client

For Windows XP

• Minimum 512 MB RAM
• Minimum 100 MB of free disk space for installation
• Minimum display 1024 x 768

For Linux (Intel)

• Minimum 512 MB RAM
• Minimum 100 MB of free disk space for installation
• Minimum display 1024 x 768

Hardware requirements for development environment

Note:
These memory and disk requirements listed below are for the IBM Rational Application Developer.

For Windows XP

• Intel Pentium III processor at 1 G MHz, or faster
• Minimum 1 GB RAM; 2 GB recommended
• Minimum 3.7 GB of free disk space for installation
• Minimum display 1024 x 768

For Linux (Intel)

• Intel Pentium III processor at 1 G MHz, or faster
• Minimum 1 GB RAM; 2 GB recommended
• Minimum 3.7 GB of free disk space for installation
• Minimum display 1024 x 768

If the development environment requires additional software products, for example DB2, IBM Communications Server or WebSphere MQSeries Integrator, refer to the specific product documentation.

Software requirements

Supported operating systems for development and runtime

• AIX V5.3 with Recommended Maintenance Package 5300-04-01
• Windows Server 2003, Enterprise and Standard
• Windows XP Professional with Service Pack 2 (Client and Development)
• Red Hat Enterprise Linux WS 4.0 Update 3 (Client and Development)
• Red Hat Enterprise Linux ES/AS 3.0 Update 8
• Red Hat Enterprise Linux ES/AS 4.0 Update 3
• Solaris 10 with the latest Patch Cluster

Supported application servers

For Windows 2003, Solaris, Linux (Intel) and AIX

• WebSphere Application Server, V6.1.0.7
• WebSphere Application Server Network Deployment V6.1.0.7

Supported development environment

• IBM Rational Application Developer V7.0.0.2

Supported browsers

• Internet Explorer 6.0 SP2
• Mozilla 1.7.8

Supported database

• IBM DB2 UDB Enterprise Server Edition V8.2.7 and V9.1 FP2
• Oracle 10g Enterprise 10.1.0.4 and 10.2.0.2
• Microsoft SQL Server 2000 Enterprise SP4 and 2005

Optional software

• WebSphere MQ V6.0.2.1
• IBM Communications Server for AIX V6.3 with latest PTFs
• IBM Communications Server for Linux V6.2.2 with latest PTFs
• IBM Communications Server for Windows XP and Windows 2003 V6.1.2 with latest PTFs
• IBM 32-bit SDK, Java 2 Technology Edition, V5.0 SR2

Installation instructions

Note:
This fix pack can coexist with IBM Branch Transformation Toolkit version 4.3 and 5.1. But if your current version of IBM Branch Transformation Toolkit is version 5.2.0, you need to uninstall it before you install this fix pack.

Installation package structure

The Branch Transformation Toolkit version 5.2.0.1 installation package mainly contains two groups of components - components for the development environment and components for the runtime environment.

Development environment

For the development environment, Branch Transformation Toolkit version 5.2.0.1 supports IBM Rational Application Developer 7.0.0.2. It provides a set of plug-ins:

Plug-ins for IBM Rational Application Developer 7.0.0.2

These plug-ins include components that have dependencies on features provided by IBM Rational Application Developer 7.0.0.2.

Runtime environment

For the runtime environment, Branch Transformation Toolkit supports WebSphere Application Server 6.1.0.7.

Installing the Branch Transformation Toolkit on a development workstation

To install the Branch Transformation Toolkit version 5.2.0.1 on a development workstation, do the following:
1. Install Rational Application Developer version 7.0.0.2
2. Insert the Branch Transformation Toolkit CD into the CD-ROM and browse the CD.

• If you want to install Branch Transformation Toolkit for Windows, run setupwin32.exe in the Windows platform.
• If you want to install Branch Transformation Toolkit for Linux, run setupLinux.bin in the Linux platform.

This starts the Installation Wizard for Branch Transformation Toolkit
3. The Installation Wizard will install toolkit components designed for IBM Rational Application Developer and those for WebSphere Application Server.

The Branch Transformation Toolkit installation program creates the following set of directories on the target machine.

Table 2. Directories created by installation

Directory name	Description of contents
dbtools	Scripts to manage database tables for the CHA component
desktop	Desktop DTD file
doc	The Branch Transformation Toolkit documentation plug-ins to IBM Rational Application Developer
plugins	CHA Editor plug-in Format Editor plug-in Visual beans plug-in Self-define merging tool plug-in
ear	EAR file to provide the infrastructure for the CHA component of the toolkit. You can use the EAR to build applications on the Branch Transformation Toolkit
jars	The Branch Transformation Toolkit code separated into various JARs according to the functional unit to which the code belongs. A solution built on the Branch Transformation Toolkit can use the JARs for the functional units that it is using. See Functional units, packages, and dependencies for a listing of the JARs and their contents and corequisites
samples	EAR files to run the sample applications provided by the Branch Transformation Toolkit in the IBM Rational Application Developer workbench. This directory also contains the source code of the samples
services	Runtime files that are needed by some of the services of the framework, for example, WOSA service.
javadoc	The Javadoc for BTT.

For more information about how to setup Branch Transformation Toolkit development environment, see IBM Branch Transformation Toolkit for WebSphere Studio: Installation guide.

---

Known limitations, problems, and workarounds

The following limitation has been identified:

• This fix pack does not support Graphical Builder, BPEL Extension Editor, Struts Extension Editor, and Migration tool because of the structure changes in Rational Application Developer V7.

---

Frequently Asked Questions and Answers

1. Is WAS 7.0 a supported platform?

A: No, this release is not certified on WAS 7.0.

---

Notices

IBM may not offer the products, services, or features discussed in this document in all 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 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 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 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 China Software Development Lab
Diamond Building, ZhongGuanCun Software Park, Dongbeiwang West Road No.8,
ShangDi, Haidian District, Beijing 100094 P. R. China

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 document 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 measurement 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.

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.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

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.

---

Trademarks and service marks

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

AIX	MQSeries
AIX 5L	pSeries
DB2	Rational
DB2 Universal Database	S/390 Parallel Enterprise Server
IBM	WebSphere
iSeries	zSeries
LANDP

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.

Microsoft, Windows, Windows NT, and the Windows logo 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.

---

BTT v5.2.0.1 Readme pdf format:

More information about BTT 5.2