IBM® WebSphere® Message Broker Version 6.1

Change history:

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

Welcome to IBM WebSphere Message Broker. This is the readme file for Version 6.1.0.5 (fix pack 5) of the tooling and runtime components.

This readme file 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.ibm.com/support/docview.wss?rs=171&uid=swg27006917

Translated readme files are available at:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/

For information about the tasks you must complete before you install the product, refer to the WebSphere Message Broker Installation Guide.

If you are applying V6.1.0.5 (fix pack 5) 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/c3468662.pdf

Applying service to z/OS®

If you are applying service to z/OS, the Program Temporary Fix (PTF) packages must be downloaded as binary files, and then transferred to z/OS:

  1. Download the PTF packages as binary files from the WebSphere Message Broker Support Site at http://www.ibm.com/software/integration/wbimessagebroker/support/ and save the files to your workstation.
  2. Allocate sequential datasets with the following attributes:
  3. Organization . . . : PS

    Record format . . . : FB

    Record length . . . : 1024

    Block size . . . . : 6144

    1st extent tracks . : 500

    Secondary tracks . : 50

    You can use the following sample Job Control Language (JCL) to allocate these datasets:

    /* INSERT A VALID JOBCARD HERE

    //*

    //ALLOCATE EXEC PGM=IEFBR14

    //SYSMOD1 DD DSN=YOUR HIGH LEVEL QUALIFIER (HLQ).PTF NUMBER.TRS,

    // DISP=(NEW,CATLG,DELETE),

    // UNIT=SYSDA,

    // SPACE=(TRK,(500,50),RLSE),

    // DSORG=PS,

    // DCB=(RECFM=FB,LRECL=1024,BLKSIZE=6144)

    //*

  4. Transfer the binary files from your local workstation to z/OS. File Transfer Protocol (FTP) can be used to transfer the files to the target z/OS as binary files by using the replace option, for example:
  5. put PTF NUMBER.TRS 'YOUR HLQ.PTF NUMBER.TRS' (replace

  6. Unpack the datasets using the TRSMAIN utility program. This utility is freely available at http://techsupport.services.ibm.com/390/trsmain.html.
  7. You can use the following sample JCL to unpack the datasets after the changes have been made, and a suitable job card added:

    //*****************************************************

    //* UNTERSE APAR

    //*****************************************************

    /UNPACK EXEC PGM=TRSMAIN,PARM='UNPACK'

    //STEPLIB DD DISP=SHR,DSN=TERSE.LOADLIB

    //SYSPRINT DD SYSOUT=*

    //INFILE DD DSN=YOUR HLQ.PTF NUMBER.TRS,

    // DISP=SHR

    //OUTFILE DD DSN=YOUR HLQ.PTF NUMBER,

    // DISP=(NEW,CATLG),

    // SPACE=(TRK,(1000,100,))

    /*

  8. Apply the resulting files using System Modification Program/Extended (SMP/E) for z/OS RECEIVE and APPLY.


Essential information if you are migrating

If you are migrating from WebSphere Message Broker Version 5.0 or Version 6.0, refer to the online information center at http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp, 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 Web site at http://www.ibm.com/software/integration/wbimessagebroker/support/. Click Troubleshoot > View all Troubleshooting documents and search for a document entitled "Problems and solutions when migrating to WebSphere Message Broker 6.0 and 6.1".


Documentation

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

It is also available for download at:
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) can be found at:
http://www.ibm.com/software/integration/wbimessagebroker/library/books.html


Support

Defects: Throughout this readme file 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, go to the WebSphere Message Broker support Web site at:
http://www.ibm.com/software/integration/wbimessagebroker/support/

To find information, click Troubleshoot > View all Troubleshooting documents. 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.ibm.com/software/integration/wbimessagebroker/requirements/index.html


Feature updates

Check periodically for updates to the toolkit, including documentation updates in English and in other supported languages. Recommended fixes for WebSphere Message Broker can be found at:
http://www.ibm.com/support/docview.wss?uid=swg27006041

Details of what's new in Version 6.1, and information about new function added in Version 6.1 fix packs can be found at:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp?topic=/com.ibm.etools.mft.doc/ab00026_.htm


TOP

Restrictions and limitations

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


TOP

Installation


TOP

Platforms


TOP

Migration


TOP

WebSphere Message Broker Toolkit


TOP

Web Services


TOP

Nodes


TOP

WebSphere Adapter nodes


TOP

Databases


TOP

Samples


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, 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 CD or by downloading from the Web. Note, however, that fix packs might be large and therefore requesting CD versions will avoid lengthy downloads.
If you have a current support contract, you can order DB2 fix packs on CD 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 file
http://www.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