Release Notes for WebSphere Transformation Extender V8.2 Interim Fix 1

Content

IBM WebSphere® Transformation Extender, Version 8.2 Interim Fix 1
release notes (rev. 2)

© Copyright IBM Corporation 2006, 2007. All Rights Reserved.


=====================================================================
CONTENTS
=====================================================================

1. About this release
2. Known limitations, problems, and workarounds
3. Resolved Authorized Program Analysis Reports (APARs)
4. Contacting customer support
5. Notices and trademarks

=====================================================================
1. ABOUT THIS RELEASE
=====================================================================

This 8.2 Interim Fix 1 release contains updates and fixes to the 8.2 version of the product. You must first install 8.2 and then install this Interim Fix 1, located on the IBM Web site under Support and downloads.

The Interim Fix can also be downloaded here:
Windows Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/windows/intfix01_8200_win.exe)

UNIX 32-bit
AIX Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix32bit/wsdtxif01_8200_aix32.tar)

HP Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix32bit/wsdtxif01_8200_hp32.tar)

Itanium Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix32bit/wsdtxif01_8200_itanium32.tar)

Linux Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix32bit/wsdtxif01_8200_linux32.tar)

Sun Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix32bit/wsdtxif01_8200_sun32.tar)


UNIX 64-bit
AIX Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix64bit/wsdtxif01_8200_aix64.tar)

HP Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix64bit/wsdtxif01_8200_hp64.tar)

Itanium Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix64bit/wsdtxif01_8200_itanium64.tar)

Linux Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix64bit/wsdtxif01_8200_linux64.tar)

Sun Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix64bit/wsdtxif01_8200_sun64.tar)

zLinux Interim Fix 1 for 8.2
(ftp://public.dhe.ibm.com/software/websphere/wtx/82/InterimFix01/unix64bit/wsdtxif01_8200_zlinux64.tar)


Warning: There is no uninstall program available for the 8.2 Interim Fix 1. You will have to uninstall the base WebSphere Transformation Extender 8.2 product installation and then do manual steps to remove any remaining files and folders from the product installation location.

Release 8.2 can coexist on the same computer as prior point releases. For example 7.5, 8.0, and 8.1 can coexist on the same computer.

This file contains only information since the IBM WebSphere Transformation Extender release 8.2. For information about the 8.2 release, view the Product Release Notes and any other related Release Notes that are on the IBM WebSphere Transformation Extender Support Web site.

For information about the documentation and how to access it, see the Documentation Release Notes that are on the IBM WebSphere Transformation Extender Support Web site.

For additional information such as answers to frequently asked questions, and solutions to or workarounds for problems that have been documented for this release, view the Technotes that are on the IBM Support Web site.

In the sections in this file, there are release notes for the IBM WebSphere Transformation Extender products listed below.

- IBM WebSphere Transformation Extender with Command Server
- IBM WebSphere Transformation Extender with Launcher
- IBM WebSphere Transformation Extender with Launcher Studio
- IBM WebSphere Transformation Extender Design Studio
- IBM WebSphere Transformation Extender for Application Programming
- IBM WebSphere Transformation Extender SDK


To Dos before opening the Design Studio

Certain circumstances combined with the default behavior of Eclipse applications, which is that it caches plug-ins, might cause problems when you use the Design Studio. They might cause the open Design Studio process to fail, the Design Studio to be unstable or to exhibit the behavior of an earlier release, or the run map process to fail.

You can avoid these problems by doing some steps before you open the Design Studio application. In some cases, you should first run the cleanextenderstudio.bat batch file that is included in the installation at the root of install_dir, and is used to clear the cached version of the Design Studio plug-ins. In other cases, you should first delete the .metadata folder that is in your workspace, and then reimport the workspace, or switch to a different workspace.

Run the cleanextenderstudio.bat batch file under the following circumstances:

• Your workspace got corrupted.
  
  In this case, when Eclipse attempts to open the Design Studio, the open process fails.

• You installed a patch that the WebSphere Transformation Extender customer support team provided you, which copied files to the wtxstudio directory.
  
  In this case, when Eclipse attempts to open the Design Studio, it uses the cached versions of the Design Studio plug-ins from the prior release on which this patch was installed, which causes the open Design Studio process to fail.

• You installed a Fix Pack release on top of a WebSphere Transformation Extender 8.2.x release.
  
  In this case, when Eclipse attempts to open the Design Studio, it uses the cached versions of the Design Studio plug-ins from the prior release on which this Fix Pack was installed, which causes the open Design Studio process to fail.

Delete the .metadata folder and reimport the workspace, or switch to a different workspace under the following circumstance:

• You ran a map that could not be loaded into memory, which caused the map to fail and the Design Studio application to terminate abnormally.
  
  When you tried to reopen the application, the open process failed.

=====================================================================
2. KNOWN LIMITATIONS, PROBLEMS, AND WORKAROUNDS
=====================================================================


Java applications

[PMR59440] Time stamp from operating system not accurate in log files

Java applications, such as the Management Console, running on Windows Vista do not adjust the time correctly for the appropriate time zone. For example, the time returned is equivalent to Greenwich mean time (GMT)+0 instead of GMT-5.00 for eastern standard time (EST). The managementconsole.log and launcher.log files are affected by this issue.


Windows Vista compatibility

This upgrade for Windows Vista compatibility corrects the following problems:


- Java exception when starting a system on Windows Vista

- Font in Designer applications does not display




=====================================================================
3. RESOLVED AUTHORIZED PROGRAM ANALYSIS REPORTS (APARs)
=====================================================================

Platform API

[PK57827] Fixed an inconsistency found in acceptable map command format for InitializeRunMapInstance and RunMap for the SDK API program. RunMap function will now return the z/OS severity code. InitializeRunMapInstance can now be called using the map name format of DDname(membername). Previously this function would fail to open the map. Updated COBOL sample to show how to call the API mutiple times when using maps in memory.


IBM WebSphere Transformation Extender
for Application Programming
CICS Execution Option

[PK56804] Running a map interfacing with DB2 on CICS results in an abend with an 0C4. If this is a dblookup, dbquery, and so forth, no options exist because none were created. Options are only available for files associated with "real" cards.


Command Server

[PK58042] Fixed an issue where the command line that overrides input or output and does not specify <src> or <dest> target will result in the message 'invalid command line error' on HP Itanium.


Core Engine

[PK54987] Resolved an issue where the HandleGroupStart code decremented the lpLS->dwOffset causing the offset to appear before the parent offset. When mapping as a child object, the map cannot have an offset before its parent.

[PK58152] Audit log was not reporting all the errors in the datalog.
Changed the paging code that finds contained objects to better handle objects with zero lengths.

[PK58166] The pad to length was not being set when the min bytes was not set. We now check if we are padding with characters and pad accordingly. Pad characters now appear for Text items padded to Min Content.

[PK57046] Modified code in paging subsystem (UnSetTypeFound) to avoid an inappropriate modification of an internal structure.

[PK57288] Fixed an issue to prevent 0C4 abend or access exceptions when executing a map if no override is provided for an output card and map audit is enabled.

[PK58170] Fixed a performance issue when using SEARCHUP. The level representing the object being searched cannot represent a series.

[PK57663] Code added to allow validation of QUOT and ANYQUOT symbols. The data length is multiplied by the adustable amount to ensure there is enough data to convert.

[PK57342] Engine ended abnormally when transforming SJIS to EBCDIC. Code was added to recognize Japanese EBCDIC and to set up the character-length array correctly.


Database Interface Designer

[PK56936] If a table had a space in the name, typetrees were unable to be generated from the DID in Japanese. Now MakeTypeNameFromDB can receive a non-UTF16 string and iterate successfully. Spaces are now replaced with '#' from column names when the National Language is Japanese.


Launcher

[PK57153] Fixed an issue to ensure loading of the appropriate .dlls in z/OS USS. Now, .so files are loaded first. Previously, loading a .dll with no .so would cause problems when calling .dll functions.


Importers

[PK58168] The WSDL importer, when creating a type tree, incorrectly generated the opening and closing XML tags for each of the messages. The WSDL Importer now uses the message name when constructing the xml element for the SOAP input messages. Previously, it used the operation name.


Eclipse Design Studio

Map Designer

[PK58169] Fixed an issue when building maps for Datapower caused the Map Designer to end abnormally. MAX_SYNTAX has been reset to 3000 from 6000 since the maximum number of syntax characters allowed is 3000.


Resource Manager

[PK56810] Fixed an issue with the Launcher and deadlock map execution. If the resource is already in the table, but the deadlock is avoided due to the same instance (e.g. top level map and run map sharing the file) AND the resource is not in use by some other map (which would cause blocking and thread suspension), do NOT add resource to the table.




=====================================================================
4. CONTACTING CUSTOMER SUPPORT
=====================================================================

Contact Customer Support at 1-800-IBM-SERV or go to the support portal.


=====================================================================
5. NOTICES AND TRADEMARKS
=====================================================================

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-0032, 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.

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:

IBM Corporation
577 Airport Blvd., Suite 800
Burlingame, CA 94010
U.S.A.

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 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, a nd 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 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 illustrate 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.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Programming interface information
Programming interface information, if provided, 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
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

• Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
• IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce
• Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
• Linux is a registered trademark of Linus Torvalds 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.
• ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office
• UNIX is a registered trademark of The Open Group in the United States and other countries.
• Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.
• Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
• Oracle and all Oracle-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Other product and service names might be trademarks of IBM or other companies.


This product includes software developed by the Eclipse Project
(http://www.eclipse.org/).

WebSphere Transformation Extender, Version 8.2 Interim Fix 1