IBM WebSphere Message Broker Version 6.1 Readme

Product documentation


Abstract

This document contains the IBM WebSphere Message Broker Version 6.1 Readme.

Content

IBM WebSphere Message Broker Version 6.1 Fix Pack 6.1.0.12 Readme

Readme documentation for IBM WebSphere Message Broker for Version 6.1.0.12 (Fix Pack 12) of the tooling and runtime components.

Readme file for: IBM WebSphere Message Broker
Product/Component Release:
6.1
Update Name:
Fix Pack 12
Fix ID:

6.1.0-WS-MB-AIXPPC64-FP0012 - AIX on 64-bit Power PC architecture
6.1.0-WS-MB-HPUXPARISC64-FP0012 - HP-UX on 64-bit HP PA-RISC architecture
6.1.0-WS-MB-HPUXIA64-FP0012 - HP-UX on Itanium
6.1.0-WS-MB-SOLARISSPARC64-FP0012 - Solaris on Sun SPARC architecture
6.1.0-WS-MB-SOLARISX64-FP0012 - Solaris on Sun x86-64 architecture
6.1.0-WS-MB-LINUXIA32-FP0012 - Linux on 32-bit Intel architecture
6.1.0-WS-MB-LINUXX64-FP0012 - Linux on Intel x86 architecture
6.1.0-WS-MB-LINUXPPC64-FP0012 - Linux on i/p series architecture
6.1.0-WS-MB-LINUXZ64-FP0012 - Linux on z/series architecture
6.1.0-WS-MB-WINIA32-FP0012 - Windows on 32-bit Intel architecture
6.1.0-WS-MB-ZOS-FP0012 - z/OS

Publication date:
30 May 2008
Last modified date:
7 December 2013

Contents



Download location

Download WebSphere Message Broker Version 6.1 Fix Pack 6.1.0.11 from the following location:
http://www.ibm.com/support/docview.wss?uid=swg27006041

Installation information:

Always use the latest version of this readme file, which is available in English only at:
http://www.ibm.com/support/docview.wss?&uid=swg27006913

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

Prior to installation

For information about the tasks you must complete before you install the product, refer to the WebSphere Message Broker Installation Guide, available at:
http://publib.boulder.ibm.com/epubs/pdf/c3468662.pdf

Installing

If you are applying V6.1.0.11 (Fix Pack 11) 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

A WebSphere Message Broker fix pack can be installed on a UNIX, Linux, or Windows system only after a full version of WebSphere Message Broker has been installed. You must install the GA (General Availability) code to ensure that you comply with your license agreement. The full version of WebSphere Message Broker can be installed to any location on your system, and you are not required to install the fix pack to the same location. If you attempt to install the fix pack on a system that does not have a full version of WebSphere Message Broker installed, your installation fails with the following message:
The License Agreement could not be properly loaded.

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 data sets with the following attributes:

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 data sets:

/* 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)

//*
3. 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:

put PTF NUMBER.TRS 'YOUR HLQ.PTF NUMBER.TRS' (replace
4. Unpack the data sets using the TRSMAIN utility program. This utility is available at http://techsupport.services.ibm.com/390/trsmain.html.

You can use the following sample JCL to unpack the data sets 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,))

/*
5. 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 available at http://www.ibm.com/support/docview.wss?uid=swg21255570.



Documentation

The online information center for WebSphere Message Broker is available at:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp
Always refer to the online information center for the latest information.

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://public.dhe.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz (Linux version)
ftp://public.dhe.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/v61/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 website at:
http://www.ibm.com/software/integration/wbimessagebroker/support/

To find information, click the Troubleshoot tab. In the Problem resolution pane, click More results. Troubleshooting documents 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 website, see the Passport Advantage downloads for WebSphere Message Broker V6.1 download document, which is available at:
http://www.ibm.com/support/docview.wss?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
Additional information
Known problems and their workarounds (if any):

This section outlines the known problems and their workarounds (if any) of WebSphere Message Broker, by component.


TOP
Installation
  • Path length

When creating your installation path, ensure that the path length does not exceed the maximum character length for your system. (For example; Windows allows a maximum of 256 characters).
  • WebSphere Message Broker V6.1.0.3 (Fix Pack 3) or later supports WebSphere MQ V7.0

For installations on Microsoft Windows Vista or Microsoft Windows Server 2008, install a WebSphere MQ V7 fix pack that includes APAR number IC57915 to avoid the following issues:
  • Failures in brokers starting and stopping.
  • Failures for globally coordinated ('XA') transactions with WebSphere MQ and databases.
  • Windows C Runtime Libraries (Window CRT)

When performing a product installation using the WebSphere Message Broker Windows Launchpad, the Windows C runtime libraries (Windows CRT) installation is displayed as a mandatory prerequisite.

However, if you are applying service to upgrade an existing installation to Version 6.1.0.3 or later, you must install the Windows CRT separately to avoid the following issues:

  • XA coordination with WebSphere MQ Version 6 does not work because the broker switch .dll files cannot be loaded by the WebSphere MQ queue manager.
  • mqsi*.exe commands in the toolkit, such as mqsimigratemsgsets.exe, fail with errors such as: "This application has failed to install because MSVCR80.dll was not found. Reinstalling the application may fix this problem."
  • The PHPCompute node does not work.
  • Miscellaneous third-party applications that call broker .dll files might not work.

Solution:

Install the Windows CRT separately.

The English Windows CRT installer has been included in the broker bin directory. Navigate to your installation and double-click the vcredist_x86.exe file to compete the installation.

To download the Windows CRT in a different language, go to the Microsoft Visual C++ 2005 SP1 Redistributable Package (x86) download web page at:
http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647

  • Installations of WebSphere Message Broker Version 6.1.0.2 (Fix Pack 2) and below are not supported on Microsoft Windows Vista or Microsoft Windows Server 2008

Installations of WebSphere Message Broker Version 6.1.0.2 (Fix Pack 2) or below on Windows Vista or Windows Server 2008 do not work correctly and create unusual elements in the file system and registry which might require manual removal.

Solution:

Install WebSphere Message Broker Version 6.1.0.3 (Fix Pack 3) or later, which is supported on Windows Vista and Windows Server 2008.

  • Silent installation

This issue is resolved in Version 6.1.0.3 (Fix Pack 3).

If you choose to install runtime components silently, and you generate a template or record a response file, the examples in the Installation Guide, Chapter 7 "Choosing an installation interface" on page 79, are incorrect. To record a response file enter:

installer -options-record responsefile.

To generate a template, enter

installer -options-template responsefile.

The corresponding commands in table 13 on page 80 are also incorrect; you must not include a space between -options and -record or -template.

Solution:

Refer to the updated installation guide at:
http://publib.boulder.ibm.com/epubs/pdf/c3468662.pdf

  • Using the Windows extraction wizard to extract Message Broker 6.1 .zip files from the Passport Advantage website

When using the Windows extraction wizard to extract WebSphere Message Broker V6.1 compressed files downloaded from the Passport Advantage website, specifying a long directory path in which to extract the files might cause a password message to display.

If you extract a file into a directory with a long path, the path length might be too long for the Windows extraction wizard to process, and instead of receiving an error message, a window opens with a message prompting for a password. For example, "Password Needed File 'DB2CS_NewCLRProcWizard...' is password protected. Please enter the password in the box below". This message is erroneous and might be displayed for many files.

Solution:

Extract the file to a location with a short directory path, such as C:\temp\dbimage.

  • The Installshield wizard for Version 6.1.0.10 (Fix Pack 10) and later Fix Packs lists the version number as 6.1.1x instead of 6.1.0.1x

When installing WebSphere Message Broker V6.1 Fix Pack 10 and later Fix Packs, the version number is displayed as 6.1.1x instead of 6.1.0.1x.

Solution:

This issue is caused by a limitation in Install Shield Multi Platform (ISMP). You can safely ignore the version number that is displayed, and continue with your installation. After your installation is complete, the version number is correctly displayed as 6.1.0.1x in the WebSphere Message Broker runtime environment, and the output from the mqsiprofile and the mqsiservice -v commands correctly displays 6.1.0.1x.


TOP
Platforms
  • WebSphere Message Broker V6.1 on AIX V5.3

After deploying a message flow and starting a broker, you might see the following symptoms:
  • The execution group restarts
  • A core dump file is created
  • A zero length abend file is generated
  • The syslog contains the following error messages:

BIP2060W: The broker has detected that the Execution Group <insert_1>, process ID <insert_2>, has shutdown.

BIP2227E: Error encountered during abend processing: <insert_1> - terminating.

Additionally, the mqsistart command might not start the broker, and the syslog might contain the following error message:

BIP8893E: Verification failed. Unable to access file '/var/mqsi/components/AIX53_BK/bipcvp_javaversion.tmp' with user ID <insert_2>.

These problems can occur if the level of the AIX V5.3 file set bos.rte.libc is below 5.3.0.52.

Solution:

To overcome this issue, upgrade the bos.rte.libc file set to a minimum level of 5.3.0.52. Version 5.3.0.52 is available in AIX version 5.3 TL05 SP2.

  • AIX xlC.rte file set is upgraded to level 9.0.0.1 automatically when AIX is upgraded to V5.3 TL7 or TL8

Upgrading AIX to V5.3 TL7 or TL8 also upgrades the xlC.rte file set to V9.0.0.1, causing the following symptoms when starting the AIX server, starting WebSphere MQ, deploying a message flow, or starting a broker:

BIP2623E: Unable to open queue <insert_2> on WebSphere MQ queue manager <insert_1>: completion code <insert_3>; reason code <insert_4>

BIP2604E: Node failed to open WebSphere MQ queue <insert_2> owned by queue manager <insert_1>: completion code <insert_3>; reason code <insert_4>

MQRC=2018: 2018 0x000007e2 MQRC_HCONN_ERROR

These problems can occur if the xlC.rte file set version is above V9, but below 9.0.0.3.

Solution:

To overcome this issue, upgrade the xlC.rte file set version to 9.0.0.3. For further information, and for a link to the PTF download that contains the AIX package with the xlC.rte.9.0.0.3 file set, see the WebSphere Message Broker customer support website technote at:
http://www.ibm.com/support/docview.wss?uid=swg21300071

  • Red Hat Enterprise Linux with Security-Enhanced Linux (SELinux) enabled is not supported

The tooling and runtime components of WebSphere Message Broker do not support Red Hat Enterprise Linux with Security-Enhanced Linux (SELinux) enabled.


TOP
Migration
  • Migration on Linux and UNIX

When you migrate a runtime component from either Version 5.0 or Version 6.0 to Version 6.1 on the same computer, open a new shell before you run mqsiprofile to set up your command environment.
  • Migration on z/OS

Migration for z/OS requires IC54505. IC54505 is included in Version 6.1.0.2 (Fix Pack 2).
  • General migration information section of information center topic ah20250_

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.


TOP
WebSphere Message Broker Toolkit
  • Defect 49194 Toolkit fails to start

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 now starts successfully.

  • Defect 49193 Installing plug-ins using the Eclipse Update Manager

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).
  • Ensure that you save a backup copy of your platform.xml file before you add any non-IBM plug-ins using the Eclipse Update Manager.
  • Do not delete the platform.xml file as a way of allowing Eclipse to regenerate the file.
  • Ensure that you save the platform.xml file before you make changes to the configuration. (For example; by using the Eclipse Update Manager.
  • When you are using the Eclipse Update Manager, do not specify the shared resource directory as the destination, but specify the package group directory instead.
  • Do not use the Eclipse Update Manager to search for updates for features that were originally installed using the IBM Installation Manager.
  • Defect 49195 Startup panel

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.
  • Defect 51112 Cleanup or format WSDL or XSD files

Formatting a WSDL or XSD file a certain way might cause problems in the resulting project after importing.

Symptoms:
1. One or more elements in the original WSDL or XSD file are missing from the message definition file that is created when the WSDL or XSD file is imported, resulting in runtime validation errors.
2. At development time, errors display when a 'Deployable WSDL' resource validates. Error example; "A Message Set cannot contain two global element declarations with the same name and namespace (target or chameleon)".

Solution:

If you encounter any unexpected results after importing WSDL or Schema resources into a message set, cleanup or format the file. Complete the following steps to cleanup or format the file:
1. Copy the WSDL or XSD file into the workspace. Do not import the file into the workspace.
2. Open the WSDL or XSD file in the editor, and click Format > Document which is located under the Source option in the workbench main menu, or alternatively, click Cleanup Document.
3. Save the modified file.
4. Import the modified file.

The file now imports successfully.

  • Defect 70284 Start/Stop Help menu items missing

On Windows, the "Start Help" and "Stop Help" menu items in the Start > Program Files are missing.
  • Defect 67266 WSDL file with incorrect encoding gives spurious errors import

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).
  • Defect 72964 Circular project dependency errors display when new or imported projects reference each other

If two new or imported projects reference each other, a circular project dependency error displays.

Solution:

To resolve the problem, perform either of the following options:

  • Manually remove project references by right-clicking the project name in the Broker Development view and selecting the Properties menu item. Select Project References from the Properties window, and a list of all regular projects in the workspace is displayed from which you can clear project references.
  • From V6.1.0.2 Interim Fix 001, click Preferences > Broker Development > Project Dependency Validation and disable the circular dependency validation.


TOP
Web Services
  • Windows .NET Server Web Services Security X509

This issue is resolved in Version 6.1.0.2 (Fix Pack 2).

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.

  • Message Transmission Optimization Mechanism support restriction

The use of Message Transmission Optimization Mechanism (MTOM) attachments greater than 16 KB in size is not supported.


TOP
Nodes
  • Collector node

The Collector node can cause abends which are resolved in IC54505. IC54505 is included in Version 6.1.0.2 (Fix Pack 2).
  • TCP/IP nodes TCPIPClientInput, TCPIPServerInput, TCPIPClientReceive, and TCPIPServerReceive

This issue is resolved in Version 6.1.0.3 (Fix Pack 3).

When using the XMLNSC parser to determine the end of a message in the TCP/IP input and receive nodes, the XMLNSC parser finds the end of the message only if the next XML document appears on the bit stream, or if the end of bit stream is seen by the XMLNSC parser. If neither of these occur, a timeout exception is displayed.

To overcome this, set the Record detection property to Delimited, and add a null character to the bit stream.

  • TCP/IP nodes on Solaris x86-64

The TCP/IP nodes on Solaris x86-64 do not process data and might refuse connections. If you experience these problems, set rlim_fd_max and rlim_fd_cur to 8193 or lower.
  • JMS nodes on z/OS

The JMS nodes on z/OS do not support the coordinated transactions until IC54505. IC54505 is included in Version 6.1.0.2 (Fix Pack 2).
  • Using WebSphere Message Broker Version 6.1.0.1 (Fix Pack 1) EndpointLookup and RegistryLookup nodes to access WebSphere Service Registry and Repository (WSRR) V6.1

WebSphere Message Broker Version 6.1.0.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.0.2 or version 6.1. However new functionality introduced in WSRR Version 6.1, such as referencing MQ Endpoints within WSDL and accessing modeled objects and elements, is not currently supported.
  • Using WebSphere Message Broker Version 6.1.0.2 (Fix Pack 2) or later EndpointLookup and RegistryLookup nodes

WebSphere Service Registry and Repository (WSRR) version 6.1 or later, is supported. Previous versions of WSRR are not supported.


TOP
WebSphere Adapter nodes
  • WebSphere MQ link for SAP R/3 support

Migrating from WebSphere MQ link for SAP R/3 to WebSphere Message Broker V6.1 requires IC54505. IC54505 is included in Version 6.1.0.2 (Fix Pack 2).


TOP
Databases
  • Sybase globally coordinated ('XA') transactions

Globally coordinated ('XA') transactions are not supported.
  • Oracle globally coordinated ('XA') transactions

Oracle globally coordinated ('XA') transactions are not supported on Windows with Oracle 11g clients.

Oracle globally coordinated ('XA') transactions are not supported with Oracle RAC data sources. This issue is resolved in Version 6.1.0.6 (Fix Pack 6).

  • Oracle RAC failover

Oracle RAC failover is supported for ODBC connections in both non-XA and XA environments. Support is limited to the connect-time failover feature of Oracle RAC, with supported Oracle versions from 10.2.0.4 and above. WebSphere Message Broker V6.1.0.6 or later is required for Oracle RAC connect-time failover in XA environments.
  • JDBC/XA globally coordinated ('XA') transactions

JDBC/XA globally coordinated ('XA') transactions are supported on DB2 and Oracle (except Oracle RAC) on all broker platforms except HP-UX on Itanium and z/OS.

ODBC XA and JDBC/XA cannot be mixed on the same broker.

  • Informix globally coordinated ('XA') transactions

Informix globally coordinated ('XA') transactions are not supported.
  • Informix stored procedures

Informix stored procedures are supported from V6.1.0.4 (Fix Pack 4) when using the version of the Informix Client listed in the V6.1 detailed system requirements for your platform at:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

For restrictions that apply to Informix stored procedures and further documentation see the WebSphere Message Broker information center topic “CREATE PROCEDURE statement” at:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/topic/com.ibm.etools.mft.doc/ak04970_.htm

  • Calling a DB2 V9 stored procedure that has parameters of type 'REAL' fails when executed against a DB2 database on z/OS

If a DB2 Version 9 stored procedure that has parameters of type 'REAL' is executed against a DB2 database which is on a z/OS system, the call fails with DB2 error "CLI0111E Numeric value out of range. SQLSTATE=22003".

Solution:

Install the following minimum versions of DB2:

For DB2 V9.1: Fix Pack 6 with APAR IZ23102.

For DB2 V9.5: Fix Pack 2 with APAR IZ23103.

  • Upgrade of DataDirect ODBC drivers

The DataDirect ODBC drivers supplied with WebSphere Message Broker, and the corresponding sample ODBC .ini files, were updated for all platforms except HP-UX on PA-RISC at Version 6.1.0.2 (Fix Pack 2), and for HP-UX on PA-RISC at Version 6.1.0.3 (Fix Pack 3).

If your current installation is at Version 6.1.0.0 or Version 6.1.0.1 (Fix Pack 1), you must make additional changes to your ODBC connections when you apply Version 6.1.0.2 (Fix Pack 2) or later.

See topic ah01589_ "Applying service to runtime components" for details of how to apply this fix pack at:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/topic/com.ibm.etools.mft.doc/ah01589_.htm

The instructions include links to topics for Linux and UNIX (ah01652_) and for Windows (ah01653_) that describe the ODBC changes that you must make.

  • The manipulation of UNICODE data in databases

The manipulation of UNICODE data in databases is supported from Version 6.1.0.3 (Fix Pack 3).

For a description of this support see the WebSphere Message Broker information center topic "Support for UNICODE and DBCS data in databases" at:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/topic/com.ibm.etools.mft.doc/ac00407_.htm

If you have a DB2 Version 8.1 or 9.1 database on z/OS you must install the fix for DB2 APAR PK74344 or you might see Character Large Object (CLOB) data corruptions, or SQL error messages when using the SELECT function, such as a return of SQLSTATE 01004.

  • Configuring databases on HP-UX on PA-RISC with WebSphere Message Broker Version 6.1.0.2 (Fix Pack 2) or below

If you have installed WebSphere Message Broker Version 6.1.0.2 (Fix Pack 2) or below on HP-UX on PA-RISC, you must use the DataDirect Connect (or DataDirect Connect64) for ODBC Drivers (DD) V5.0 to set up ODBC connections to databases. The information center topics refer to DD V5.3, which is not supported on this platform.

Before you start to configure an ODBC connection for a broker database or a user database, read the technote “Configuring database ODBC connections for WebSphere Message Broker V6.1 on HP-UX (PA-RISC platform)” at:

This document provides detailed information about how to define connections and configure global coordination of transactions using the DD V5.0 drivers. No other platforms are affected by this change.

  • ODBC trace settings

This issue is resolved in Version 6.1.0.6 (Fix Pack 6).

Linux and UNIX ODBC trace is enabled using the Trace setting in the [ODBC] stanza of the $ODBCINI32, or the $ODBCINI file. To turn on ODBC trace, set Trace to 1, for example Trace=1. The DataDirect V5.3 ODBC drivers support an additional setting called TraceOptions. TraceOptions can be set to the value 3 for additional trace detail, including time stamp information.

Information center topics ah14449_, ah14452_, ah25530_, and ah14444_ refer to setting the TraceOptions value to 3, however TraceOptions=3 causes ODBC trace to be active regardless of the Trace setting. Therefore this option has not been included in the sample 32–bit ODBC definition file (odbc32.ini), or the sample 64–bit ODBC definition file (odbc64.ini) that are supplied with WebSphere Message Broker.

Solution:

When you have finished collecting trace, edit the $ODBCINI32 or $ODBCINI file and either remove the line TraceOptions=3, or comment it out; for example ;#TraceOptions=3.

  • Migrating a broker that uses a Sybase database as a broker database

If you have previously created a broker that uses a Sybase database as the broker database, and you want to upgrade to Message Broker Version 6.1.0.2 (Fix Pack 2), the broker and the broker database might encounter problems when you start the broker.

To overcome this, run the following commands after migration, and before you start the broker.
1. At a command prompt enter the following command:

isql -Umqsiuid -Pmqsipw

If you have authorized another user ID and password for broker access to the database, substitute your values for mqsiuid and mqsipw in that command.
2. Connect to the broker database with this command:

use WBRKBKDB

If you have created your broker database with a different name, substitute your broker database name for WBRKBKDB in that command.
3. Apply the change with this command:

go
4. Update the BROKERAA table with the following commands:

alter table BROKERAA

modify MsgId NOT NULL

modify ReplyToQ NOT NULL
5. Apply the change with this command:

go
6. Update the BROKERAAEG table with the following commands:

alter table BROKERAAEG

modify MsgId NOT NULL

modify CntlMsgId NOT NULL
7. Apply the change with this command:

go
8. Update the BSUBSCRIPTIONS table with the following commands:

alter table BSUBSCRIPTIONS

modify Expiration NOT NULL

modify Creation NOT NULL
9. Apply the change with this command:

go
10. Update the BMQPSTOPOLOGY table with the following commands:

alter table BMQPSTOPOLOGY

modify Migrated NOT NULL
11. Apply the change with this command:

go
12. Update the BACLENTRIES table with the following commands:

alter table BACLENTRIES

modify QopLevel NOT NULL
13. Apply the change with this command:

go
14. Update the BMULTICASTTOPICS table with the following commands:

alter table BMULTICASTTOPICS

modify GroupAddress NOT NULL
15. Apply the change with this command:

go
16. Update the BAGGREGATE table with the following commands:

alter table BAGGREGATE

modify ReplyGroupId NOT NULL
17. Apply the change with this command:

go


TOP
Samples
  • Error Handler Sample

The sample is not supported until IC54505. IC54505 is included in Version 6.1.0.2 (Fix Pack 2).
  • Collector Sample

The sample is not supported until IC54505. IC54505 is included in Version 6.1.0.2 (Fix Pack 2).


TOP
List of fixes

Fixes included in WebSphere Message Broker V6.1.0.11:


http://www.ibm.com/support/docview.wss?uid=swg27015978


TOP
Copyright and trademark information


http://www.ibm.com/legal/copytrade.shtml

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:

  • IBM Director of Licensing
  • IBM Corporation
  • North Castle Drive
  • Armonk, NY 10504-1785
  • U.S.A.

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:
  • Intellectual Property Licensing
  • Legal and Intellectual Property Law
  • IBM Japan, Ltd.
  • 19-21, Nihonbashi-Hakozakicho, Chuo-ku
  • Tokyo 103-8510, 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 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 websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites 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 United Kingdom Laboratories,
  • Mail Point 151,
  • Hursley Park,
  • Winchester,
  • Hampshire,
  • England
  • SO21 2JN

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 and logos are trademarks or registered trademarks of Oracle and/or its affiliates 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 websites

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 website.

WebSphere MQ fix packs
http://www.ibm.com/software/integration/wmq/support/

WebSphere Message Broker fix packs
http://www.ibm.com/support/docview.wss?uid=swg27006041

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

WebSphere Message Broker readme file
http://www.ibm.com/support/docview.wss?&uid=swg27006913

WebSphere Message Broker Stand-alone Information Center
For Linux:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz
For Windows:
ftp://public.dhe.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



TOP
Document change history
  • Product electronic availability: 22 November 2007
  • Product physical availability: 14 December 2007
  • Version 6.1.0.2 (Fix Pack 2): 30 May 2008
  • Version 6.1.0.3 (Fix Pack 3): 28 November 2008
  • Version 6.1.0.4 (Fix Pack 4): 22 May 2009
  • Version 6.1.0.5 (Fix Pack 5): 11 September 2009
  • Web update for this readme file: 11 September 2009
  • Version 6.1.0.6 (Fix Pack 6): 8 February 2010
  • Version 6.1.0.7 (Fix Pack 7): 26 March 2010
  • Version 6.1.0.8 (Fix Pack 8): 30 July 2010
  • Version 6.1.0.9 (Fix Pack 9): 04 March 2011
  • Version 6.1.0.10 (Fix Pack 10): 29 November 2011
  • Version 6.1.0.11 (Fix Pack 11): 18 December 2012
  • Version 6.1.0.12 (Fix Pack 12): 12 December 2013
(C) Copyright IBM Corporation 2012. All rights reserved.

Copyright date

2009

Cross reference information
Segment Product Component Platform Version Edition
Business Integration WebSphere Message Broker with Rules and Formatter Extension AIX, HP-UX, Linux, Linux zSeries, Solaris, Windows, z/OS 6.1

Product Alias/Synonym

WMB MB WebSphere Message Broker MQ Integrator WBIMB WBI-MB MQSI WMQI

Rate this page:

(0 users)Average rating

Document information


More support for:

WebSphere Message Broker
Documentation

Software version:

6.1

Operating system(s):

AIX, HP-UX, Linux, Linux SUSE - zSeries, Solaris, Windows, z/OS

Reference #:

7011222

Modified date:

2012-12-18

Translate my page

Machine Translation

Content navigation