IBM WebSphere Business Integration Adapter for JMS, Version 2.8.0

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

Release notes

Description

These release notes cover release information for Version 2.8.0 of the IBM(R) WebSphere(R) Business Integration Adapter for JMS. The WBI adapter for JMS integrates WebSphere Business Integration Broker with applications that send and receive business data in the form of JMS messages.

The announcement letter for WebSphere(R) Business Integration Adapter for JMS, version 2.8.0, is available on the Web at http://www.ibm.com/common/ssi/OIX.
From the Specific information search menu, select Announcements, and click Go.

To search for the announcement letter, click Search Announcements, type Adapter for JMS in the Title field, and click Search.

See the announcement letter for the following types of information :

Update history

This update includes the following fixes:

Tracking
number
Description
60343 - JR20536 Adapter throws null pointer exception. JMS adapter threw NullPointerException because of irrelevant use of a method on a LinkedException.
44680 - JR20745  JMS adapter could not restart even if the RestartRetry is set in Connector Configurator. JMS adapter did not recognize RestartRetry property in Connector Configurator file.
60012 - JR20401  Problem with synchronized event processing. Problem due to the adapter not using the input queue to lookup conversion properties for converting the response BO, during sync event processing.
60707 - JR21381  JMS adapter: uses trim () incorrectly when getting correlation ID.
60931 - JR20843  Adapter not shutting down cleanly after MQJMS errors. Adapter was not shutting down cleanly, if SessionCache instance is invalid.
59825/59172  Message 21021 missing in the message file WebSphereMQConnector.txt.
61684 - JR21158  ClassCastException using JBoss with the JMS Adapter. JMS connector threw CassCastException when sending a BO to a topic, when used with JBoss JMS provider.

This update includes the following enhancements:

Tracking
number
Description
20524 Enhancement of JMS connector to have multi-threading on polling. This enhancement enables adapter to use multiple thread for polling. The maximum number of threads can be specified by WorkerThreadCount property in connector configurator.
24620 JMS adapter enhancement request for Object Message Support. The adapter supports two types of messages ie "text" and "binary". This enhancement would allow the adapter to work with messages of type Java Object.
59642  Optimized the createDataHandler call in the JMS adapter. This enhancement would allow the adapter to pool the instances of data handlers already created and reuse them later.
60890  Support for AIX 5.3.

Backward compatibility

The adapter requires Adatper Framework version 2.6.0.3 for multithreaded feature, but otherwise is compatible with Adapter Framework version 2.6.0 and greater.

Supported hardware and software

OSProcessorMemoryDiskOther
Sun SolarisUltraSPARC II @ 450 MHz512MB40GBModel: SunFire V120
AIXIBM POWER3-II @ 375 MHz512MB40GBModel: pSeries 610 6E1
Win2k/Win2003PentiumIII @ 1GHz512 MB40GBModel: IBM eServer xSeries
HP-UXHP-UX 9000/800 @ 440 MHz 64-bit512 MB40GBModel: Hewlett-Packard HP-9000 PA-RISC
LinuxPentium PentiumIII @ 1GHz512 MB40GBModel: IBM eServer xSeries

For hardware and software requirements, see WebSphere Adapters hardware and software requirements.

Important installation information

Refer to the following Web sites for installation and configuration information for WebSphere WebSphere Business Integration Adapter for JMS:

Updates, limitations, and known problems

Updates, limitations, and known problems about WebSphere Business Integration Adapter for JMS, version 2.8.0, are documented in the form of technotes on the IBM Software Support Web site at http://www.ibm.com/software/integration/wbiadapters/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 following link launches a customized query of the live Support knowledge base. To create your own query, go to the Advanced search page on the IBM Software Support Web site:

View technotes for WebSphere Business Integration Adapter for JMS

IBM Software Support

IBM Software Support provides assistance with product defects. If you encounter a problem with WebSphere Business Integration Adapter for JMS, follow these steps:

  1. Download and launch IBM Support Assistant and search the support information for a solution.
  2. If you cannot find the information you need, submit the problem to IBM using the Service component of IBM Support Assistant or by contacting IBM Software Support.

    Note: To submit problems to IBM Software Support, you must have an active software maintenance contract. See Contacting IBM Software Support for information.

IBM Support Assistant

WebSphere Business Integration Adapter for JMS, version 2.8.0, includes IBM Support Assistant, a tool that helps you use various IBM Support resources from within the offering. It includes the following components to help you with software questions:

To download IBM Support Assistant:

  1. Log in to the WebSphere Application Server administrative console and select Support from the top menu.
  2. On the product support page, download IBM Support Assistant by clicking Click here to download the IBM Support Assistant.
  3. Follow the instructions in the README file to install the tool.
  4. After IBM Support Assistant is installed, launch it by clicking Support from the top menu in the administrative console.

Contacting IBM Software Support

If you cannot resolve the problem using IBM Support Assistant, contact IBM. However, before you submit a problem to IBM Software Support (through IBM Support Assistant or directly), 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.

Submitting a problem report to IBM Software Support

To submit a problem to IBM, first determine the business impact of the problem and gather background information about it. The background information helps IBM Software Support representatives find a solution more quickly. The following sections guide you through the tasks for submitting a problem.

Determine the business impact of the 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 to determine the severity level:

Severity level Description
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 The 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 the 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 the 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.

Trademarks

Trademarks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: DB2, IBM, IBMLink, iSeries, Lotus, Passport Advantage, pSeries, Rational, S/390, Tivoli, WebSphere, and zSeries.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
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.

Copyright IBM Corporation 2003, 2005. All Rights Reserved.

>