Product readme for Websphere MQ fix pack 7.0.1.12

Product readme


Abstract

This document contains the WebSphere MQ readme for fix pack 7.0.1.12

The English language version of this document is the most up to date version.

Content

DESCRIPTION

-----------
This file describes the following:

1. Limitations, known problems and other changes.

2. How to obtain and install WebSphere MQ version 7.0.1.12 as a fix pack.

3. IBM Message Service Client for .NET V2.0.0.12

4. Notices and trademarks


The latest version of the product license file can be found at:
http://www.ibm.com/support/docview.wss?uid=swg27006097

In addition to this file, you can find more information about the product license on the WebSphere MQ Web
site: http://www.ibm.com/software/integration/wmq/

The SupportPac Web page is at:
http://www.ibm.com/support/docview.wss?uid=swg27007205

For current information about known problems and available fixes, see the Support
page of the WebSphere MQ Web site at:
http://www.ibm.com/software/integration/wmq/support/

Web documentation updates
The latest updates to the Web-based WebSphere MQ documentation are available from
the WebSphere MQ Web site at:
http://www.ibm.com/software/integration/wmq/library/

Announcement letter
The announcement letter for WebSphere MQ Version 7.0 (US English) is available at:
http://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=an&subtype=ca&appname=GPA&htmlfid=897/ENUS208-068
(for distributed platforms), or
http://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=an&subtype=ca&appname=GPA&htmlfid=897/ENUS208-067
(WebSphere MQ for z/OS ).

See the announcement letter for the following types of information:
- Detailed product description, including description of new function
- Product-positioning statement
- Ordering details
- Hardware and software requirements

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

UPDATE HISTORY
14 Mar 2014 - updates for WebSphere MQ version 7.0.1.12
20 Aug 2013 - updates for WebSphere MQ version 7.0.1.11
17 Dec 2012 - updates for WebSphere MQ version 7.0.1.10
06 Jul 2012 - updates for WebSphere MQ version 7.0.1.9
13 Jan 2012 - updates for WebSphere MQ version 7.0.1.8
03 Oct 2011 - updates for WebSphere MQ version 7.0.1.7
03 Jun 2011 - updates for WebSphere MQ version 7.0.1.6
03 Feb 2011 - updates for WebSphere MQ version 7.0.1.5
01 Oct 2010 - updates for WebSphere MQ version 7.0.1.4
12 Aug 2010 - updates for WebSphere MQ version 7.0.1.3
28 Jan 2010 - Updates for WebSphere MQ version 7.0.1.2
20 Nov 2009 - Updates for WebSphere MQ version 7.0.1.1
16 July 2009 - Updates for WebSphere MQ version 7.0.1.0



++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ ++
++ Section 1 : Limitations, known problems and other changes ++
++ ++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
7.0.1.12


7.0.1.11 The Introduction section of the EGA.readme.mbr file shipped with
WebSphere MQ 7.0.1 iSeries base code contains an outdated reference to the Quick
Beginnings book being available from the download site
---------------------------------------------------------------------
"Introduction
These instructions apply to installing WebSphere MQ for i5/OS
Version 7.0.1 from an installation image downloaded from IBM.
Use it with the WebSphere MQ for i5/OS Quick Beginnings manual
for this release. A version of the Quick Beginnings book is
available from the download site, it has a description of
'WebSphere MQ V7.0 Install Doc'."

This document is no longer available on the Passport Advantage
site. The information is now available online in the WebSphere MQ
version 7 Information Center in the 'Quick Beginnings for i5/OS' section:
http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqwac.doc/iq10120_.htm


7.0.1.10 APAR IV31952
-----------------------------
The fix for APAR IV31952 changed the authority checks that WebSphere MQ makes on channel objects when you run the RESET CHANNEL command. Applying this fix can give changed behavior and you might need to alter some authorities.

Your systems are affected only if your channels run with an MCAUSER userID resolving to a non-mqm user. The Reset Channel command can run internally within WebSphere MQ code, so, even though you have not run the Reset Channel command manually, your system might still be affected.

Ensure that, at a minimum, your channel's MCAUSER userID has both +DSP and +CTRLX authority on the channel object, so that the userID can run Reset Channel commands. Before the fix for IV31952, WebSphere MQ checked that the userID had +ALTUSR authority which you might previously have granted to make your channel work.

After applying fix pack WebSphere MQ fix pack 7.0.1.10 or later, you can remove your MCAUSER's +ALTUSR authority on the channel object because it is not required for the Reset Channel command. You should also check that your MCAUSER userID has +DSP and +CTRLX authority on the channel object.


7.0.1.7 Installing a v7.0.1 fix pack on HP-UX
when a v7.1 installation exists
------------------------------------------------------------------
When an attempt to upgrade 7.0.1.6 to 7.0.1.7 on HP-UX is made on a
machine that also has a WeSphere MQ v7.1 installation, the fix Pack
installation log may contain the following errors repeated a number
of times. However, this does not prevent the fix pack from installing
successfully.

rm: MQSERIES.MQM-RUNTIME: non-existent
ERROR: You have specified more than one fileset selection. You must
specify only a single fileset when performing file or control
file modifications.

7.0.1.7 Removing a v7.0.1 fix pack from a Linux
while a v7.1 queue manager is running
------------------------------------------------------------------
On Linux (all architectures), the removal of a v7.0.1 fix pack which
would leave the installed version of v7.0.1 at an earlier version than
v7.0.1.6, may partially fail if there is a v7.1 queue manager running
on the system at the time. The error messages output from the 'rpm'
command have the following form:


ERROR: WebSphere MQ shared resources for this installation are still in use.
Please ensure no WebSphere MQ processes are running
before removing this maintenance package
error: %preun(MQSeriesJRE-U844092-7.0.1-7.s390x) scriptlet failed, exit status 1


For example, on a system where the following installation order has been used:

(1) Install a fresh installation of WebSphere MQ at the v7.0.1.3 level
(2) Install the WebSphere MQ v7.0.1.7 fix pack
(3) Install WebSphere MQ v7.1.0.0
(4) Create and start a v7.1 queue manager
(5) Uninstall the WebSphere MQ v7.0.1.7 fix pack

To avoid this issue, either:

(a) Ensure that all queue managers on the system are in the stopped
state before removing the fix pack

(b) Ensure that the 'MQSeriesRuntime' rpm package is the
last package to be removed from the fix pack uninstallation.

The rpm syntax varies by rpm version - you may need to consult your
Operating System vendor in order to determine this information for your
system. For Red Hat Enterprise Linux Server 5.7, which uses rpm version
4.4.2.3, the removal order is the reverse of that specified on the
command line. Therefore specifying the 'MQSeriesRuntime' first in the
removal list will allow the fix pack to be removed.

For example, to successfully remove a complete v7.0.1.7 fix pack while
a v7.1.0.0 queue manager is running on Red Hat Enterprise Linux Server 5.7,
the following command syntax should be used:

rpm -e MQSeriesRuntime-U844091-7.0.1-7 MQSeriesConfig-U844091-7.0.1-7
MQSeriesMsg_es-U844091-7.0.1-7 MQSeriesMsg_ru-U844091-7.0.1-7
MQSeriesMan-U844091-7.0.1-7 MQSeriesMsg_ko-U844091-7.0.1-7
MQSeriesServer-U844091-7.0.1-7 MQSeriesJava-U844091-7.0.1-
MQSeriesMsg_cs-U844091-7.0.1-7 MQSeriesMsg_hu-U844091-7.0.1-7
MQSeriesMsg_pl-U844091-7.0.1-7 MQSeriesMsg_Zh_TW-U844091-7.0.1-7
MQSeriesTXClient-U844091-7.0.1-7 MQSeriesClient-U844091-7.0.1-7
MQSeriesJRE-U844091-7.0.1-7 MQSeriesMsg_de-U844091-7.0.1-7
MQSeriesMsg_it-U844091-7.0.1-7 MQSeriesMsg_pt-U844091-7.0.1-7
MQSeriesSamples-U844091-7.0.1-7 MQSeriesKeyMan-U844091-7.0.1-7
MQSeriesMsg_ja-U844091-7.0.1-7 MQSeriesSDK-U844091-7.0.1-7
MQSeriesFTA-U844091-7.0.1-7 MQSeriesMsg_fr-U844091-7.0.1-7
MQSeriesMsg_Zh_CN-U844091-7.0.1-7

If you do encounter this issue, then you must stop all WebSphere MQ
queue managers on the system to complete removal of the v7.0 fix pack,
by removing the remaining rpm packages associated with the fix pack
which were not removed with the first removal attempt.

7.0.1.7 Changes to DEFXMITQ attribute of the queue manager object
------------------------------------------------------------------
Additional checks have been introduced in WebSphere MQ fix pack 7.0.1.7
to disallow setting the value "SYSTEM.CLUSTER.TRANSMIT.QUEUE" for the
DEFXMITQ attribute for the queue manager object.A new reason code
"MQRCCF_DEF_XMIT_Q_CLUS_ERROR" (number 3269) has been created to
describe a failed attempt to set the DEFXMITQ attribute of the
queue manager object to "SYSTEM.CLUSTER.TRANSMIT.QUEUE".

Additionally, to prevent problems if DEFXMITQ has been incorrectly
set to SYSTEM.CLUSTER.TRANSMIT.QUEUE in the past, a new validity
check has been added to prevent an MQOPEN or MQPUT1 call from
using this incorrect mechanism. The reason code on failure will
be an existing code "MQRC_DEF_XMIT_Q_USAGE_ERROR" (number 2199).

7.0.1.6 Changes to the default behaviour of MQPUT1 API with MQPMO_SYNCPOINT
when used in a client application
--------------------------------------------------------------------------
The default behaviour of MQPUT1 with MQPMO_SYNCPOINT has been changed
in WebSphere MQ 7.0.1.6, to put the message synchronously so that MQMD
and MQOD output fields are populated during the MQPUT1 call.

The default behaviour can be changed by setting the client configuration
file attribute Put1AsyncPut in the Channels stanza.

Valid values for Put1AsyncPut are:
(a) no : Put is always synchronous. This is the default.
(b) yes : Put is always asynchronous.
(c) syncpoint : Put is asynchronous if MQPMO_SYNCPOINT is set
and synchronous otherwise.

The new attribute Put1AsyncPut does not replace Put1DefaultAlwaysSync.
If there is a need to change the default back to the pre-7.0.1.6
default, the client configuration file attribute Put1AsyncPut
must be set to "syncpoint".


7.0.1.5 Improved handling of WebSphere MQ running on
HP-UX 11i V3 (Itanium hardware)
----------------------------------------------------
This item affects only users on HP-UX 11i V3 (Itanium hardware) where
the system hostname is longer than 8 characters.

Before 7.0.1.5, WebSphere MQ obtained the hostname by calling a system
call, uname(). On HP-UX 11i V3 (Itanium hardware), the uname() call
can fail if the hostname is greater than 8 characters.

During the install processing and also during normal queue manager
processing, the failed uname() call could then cause the WebSphere MQ
code to fail to operate correctly. Directories under /var/mqm that
contain the hostname can then incorrectly be created with the name
"Unknown" instead of the hostname.

APAR IZ87770 addresses the problem by using the gethostname() system
call instead. After installing 7.0.1.5 or higher fix packs, please
manually remove the directories incorrectly named "Unknown".

Specifically the directories named "Unknown" will be under these
locations:
- /var/mqm/ipc
- /var/mqm/sockets
- /var/mqm/qmgrs/<qmgrname>/@app
- /var/mqm/qmgrs/<qmgrname>/@qmgr

Do NOT delete any other directories, for example those that hold
message data under /var/mqm/qmgrs/<qmgrname>/queues.

More information about this APAR can be found at:

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


7.0.1.5 Improvement to the way in which trigger monitor
sends information to the triggered application
-------------------------------------------------------
APAR IC72003 improves the way in which the trigger monitor sends
information to the triggered application.

Percent/dollar characters are now escaped by double quotes (Windows)
or a backslash (UNIX).

This change causes the expansion of environment variables by
the operating system to be suppressed for the data inside the
MQTMC2 structure that is passed as a parameter to the triggered
application.

For example, if the APPLICID field of a process was defined to
be "java cp %CLASSPATH% TriggerApp", then on Windows this will
be changed to "java cp "%"CLASSPATH"%" TriggerApp" when
constructing the MQTMC2.

In this example, the application will receive "java cp %CLASSPATH%
TriggerApp" as an input parameter. From 7.0.1.5, applications
will no longer receive an expanded version of environment variables
inside the MQTMC2 structure. Instead they must use alternative
means of expanding the environment variables if their content
is important.

7.0.1.5 Changes to the usage of MQGMO_CONVERT
in WebSphere MQ v7.0 classes for JMS
---------------------------------------------
APAR IC72897 changes the way in which WebSphere MQ V7.0 classes
for JMS request messages from the queue manager.

Prior to 7.0.1.5, the WebSphere MQ V7.0 classes for JMS requested
messages from the queue manager using the WebSphere MQ API option
MQGMO_CONVERT. This option requests that the queue manager
performs message data conversion before sending the message to
the receiving JMS application.

The WebSphere MQ V6.0 classes for JMS did not use this option.
This change of JMS client behaviour can affect JMS applications
when migrating from V6.0 to V7.0.

The code change associated with this APAR reverts the default
action of the V7.0 classes to the V6.0 behaviour. So, once
fix pack 7.0.1.5 or higher is installed, WebSphere MQ V7.0 classes
for JMS applications will no longer use MQGMO_CONVERT, resulting
in the queue manager performing no message data conversion when
messages are requested.

New properties have also been added as part of this APAR,
to allow the application to choose whether queue manager data
conversion is requested or not. These properties can be
configured either programmatically using the setter method on the
com.ibm.mq.jms.MQDestination class, administratively via a property
to be set in the JNDI namespace for the destination, or as a system
wide environment variable within the JVM using the property
"com.ibm.msg.client.wmq.receiveConversionCCSID".

A full description of this APAR, including how to use the new
properties, and the settings to use to retain the behaviour of the V7.0
classes prior to this fix pack, is available at:

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


7.0.1.4 Behaviour of the UNCOM output field for DISPLAY QSTATUS
---------------------------------------------------------------
APAR IZ76189 has changed the behaviour of the DISPLAY QSTATUS command
in runmqsc so that the behaviour of UNCOM now matches the description
under the runmqsc Information Center pages.

The runmqsc interface will now display the number of uncommitted
messages rather than simply YES or NO.

You can now use UNCOM in a filter: for example, WHERE(UNCOM LT 10).

It may be necessary to modify your scripts that contain DISPLAY QSTATUS
commands to runmqsc, if they rely on this value being YES or NO.


7.0.1.4 Improvement to dead-letter handling within the
WebSphere MQ v7 classes for JMS.
------------------------------------------------------
APAR IZ78515 has changed the default behavior for dead-letter handling
within the WebSphere MQ v7 classes for JMS.

When using the WebSphere MQ v7 classes for Java Message Service (JMS)
before version 7.0.1.4, poison messages that cannot be sent to the
named backout queue were converted to type JMSBytesMessage before being
sent to the queue manager's dead-letter queue (for example,
SYSTEM.DEAD.LETTER.QUEUE).

This had been a change in behavior from WebSphere MQ v6. In v6, the
JMS classes put the messages to the dead-letter-queue in their original
format, without converting them to type JMSBytesMessage.

APAR IZ78515 changes the behavior so that poison messages are now put
to the dead-letter queue without doing any conversion. This is the
correct behavior for this function, and matches WebSphere MQ v6.

7.0.1.4 New information in WebSphere MQ Explorer : some non-English
text missing.
-------------------------------------------------------------------
Some of the newest text (added in 7.0.1.4) is missing from non-English
versions of the WebSphere MQ Explorer.

(a) The MQ Explorer authorization functionality now contains a new
panel which allows you to "Add Role Based Authorities". There are two
"More Information" links on this screen. At V7.0.1.4, the lower of the
two links doesn't give any information unless you are running the MQ
Explorer in English.

(b) A number of items of recently introduced SSL/TLS functionality have
been added into the MQ Explorer at version 7.0.1.4. These items relate
to channel and queue manager configuration. Specifically, they allow:
- Configuration of SHA-2 CipherSpecs from the MQ Explorer.
- Specification of an HTTP Proxy Server for OCSP use.
- Configurable change to the way certificates are validated which is
useful to a small number of users.
When running the MQ Explorer in English the information in these panels
has been updated to reflect the new SSL/TLS values; in other languages
some of this new information is not displayed, though the main panels
themselves are properly translated.

7.0.1.0+ 64-bit GSKit 7 not updated with MQ fix pack install on Windows
-----------------------------------------------------------------------
Due to a known limitation in the install code, the 64-bit version of
GSKit 7 on Windows is not upgraded when these WebSphere MQ fix packs
are installed.

This means that 64-bit MQ client applications using SSL/TLS connections
on Windows are not running at the latest GSKit fix level.

HOWEVER, the 32-bit GSKit 7 installation WILL be upgraded when the fix
pack is installed. This means that queue managers, server-side
channels and 32-bit SSL/TLS client applications will still be able to
use the newer GSKit fix levels when WebSphere MQ maintenance is applied.

Java and JMS clients do not use GSKit for their SSL/TLS functionality,
and so are therefore unaffected by this issue.

7.0.1.3+ Clients using JMS connecting to 7.0.1.2 Servers
--------------------------------------------------------
If upgrading to 7.0.1.3 or a more recent fix pack on an installation
where WebSphere MQ classes for Java Message Service (JMS) are in use,
please read the following.

When using the WebSphere MQ classes for Java Message Service (JMS)
from WebSphere MQ 7.0.1.3 or higher, to connect to WebSphere MQ 7.0.1.2
queue managers, there can be a problem when stopping the
SVRCONN channel instance.

For example, you type:

STOP CHANNEL(MY.SVRCONN.CHANNEL)

Stopping a channel being used by the Java application can result in the
channel status remaining in a STOPPING state. When the channel is restarted,
the channel status moves to STARTED and another channel instance is created.

This issue has been resolved by APAR IZ77323, fixed in WebSphere MQ 7.0.1.3.
Therefore it is advisable to upgrade the server installation of WebSphere MQ
to 7.0.1.3 or higher before the clients that connect to it, if your clients
are using JMS.

Additional error cases now found by Explorer security tests
-----------------------------------------------------------
After you install 7.0.1.3 or a more recent fix pack, if you run
the Explorer Default Tests you will probably get error messages in
the Test Results, even if your results were error-free previously.
This is because the Default Tests now test aspects of your configuration
which were not previously tested.

The most common errors arise because your inbound system and default channels
(ones with names starting with "SYSTEM") have not been adequately protected
against unwanted access.

Another common cause of new errors is that your SSL/TLS system files allow
unnecessarily high levels of access. You can reconfigure your system to
remove error Test Results, and, where appropriate, warning Test Results.
Advice on how to do this is given in the "Further Information" associated with
the Test Result.

You may wish to use the same SSL/TLS system files to hold both client and queue
manager keys and certificates. However, this is an insecure configuration and
is discouraged. In general the access control/permission required for such a
configuration are incompatible with the new SSL/TLS system file test. If you
persist with sharing SSL/TLS system files between the client and queue manager,
but want error-free Explorer Test Results, you can configure your own set of
standard tests using the Explorer "Run Custom Test Configuration..." facility.

Information relating to maintaining multi-instance queue managers
-----------------------------------------------------------------
Guidance can be found here for applying fix packs where multi-instance queue
managers are in use:

http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/cr00060_.htm

In general, a multi-instance queue manager can have instances running at a
mixture of 7.0.x.y and 7.0.a.b. Exceptions to this are listed below. Other
than these exceptions, it is the general rule that the standby instance can
be on an installation at a newer or older fix pack level than the active
instance. This enables upgrading or rolling back of maintenance with the
minimum of down time.

The following is the list of exceptions:

Windows: 7.0.1.0 and >= 7.0.1.0 cannot be used in combination.

i5/OS: 7.0.1.0 did not support multi-instance queue managers so cannot
be used for the standy or active instance.


Migration from WebSphere MQ Version 6.0.2.3 or earlier on Windows
-----------------------------------------------------------------
When you migrate from WebSphere MQ Version 6.0.2.3 or earlier to Version 7.0.1,
the "exits" directory is emptied.
This is normally c:\Program Files\IBM\WebSphere MQ\exits or c:\Program
Files\IBM\WebSphere MQ (x86)\exits, but you might have installed to a different
directory.
This issue only affects Windows installations and has been resolved, but requires
maintenance to be applied to the version 6 installation prior to migration, see
APAR IC48397 for details.

Either apply service patch 6.0.2.4 or later, or back up your "exits" directory
before migrating.

If you have a previous installation of WebSphere MQ Version 7.0.1
-----------------------------------------------------------------
If you have a previous installation of WebSphere MQ Version 7.0.1, for example a
Beta version, you might experience a problem when you launch the WebSphere MQ
Explorer. If you find that Eclipse starts but the WebSphere MQ perspective does
not open properly, perform the following actions, as necessary.

In the Explorer, click the Window menu and select "Restart perspective".

If this does not work, close the Explorer and issue the command

strmqcfg -i

at the command line, the start the Explorer again.

If this does not work, close the Explorer and check there is no Eclipse
process running. This procedure will remove Explorer data such as remote
queue manager definitions and custom schemes and filters, so make a note
of any such data you want to keep. Delete the following folders:

On Windows:

C:\Documents and Settings\<userid>\Application Data\IBM\MQ Explorer
C:\Documents and Settings\<userid>\.eclipse

On Linux:

/home/<userid>/.mqdata
/home/<userid>/.eclipse

Issue the command

strmqcfg -i

at the command line, the start the Explorer again

Migration from WebSphere MQ Version 6 to WebSphere MQ Version 7 on Windows
--------------------------------------------------------------------------
When migrating WebSphere MQ from v6 to v7, if a queue manager has a
startup property set to Automatic, the property will get
changed to Interactive( manual) during the migration.
To set queue manager startup property back to Automatic use MQ command
amqmdain auto QMgrName.

Migration from WebSphere MQ Version 6 earlier than CSD 6.0.2.3
--------------------------------------------------------------
The first time the WebSphere MQ Explorer is started after migration, error
message AMQ4473 might be displayed and an FDC file written stating that the
WMQ_Schemes.xml file used to save schemes was found to be in an invalid format,
and that all user-defined schemes must be re-created.
Before CSD 6.0.2.3 schemes were not saved correctly. If you use schemes, you
will have experienced this problem and upgraded to a later CSD level. If you
have not created your own schemes and are using an earlier version of WebSphere
MQ you will see this message on starting WebSphere MQ Explorer. However,
MQ Explorer continues, creating a new default set of schemes, so no action is
required.

Migration: save JMSAdmin.config
-------------------------------
Save the file JMSAdmin.config (in the <install_root>/java/bin directory) to
another location before upgrading to WebSphere MQ v.7.0 or it will be
overwritten.

Support for WebSphere MQ on Windows Vista Japanese Edition
----------------------------------------------------------
WebSphere MQ does not support the new Japanese standard, JIS X 0213:2004.
Windows Vista Japanese Edition formally supports JIS X 0213:2004 characters.
These JIS X 0213:2004 characters include Unicode CJK Ideographs Extension-B
characters (UTF-16 surrogate pair (four bytes) characters).

Installation verification test program for JCA with WAS CE
----------------------------------------------------------
For the JCA IVT to work on WebSphere Application Server Community Edition
(WAS CE) there must be a connection factory with a name of "qcf" and a
queue with a message-destination-name of "jmstestQ" defined in the
geronimo-rar.xml when you deploy the RAR file.

For the wmq.jmsra.ivt.ear file to deploy on version 2.0.1 or later of WAS CE
the following xml files within the EAR file have to be updated as below:

geronimo-application.xml
xmlns:nam="http://geronimo.apache.org/xml/ns/naming-1.2">
<dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2</font>]">

openejb-jar.xml
<openejb-jar xmlns="http://www.openejb.org/xml/ns/openejb-jar-2.1"
xmlns:nam="http://geronimo.apache.org/xml/ns/naming-1.2"
xmlns:sec="http://geronimo.apache.org/xml/ns/security-1.2"
xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.2"
xmlns:pkgen="http://www.openejb.org/xml/ns/pkgen-2.0">

Clustering of topics
--------------------
Though clustering of topics is generally supported, do not cluster
SYSTEM.BASE.TOPIC or SYSTEM.DEFAULT.TOPIC. The CLUSTER parameter of these topics
must be blank.

Topics in overlapping clusters
------------------------------
If you define two or more topics, with one topic string being a more qualified
version of the other (for example SPORTS and SPORTS/FOOTBALL), with the topics
in different but overlapping clusters, publications can be delivered to
unexpected recipient queue managers. For example:
- Queue manager qmAB is in both clusters ClusterA and ClusterB
- SPORTS is a cluster topic in ClusterA
- SPORTS/FOOTBALL is a cluster topic in ClusterB
Subscribers to SPORTS/FOOTBALL on queue managers which are only in ClusterA also
receive publications from queue manager qmAB.

Similarly, if a cluster topic and a local topic share a name, unexpected
publications can be received. For example:
- SPORTS is a cluster topic in ClusterA
- Queue manager qmC in ClusterA defines a topic SPORTS with no cluster
Subscribers for SPORTS on queue managers in ClusterA receive publications from qmC.

WebSphere MQ Explorer fails using Firefox on Linux
--------------------------------------------------
The WebSphere MQ Explorer might fail with the message "JVM terminated" when
attempting to launch the Help Center. There is a known problem when running the
Standard Widget Toolkit (SWT) browser inside Eclipse on some Linux distributions
when the default browser is Firefox. To avoid this problem, set the value of the
MOZILLA_FIVE_HOME environment variable to the folder containing your Firefox
installation. For example, if Firefox is installed in /usr/lib/firefox-3.0.10,
use the command:
export MOZILLA_FIVE_HOME=/usr/lib/firefox-3.0.10
or
setenv MOZILLA_FIVE_HOME /usr/lib/firefox-3.0.10
depending on the shell you are using.
(This requirement is noted in the SWT FAQs section of the Eclipse Web site:
http://www.eclipse.org/swt/faq.php#browserlinux)

File Transfer Application help system not automatically available on Linux
--------------------------------------------------------------------------
The Help in the GUI is unavailable, an error is displayed when the File Transfer
Application is started. You can find the html help files in
/opt/mqm/eclipse/fta-help/plugins/com.ibm.mq.fta.doc_7.0.1.0/doc.zip

Multi-instance queue managers are not supported on IBM i
--------------------------------------------------------
Multi-instance queue managers are introduced with WebSphere MQ Version 7.0.1.
The Information Center states that these are available on all platforms except
z/OS. However, they are not available on IBM i (formerly i5/OS).

"Java Messaging and Web Services" component now includes XMS
------------------------------------------------------------
On Windows the component formerly known as "Java Messaging and Web Services" is
now called "Java and .NET Messaging and Web Services". As part of this change
additional files are installed with this component to enable use of the Message
Service Client for .NET, also known as XMS. If you upgrade a Java-only
installation you will also install the Message Service Client for .NET. For more
information about XMS messaging see the WebSphere MQ information center.

migmbbrk might not migrate ACLS correctly when subscription points are used
---------------------------------------------------------------------------
The WebSphere Message Broker publish/subscribe state migration tool (migmbbrk)
might not migrate ACLS correctly when subscription points are used. Consider
the following scenario:

1. A subscription to a WebSphere Message Broker broker references the topic
tree a/b/c.
2. A publication to a/b/c uses a subscription point called SB1
3. The topic string a/b has an ACL that grants publish access to a user, USER1.

The migration to the queue manager creates two topic objects and a setmqaut
command. It emulates subscription points by creating a topic object for SB1
with the topic string SB1/a/b/c. It also creates a topic object for a/b with an
ACL granting publish access to USER1. The setmqaut command grants publish
access to USER1 for the topic a/b.

As a result of the migration the topic tree has two branches, a/b and SB1/a/b/c.
The ACL is defined for the a/b branch but not for the SB1/a/b/c branch.

As a consequence publish access permission is granted to USER1 on a/b, but not
granted to USER1 for the topic string SB1/a/b/c.

If your topic tree includes both subscription points and user-defined ACLs,
review both to see whether the ACLs are defined in the broker and then migrated
to the queue manager need to be manually replicated for the topic trees that lie
below subscription points.

Simplification of publish/subscribe authorities
-----------------------------------------------
The way authorities are determined at the top of the topic tree has been
simplified. If authorities are defined on the SYSTEM.BROKER.DEFAULT.STREAM or
SYSTEM.BROKER.DEFAULT.SUBPOINT topic objects (and those topic objects still have
empty topic strings), those authorities will no longer take effect.

In order to apply topic authorities at the top of the topic tree, you should
apply the authorities to the SYSTEM.BASE.TOPIC object.

Use of HP Hotspot JVM
---------------------
If you use an HP Hotspot JVM, set the Java System property -XX:+UseGetTimeOfDay.
If you do not set this property, your application might not be aware of system
time changes.

WebSphere MQ Explorer - English messages in non-English environment
-------------------------------------------------------------------
When WebSphere MQ v7.0.1.10 is installed in a non-English environment, some
messages in WebSphere MQ Explorer mighty still appear in English and might not
display the latest translation. This is caused by Eclipse Bug 201489:

https://bugs.eclipse.org/bugs/show_bug.cgi?id=201489

To install the Eclipse fix for this issue, first run WebSphere MQ Explorer in
Eclipse Workbench mode. To select Eclipse Workbench mode,
click Window > Preferences > WebSphere MQ Explorer > in an Eclipse Workbench.
Restart WebSphere MQ Explorer for this to take effect.

On Linux platforms, in order to be able to view and install updates run
WebSphere MQ Explorer as root.

Launch the update manager by clicking Help > Software Updates
Select "RCP Patch (bug:201489)" from the available updates and follow the
instructions to install the fix.
To return WebSphere MQ Explorer to stand-alone mode if required, select the
appropriate option from the WebSphere MQ Explorer preferences page.

WebSphere Application Server support on z/OS
--------------------------------------------
Before you deploy WebSphere MQ v7.0.1.10 on or within a WebSphere Application
Server environment on z/OS, read the technotes below that are relevant to
the versions of WebSphere Application Server you are using:

Version Link
-------- -------------------------------------------------------------
6.0.2 http://www.ibm.com/support/docview.wss?uid=swg21307212
6.1 http://www.ibm.com/support/docview.wss?uid=swg21307203
7.0 http://www.ibm.com/support/docview.wss?uid=swg21316899

XMS assemblies left in Global Assemblies Cache after uninstall
--------------------------------------------------------------
On windows, uninstalling WebSphere MQ after installing WebSphere MQ7.0.1 through
the fix pack might result in some assemblies (IBM.XMS.*.dll) being left in
the .NET Global Assembly Cache (GAC).

This will occur if the .NET framework is available on the machine and the
"Java Messaging and Web Services" feature was selected in the original WebSphere
MQ v7 installation (selected by default). This behaviour can be prevented by
either rolling back the WebSphere MQ v 7.0.1 refresh pack or by running
"amqiRegsiterdotNet.cmd /u" (available in the "<WMQInstallRoot>\bin" directory)
before uninstalling WebSphere MQ.


Other changes
=============

Updates in the XA sample makefile
---------------------------------
Updates are made to the xaswit.mak file, so that it now contains up-to-date
references to database product install directories.

The default directories used in the sample makefile are changed to be more
up-to-date.

If you need to rebuild a switch load file, and need to continue to use old
database product install directories or versions, please check and amend the
xaswit.mak file so that it contains the correct information for your target
machine.

Do not rebuild your switch load file(s), unless it is necessary.

You will ONLY need to rebuild a switch load file IF the install directory of
your database product changes - eg. after installing a new version of the
database product.


++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ ++
++ Section 2 : How to obtain and install WebSphere MQ version 7.0.1.12 as a ++
++ fix pack ++
++ ++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Product/Component Release: 7.0
Update Name: WebSphere MQ fix pack 7.0.1.12

2.1 Download location
---------------------
Download WebSphere MQ fix pack 7.0.1.12 from the following location:

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


2.2 Prerequisites and corequisites
----------------------------------
Before downloading WebSphere MQ V7.0.1.12, perform the following steps:

1. Ensure that your system meets all the system requirements:
http://www.ibm.com/software/integration/wmq/requirements/index.html
This action prevents technical problems that might occur after the
installation and configuration of the fix pack.

2. Review the Flashes and Authorized Problem Analysis Reports (APARs)
on the WebSphere MQ for UNIX(R) and Windows(R) product support Web
site:

http://www.ibm.com/software/integration/wmq/support/

APARs describe defects that have been addressed in a fix pack, For a
list of WebSphere MQ v7.0.1.12 APARs, refer to:

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

3. Ensure that you have sufficient file system free space to download
and extract the fix pack. You need to have a file system with one
gigabyte of free space to contain the compressed file and the
uncompressed installation image.

4. Ensure that you have the free space required to install the fix
pack. The free space must be available in the location of the
WebSphere MQ installation that you are updating.

To determine the space used by the existing WebSphere MQ products on
UNIX platforms, perform the command:

du -k -s MQDIR

where MQDIR represents the location where the WebSphere MQ product is
installed.

5. If you already have the WebSphere MQ v7 product installed and have
obtained special fixes, contact IBM(R) support to determine whether you
need an updated version of the fixes before you install WebSphere MQ
v7.0.1.11. This helps to ensure that your system is in a consistent
state and that no special fixes are lost.


2.3 Installing
--------------
Before proceeding with the installation process, view the online
version of the readme file to check if information has changed since
the readme file download:

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

2.3.1 Prior to installation
---------------------------
Before installing WebSphere MQ v7.0.1.12, perform the following steps:

1. Read all of this readme. Note particularly the additional steps
that are necessary if you have installed GSKit in order to use SSL
channels with WebSphere MQ.
2. Download the fix pack to an appropriate location.
3. Uncompress the fix pack.
4. Stop all WebSphere MQ processes and its applications.

2.3.2 Downloading the fix pack to an appropriate location
-------------------------------------------------------------
There must not be any spaces in the directory path where you plan to
download and uncompress the fix pack. If there are spaces in the
directory path, the installation will fail. For example, make sure
that your directory path resembles the following:

/home/WMQFixPack/FP1/ ...

It should not resemble the following:

/home/WMQ FixPack/FP1/ ...

2.3.3 Uncompressing the fix pack installation images
----------------------------------------------------
All fix pack installation images on the download site are compressed in
gz/Z/zip format. Before you can apply the fix pack from this format,
copy the downloaded file to a temporary directory and use
gunzip/uncompress and tar to extract the fix pack installation image.

2.3.4 Extract the fix pack install files
----------------------------------------
To extract the fix pack install files, perform the following steps:

1. Copy the gzipped/Z image to a temporary location.
2. Change to the directory where you copied the image.
3. The following are example commands to extract the fix pack
installation image:

gunzip -c filename.tar.gz | tar -xvf -
zcat filename.tar.Z | tar -xvf -
unzip filename.zip

where filename.tar.gz etc. is the name of the downloaded file.

2.3.5 Stopping all WebSphere MQ processes
-----------------------------------------
You must ensure that all WebSphere MQ processes are stopped and do not
start automatically during the installation procedure. To stop all
WebSphere MQ processes, perform the following steps:

1. Log in as a user in the mqm group.
2. Use the endmqm command to stop all running queue managers.
3. Stop any listeners associated with the queue managers, using the
command:

endmqlsr -m QMgrName

4. To check that you have stopped all of them, enter the following:

ps -ef | grep mq

Check that there are no processes listed that are running command lines
beginning amq or runmq. Ignore any that start with amqi.

5. Take any further administrative actions (as root if necessary) to
stop all applications that use queue managers on the system, and
prevent them from restarting automatically during the installation
procedure


2.3.6 Installation
------------------
For more information about how to install the fix pack see
the appropriate Quick Beginnings section of the WebSphere MQ
Information Center at:

AIX:http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq10720_.htm
HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10790_.htm
Linux: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10860_.htm
Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10780_.htm
Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq11230_.htm


2.4 Post installation
---------------------

2.4.1 More information about installations of GSKit and JRE
------------------------------------------------------------


For information regarding the levels of GSKit and JRE included with this product, see the
following link:

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

Perform the necessary tasks after installation
----------------------------------------------------
After installing WebSphere MQ v7.0.1.12, perform the following steps:

1. Verify the installation. Refer to the Quick Beginnings section of
the WebSphere MQ Information Center for the appropriate platform.
2. Restart the queue managers

After applying a fix pack, it is not mandatory to recompile
applications.


2.4.2 More Information about Installations of GSKit, JDK, JRE and
IA9H (IBM Service client for .NET)
-------------------------------------------------------------------

For information regarding the levels of GSKit and JRE included with this product, see the
following link:

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


2.4.3 Installing GSKit
--------------------------------

For information about installing GSKit, refer to the Quick Beginnings
section of the WebSphere MQ Information Center for the appropriate platform:

AIX:http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq20040_.htm
HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10870_.htm
Linux:http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10980_.htm
Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10860_.htm
Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq12150_.htm


2.4.4 Troubleshoot Installation from Support site
-------------------------------------------------
Before contacting IBM you are recommended to view the web site
http://www.ibm.com/support/docview.wss?uid=swg21229861 which has
specific advice on problem solving and data collection for WebSphere
MQ.


2.5 Uninstalling
----------------
For more information about how to remove the fix pack see
the appropriate Quick Beginnings section of the WebSphere MQ
Information Center:

AIX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq10740_.htm
HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10810_.htm
Linux: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10880_.htm
Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10800_.htm
Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq11270_.htm


2.6 List of fixes
-----------------
Fixes included in WebSphere MQ v7.0.1.12 :

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


+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ ++
++ Section 3 : IBM Message Service Client for .NET V2.0.0.12 ++
++ ++
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

3.1 Changes in this release
---------------------------

This version of XMS .NET has been tested for interaction with
IBM WebSphere MQ 7.0.1.12.

In addition, several fixes have been applied to resolve issues highlighted
from continued testing and customer feedback.

If Microsoft .NET Framework Version 4.0 is installed on the machine, you might need to
Create or set the HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework registry key as follows:

"OnlyUseLatestCLR"=dword:00000001


3.2 Troubleshooting XMS .NET issues
--------------------------------

a) User authentication for WebSphere MQ is performed by using the details of the
logged on user and not the information provided in the XMSC.USERID and
XMSC.PASSWORD fields. This is designed to maintain consistency with WebSphere MQ.
See the WebSphere MQ information center for further details about
authentication.

b) On a Windows 64-bit platform, the setting or getting of
values for the property type “double” using the
SetDoubleProperty() or GetDoubleProperty() methods may not work correctly,
if the values involved are smaller than Double.Epsilon.

For example, if you try to set a value of 4.9E-324 for a
property with type double, the Windows 64-bit platforms
treat it as 0.0. So, in a distributed messaging environment, if a JMS or
another application sets the value for a double property
as 4.9E-324 on any Unix or Windows 32-bit machine, and XMS
.NET runs on a 64-bit machine, the value returned by GetDoubleProperty()
is 0.0.

This is a known issue with Microsoft .NET 2.0 Framework.
Refer to the following link for more details:
http://support.microsoft.com/kb/970495

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ ++
++ Section 4 : Copyright, Notices and trademarks ++
++ ++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

4.1 Copyright and trademark information
---------------------------------------
http://www.ibm.com/legal/copytrade.shtml

4.2 Notices
-----------
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 jurisdictions 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 publication. IBM
may make improvements and/or changes in the product(s) and/or the
program(s) described in this publication at any time without notice.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices and
other information IBM must provide to you under its license to certain
software code. The relevant terms and conditions, notices and other
information are provided or referenced below. Please note that any
non-English version of the licenses below is unofficial and is provided
to you for your convenience only. The English version of the licenses
below, provided as part of the English version of this file, is the
official version.

Notwithstanding the terms and conditions of any other agreement you may
have with IBM or any of its related or affiliated entities
(collectively "IBM"), the third party software code identified below
are "Excluded Components" and are subject to the following terms and
conditions:

* the Excluded Components are provided on an "AS IS" basis
* IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT
LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE
IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE
* IBM will not be liable to you or indemnify you for any claims related
to the Excluded Components
* IBM will not be liable for any direct, indirect, incidental, special,
exemplary, punitive or consequential damages with respect to the
Excluded Components.


4.3 Trademarks
--------------
The following terms are trademarks of International Business Machines
Corporation in the United States, other countries, or both:
AIX FFST i5/OS IBM MQSeries SupportPac
WebSphere z/OS

Microsoft and Windows are trademarks of Microsoft Corporation
in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Oracle and/or its affiliates.

UNIX is a registered trademark of The Open Group in the United States
and other countries

Linux is a registered 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.

Product Alias/Synonym

MQ WMQ

Rate this page:

(0 users)Average rating

Document information


More support for:

WebSphere MQ
APAR / Maintenance

Software version:

7.0.1, 7.0.1.1, 7.0.1.2, 7.0.1.3, 7.0.1.4, 7.0.1.5, 7.0.1.6, 7.0.1.7, 7.0.1.8, 7.0.1.9, 7.0.1.10, 7.0.1.11, 7.0.1.12

Operating system(s):

AIX, HP Itanium, HP-UX, IBM i, Linux, Linux on Power, Linux zSeries, OS/400, Solaris, Windows, i5/OS, iSeries

Reference #:

7041544

Modified date:

2014-04-08

Translate my page

Machine Translation

Content navigation