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.
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
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".
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/
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:
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
This section outlines the restrictions and limitations of WebSphere Message Broker, by component.
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).
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'.
Solution:
Select the MRM check box under the message set Supported message domains property.
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.
Solution:
To resolve the problem, delete the corrupted cache. The cache is rebuilt the next time the product is launched. To delete the cache:
1. Open a command prompt.
2. Navigate to Message Broker Toolkit Directory/jdk/jre/bin
3. Enter the following command:
On Microsoft® Windows:
javaw.exe -Xshareclasses:destroy
On Linux:
./javaw -Xshareclasses:destroy
The product will now start successfully.
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).
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.
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.
To migrate from MQ link for SAP R/3 to Message Broker V6.1 you require IC54505.
There are known issues with JDBC/XA support which are resolved in IC54505.
Globally coordinated transaction support ('XA') is not supported.
The sample is not supported until IC54505.
The sample is not supported until IC54505.
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.
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