IBM® WebSphere® Message Broker Version 6.1

Change history:

(C) Copyright IBM Corporation 2008. All rights reserved.

Welcome to IBM WebSphere Message Broker. This is the readme file for Version 6.1.0.2 of the Tooling and Runtime components.

This readme describes known problems, and contains updates to the available level of product documentation.

Contents


Essential information for all users

Always use the latest version of this readme file, which is available (in English only) at:
http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006917

To complete installation, refer to the WebSphere Message Broker Installation Guide. This includes information about tasks you must complete before you install the product.

If you are applying V6.1.0.2 service to the Message Broker Toolkit, refer to the Installation Guide for instructions on this process to ensure that you complete the process correctly.

Access the Installation Guide online in the IBM Publications Center at:

http://publib.boulder.ibm.com/epubs/pdf/c3468661.pdf

Essential information if you are migrating

If you are migrating from Version 5.0 or Version 6.0 of this product, refer to the online information center, which provides detailed information about how to migrate.

A document describing specific migration issues that have been reported through IBM Support is regularly updated on the WebSphere Message Broker Support Site. Click Troubleshoot and look for a document entitled "Problems migrating to V6.0 and V6.1".

Documentation

The standalone information center for WebSphere Message Broker is provided on the Quick Start CD, and can also be accessed online from: http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp

It is also available for download from:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz (Linux® version)
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip (Windows® version)

Read the quickstart_welcome.html file, which is included in the ibm_help folder within the wmb_help_linux.tgz and wmb_help_win.zip files.

Collections of information topics in Portable Document Format (.pdf), and documentation specific for Rules and Formatter, can be found at:
http://www-306.ibm.com/software/integration/wbimessagebroker/library/

Support

Defects: Throughout this readme document there are references to defect numbers. These numbers refer to internal IBM problem numbers; you might find these numbers useful when discussing problems with your IBM service representative.

Technotes: For current information about known problems and available fixes, look at:
http://www.ibm.com/software/integration/wbimessagebroker/support/

You can then find information using the following method:

All relevant Technotes are displayed and can be ordered and searched further.

For information about downloading WebSphere Message Broker Version 6.1 installation images from the Passport Advantage® Web site, see the Passport Advantage downloads for WebSphere Message Broker V6.1 download document, which is available at:
http://www.ibm.com/support/docview.wss?rs=849&uid;=swg24017456

Versions: For the latest status on which particular versions of operating system and databases are supported by WebSphere Message Broker, consult the System requirements page at:
http://www-306.ibm.com/software/integration/wbimessagebroker/requirements/index.html

Feature updates

Check periodically for feature updates to the Toolkit, including documentation updates in English and in other supported languages.
TOP

Restrictions and limitations

This section outlines the restrictions and limitations of WebSphere Message Broker, by component. 

TOP

Installation

When creating your installation path, ensure the path length does not exceed the maximum character length for your system. (For example; Windows allows a maximum of 256 characters).


TOP

Migration

Migration for z/OS requires IC54505.

In version 5.0 and 6.0, you can have a message set containing both non-MRM and MRM models with the message set Message Domain property set to something other than 'MRM' or 'IDOC', and generate a .dictionary file when the message set is added to a bar file, regardless of the Message Domain setting.

In version 6.1, a dictionary is generated only if Message Domain is 'MRM' or 'IDOC'.


TOP

WebSphere Message Broker Toolkit

When you try to start the Toolkit a "JVM terminated Exit Code = 1" error is displayed, or the javaw.exe process takes 100% of the CPU and stops.

The problem might be due to the -Xshareclasses:singleJVM, keep switch in the eclipse.ini file. This switch creates a cache that provides a means of sharing all loaded classes, and places no restrictions on the JVMs that are sharing the class data. If the cache becomes corrupted, no new JVMs are allowed to connect to the cache. Existing JVMs can continue to function, but cannot update the cache.

If you need to update packages that were originally installed using the IBM Installation Manager, you must also update them using the IBM Installation Manager. Although you can use Eclipse Update Manager to install non-IBM plug-ins, it is important that you do not use Eclipse Update Manager to update Eclipse features and plug-ins that were originally installed using the IBM Installation Manager. When you add plug-ins using the Eclipse Update Manager, ensure that you install them into the package group directory and not the shared resources directory (which is managed by the IBM Installation Manager and is reserved).

When multiple products have been installed as part of a package group, the panel that is displayed while the program is starting (which is sometimes referred to as the "splash screen") is dependent upon which product in the package group was installed first. For example, if you installed Rational® Application Developer (RAD), then WebSphere Message Broker, and then WebSphere Integration Developer (WID), the startup panel for RAD is displayed when any of the three programs is starting.

On Windows, the "Start Help" and "Stop Help" menu items in the Start->Program Files are missing.

On Windows, the following commands are not found from the command console:

If you import WSDL or XSD definitions, you might encounter errors in the file validity for certain file encodings such as EBCDIC-CP-US. To import these definitions successfully, update the encoding attribute within the XML file to the encoding of the system (for example; UTF-8).


TOP

Web Services

Windows .NET Server Web Services Security X509 is not supported with WebSphere Message Broker Version 6.1. All other WebSphere Message Broker Web Services capabilities with Windows .NET are still fully supported, specifically USERNAME tokens for Web Services Security.


TOP

Nodes

The Collector node can cause abends which are resolved in IC54505.

The JMS nodes on z/OS do not support the coordinated transactions until IC54505.

WebSphere Message Broker V6.1 Fix Pack 1 EndpointLookup and RegistryLookup nodes can be used to access service metadata that resides on WebSphere Service Registry and Repository (WSRR) version 6.02 or version 6.1. However new functionality introduced in WSRR version 6.1, such as referencing MQ Endpoints within WSDL and accessing modelled objects and elements, is not currently supported.

Due to known issues, these nodes are not currently supported on z/OS.


TOP

WebSphere Adapter nodes

To migrate from MQ link for SAP R/3 to Message Broker V6.1 you require IC54505.


TOP

Databases

There are known issues with JDBC/XA support which are resolved in IC54505.

Globally coordinated transaction support ('XA') is not supported.


TOP

Samples

The sample is not supported until IC54505.

The sample is not supported until IC54505.


TOP

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 information 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 information. The furnishing of this information does not give you any license to these patents. You can send license inquiries, in writing, to:

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

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 information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information 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:

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 information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Programming 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 includes 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. 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.

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

AIX, DB2, developerWorks, Everyplace, IBM, Passport Advantage, Rational, WebSphere, z/OS.

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 might be trademarks or service marks of others.


TOP

Useful Web sites

DB2 Fix Packs
You can obtain DB2 Fix Packs on CDROM or by downloading from the Web. Note, however, that Fix Packs might be large and therefore requesting CDROM versions will avoid lengthy downloads.
If you have a current support contract, you can order DB2 Fix Packs on CDROM by calling DB2 support.
Contact details are provided at:
http://www.ibm.com/software/data/db2/udb/support.html
You can also download from the same Web site.

WebSphere MQ Fix Packs
http://www.ibm.com/software/integration/wmq/support/

WebSphere Message Broker Fix Packs
http://www.ibm.com/support/docview.wss?rs=171&uid;=swg27006367

WebSphere Message Broker Requirements
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

WebSphere Message Broker Readme
http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006917

WebSphere Message Broker Stand-alone Information Center
For Linux:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz
For Windows:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip

WebSphere Message Broker V6.1 online information center
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp

IBM Centre for Java™ Technology Development Downloads
http://www.ibm.com/developerworks/java/jdk/

Web Services Description Language (WSDL) Specification
http://www.w3.org/TR/wsdl

WebSphere Message Broker developerWorks® Zone
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html