IBM Support

Readme for WebSphere MQ V7, Fix Pack 7.0.1.10

Product Readmes


Abstract

This document provides information on WebSphere MQ fix pack 7.0.1.10

Content

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

1. What is new in the 7.0.1.x fix pack

2. Limitations, known problems and other changes.

3. How to obtain and install WebSphere MQ version 7.0.1.10 as a fix pack.

4. Notices and trademarks

A minor update has been made to the product license, removing an incorrect reference to z/OS,
please see here for details:
http://www.ibm.com/software/sla/sladb.nsf/lilookup/D28EC7F20481D22C852577ED0070F4D5?opendocument&li_select=A349667F490B79E9852577ED0070F4D2

The online version of this file can be found here:
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006097
or translated versions at:
ftp://public.dhe.ibm.com/software/integration/wmq/docs/


Important: The most current version of the readme file can always be
found online.

In addition to this file, you can find more information 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?rs=977&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
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 : What is new in the 7.0.1.x fix pack ++
++ ++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

What was new in the 7.0.1.8 fix pack
===================================

Cluster Queue Monitoring sample program

A new sample program amqsclm that uses the built-in WebSphere MQ cluster
workload balancing features to direct messages to instances of queues that
have consuming applications attached. This sample demonstrates a way to
prevent the build-up of messages on an instance of a cluster queue to which
no consuming application is attached. See the infocenter topic
"The Cluster Queue Monitoring sample program (AMQSCLM)" for details.


What was new in the 7.0.1.7 fix pack
===================================

Multi-installation queue manager coexistence on UNIX, Linux, and Windows:

Multiple copies of WebSphere MQ can be installed on
UNIX, Linux, and Windows on the same server.
One version 7.0.1 installation, at fix pack level 6, or later,
can coexist with multiple version 7.1, or later installations.

What was new in the 7.0.1.4 fix pack
===================================

Optional alternative GSKit version 8 component for SSL/TLS:

The sub-component which provides support for SSL/TLS on WebSphere MQ for
Windows, UNIX and Linux is called GSKit. WebSphere MQ SSL/TLS has been
enhanced with an alternative, separate, version of GSKit at version 8.
This can be used instead of GSKit version 7.

The GSKit version 8 secure sockets library can be used with queue managers
and clients (C, C++ and unmanaged .NET). When installed and configured for
use with WebSphere MQ, GSKit version 8 provides:

- Support for TLS version 1.2 with three new CipherSpecs which provide
SHA-2 hashing:
TLS_RSA_WITH_NULL_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256

This is provided for users who need to enforce stricter FIPS 140-2
certification rules which deprecate MD5 and SHA-1.

- Support for Java/JMS secret key reset interoperability with JSSE2.

This allows users who need to enable SSL/TLS secret key reset on the
connections between their queue manager and Java or JMS client
applications.

- An alternative command-line tool gsk8capicmd which provides improved
error messages displayed in the user's local language.

This can be used as an alternative to the existing GSKit version 7
gsk7cmd and gsk7capicmd tools for certificate administration, although
users can choose to continue using the existing GSKit version 7 tools.

GSKit version 7 remains the default GSKit version and will continue to be
used unless GSKit version 8 is installed and configured.

The 7.0.1.4 fix pack includes some additional GSKit version 8 installation
packages:

- gskcrypt32: 32-bit cryptographic algorithm support for GSKit version 8

- gskssl32: 32-bit secure socket library and tools for GSKit version 8

- gskcrypt64: 64-bit cryptographic algorithm support for GSKit version 8

- gskssl64: 64-bit secure socket library and tools for GSKit version 8

Both the gskcrypt and gskssl packages must be installed if you need to use
GSKit version 8 with WebSphere MQ. Some systems do not provide 64-bit
support: the 64-bit packages may be omitted from such systems.

For more information about these new SSL/TLS features, please refer to the
following section of the WebSphere MQ Information Center:

http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp?topic=/com.ibm.mq.csqzas.doc/sy13850_.htm

What was new in the 7.0.1.3 fix pack
====================================

Explorer Security Changes - The Explorer tests are enhanced as follows:

New Authorization Service tests are added:

- Identify applications with unnecessary authorities
- Verify that an Authorization Service is installed

These tests can only be run as part of a Custom Test Configuration.

Existing default tests are enhanced, and one is renamed:

- "Verify MCA User ID on server-connection channels" is enhanced
and renamed "Identify unprotected inbound channels". All inbound
channels are now checked, and all methods of securing a channel are
included.
- "Verify SSL channel authentication" is enhanced to now also check
for the presence of an SSL/TLS peer name parameter.
- "Verify SSL key repository files" is enhanced. The level of access
control or permissions set on the SSL/TLS system files is now checked;
if unnecessary access is allowed on a file, an error is written to the
Test Results box. This test only applies to files on the same system
as the Explorer.

Explorer Object Authorities panels now display command-line commands which
are equivalent to the changes to Object Authorities requested through the
Explorer.


What was new in the 7.0.1.0 refresh pack
========================================

Multi-Instance Queue Managers - Enables automatic failover to a standby queue
manager instance in the event of an incident or
planned outage

Automatic Client Reconnect - Provides client-connected applications with
automatic detection of outages or failures and
reconnects to the same or alternative queue
managers

Enhanced Governance - Generates notification events whenever configuration changes
are made or commands are run, recording cause and state
before and after
- Service Definition wizard generates WSDL to describe
WebSphere MQ services

Enhanced SSL Security - Supports certificate checking using Online Certificate
Status Protocol (OCSP) as alternative to Certificate
Revocation Lists (CRL)
- Supports SSL Key Reset protocol for Java TM clients,
including those running in FIPS-certified mode and on
all levels of JRE

Enhanced .NET Support - Provides IBM Message Service Client for .NET developers
(previously available in Support pac IA9H), now
enhanced to exploit WebSphere MQ v7 features
- Supports use of WebSphere MQ as custom channel within
Windows Communication Foundation

For more details on any of these features, refer to the product documentation at:
http://www.ibm.com/software/integration/wmq/library/


++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ ++
++ Section 2 : Limitations, known problems and other changes ++
++ ++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

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://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp?topic=/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">

  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?rs=171&uid=swg21307212
6.1 http://www.ibm.com/support/docview.wss?rs=171&uid=swg21307203
7.0 http://www.ibm.com/support/docview.wss?rs=171&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 3 : How to obtain and install WebSphere MQ version 7.0.1.10 as a ++
++ fix pack ++
++ ++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Product/Component Release: 7.0
Update Name: WebSphere MQ fix pack 7.0.1.10

Contents
--------
3.1 Download location

3.2 Prerequisites and corequisites

3.3 Installing
3.3.1 Prior to installation
3.3.2 Downloading the fix pack to an appropriate location
3.3.3 Uncompressing the fix pack installation images
3.3.4 Extract the fix pack install files
3.3.5 Stopping all WebSphere MQ processes
3.3.6 Installation
3.3.6.1 AIX
3.3.6.2 HP-UX
3.3.6.3 Linux
3.3.6.4 Solaris
3.3.6.5 Windows

3.4 Post installtion
3.4.1 Perform the necessary tasks after installation
3.4.2 More Information on Installations of GSKit, JDK, and IA9H (IBM Service client for .NET)
3.4.3 Installing GSKit
3.4.3.1 AIX
3.4.3.2 HP-UX
3.4.3.3 Linux
3.4.3.4 Solaris
3.4.3.5 Windows
3.4.4 Reverting to an earlier level of GSKit
3.4.5 Troubleshoot Installation from Support Site

3.5 Uninstalling
3.5.1 Prior to uninstallation
3.5.2 Uninstalling WebSphere MQ fix pack 7.0.1.10
3.5.2.1 AIX
3.5.2.2 HP-UX
3.5.2.3 Linux
3.5.2.4 Solaris
3.5.2.5 Windows

3.6 List of fixes

3.7 Copyright and trademark information

3.8 Notices



3.1 Download location
---------------------
Download WebSphere MQ fix pack 7.0.1.10 from the following location:

http://www.ibm.com/support/docview.wss?rs=171&uid=swg24034145

Below is a list of components, platforms, and file names that apply to
this readme file.

Product/Component Name Platform File
---------------------- --------------- ---------------------------------------
WebSphere MQ v7.0.1.10 AIX 7.0.1-WS-MQ-AixPPC64-FP0010.tar.Z
WebSphere MQ v7.0.1.10 HPUX PARISC 7.0.1-WS-MQ-HpuxPaRISC64-FP0010.tar.Z
WebSphere MQ v7.0.1.10 HPUX IA64 7.0.1-WS-MQ-HpuxIA64-FP0010.tar.Z
WebSphere MQ v7.0.1.10 Solaris Sparc 7.0.1-WS-MQ-SolarisSparc64-FP0010.tar.Z
WebSphere MQ v7.0.1.10 Solaris X86-64 7.0.1-WS-MQ-SolarisX64-FP0010.tar.Z
WebSphere MQ v7.0.1.10 Linux X86 7.0.1-WS-MQ-LinuxIA32-FP0010.tar.gz
WebSphere MQ v7.0.1.10 Linux X86-64 7.0.1-WS-MQ-LinuxX64-FP0010.tar.gz
WebSphere MQ v7.0.1.10 Linux s390x 7.0.1-WS-MQ-LinuxS390X-FP0010.tar.gz
WebSphere MQ v7.0.1.10 Linux PPC 7.0.1-WS-MQ-LinuxPPC64-FP0010.tar.gz
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-CsCz.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-DeDe.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-EnUs.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-EsEs.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-FrFr.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-HuHu.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-ItIt.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-JaJp.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-KoKr.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-PlPl.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-PtBr.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-RuRu.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-ZhCn.zip
WebSphere MQ v7.0.1.10 Windows 7.0.1-WS-MQ-Windows-FP0010-ZhTw.zip


3.2 Prerequisites and corequisites
----------------------------------
Before downloading WebSphere MQ V7.0.1.10, 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.10 APARs, refer to:

http://www.ibm.com/support/docview.wss?rs=171&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.10. This helps to ensure that your system is in a consistent
state and that no special fixes are lost.


3.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?rs=171&uid=swg27006097

3.3.1 Prior to installation
---------------------------
Before installing WebSphere MQ v7.0.1.10, 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.

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

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

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

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

3.3.6 Installation
------------------
Applying WebSphere MQ v7.0.1.10 fix pack to update an existing
installation:

3.3.6.1 AIX

1. Display the appropriate smitty panel using this sequence:
Software Installation and Maintenance
Install and Update Software
Install and Update From ALL Available Software
> Alternatively, use a fastpath command (smit[ty] install_update).
2. Select a value for INPUT device / directory for software. Click
the List button (or press the F4 key on smitty) to display a list of
valid values.
3. Complete the SOFTWARE to install field. Enter ALL to install all
applicable fileset updates to your installation.
4. If you think that at a later time you might want to reject the
service updates and return to the backup level, you must ensure that:
1. The COMMIT software updates value is set to no.
2. The SAVE replaced files value is set to yes.
By setting these values, you ensure that the updates are applied, and
the old filesets are saved, not overwritten.
5. Press Enter to display a confirmation message before starting the
update. While the command runs, it displays progress messages ending
with an installp Summary table, confirming which components of
WebSphere MQ for AIX. have been updated. If the command does not
complete successfully, a full error log is saved in the file smit.log
in root's home directory.

3.3.6.2 HP-UX

1. Choose interactive or non-interactive mode, and choose whether to
install the general MQSERIES package, or to install the individual
components explicitly. Run Step 1a, 1b, 1c or 1d (note: only one
of these four) according to this choice.

1a.Using non-interactive mode (specifying general MQSERIES package):

If you have installed only some of the components, this method of
installing a fix pack should be expected to run and achieve the
desired result of installing all relevant components, but error
messages from the installer should be expected.

In the directory where the service update package is located, use
swinstall:

swinstall -s $PWD/hp-Uxxxxxx.v11 MQSERIES

If you specify MQSERIES like the example above:

* swinstall will run in non-interactive mode

* Updates will be installed only for the WebSphere MQ components
which match the set of components that are already installed.
Unmatched components will cause error messages to appear. Samples
of these error messages are given further down this page.

1b.Using non-interactive mode (specifying specific lower-level MQSERIES
components):

If you have installed only some of the components, this method of
installing a fix pack should be expected to run without errors.

In the directory where the service update package is located, use
swinstall to install the maintenance for all components. ***Please
note that you must add to this command ALL component names matching
the MQSERIES.MQM-* components already installed.***

The backslashes are line continuation characters - this command can
be entered all on one line:

/usr/sbin/swinstall -s $PWD/hp-Uxxxxxx.v11 \
MQSERIES.MQM-BASE-Uxxxxxx \
MQSERIES.MQM-RUNTIME-Uxxxxxx \
MQSERIES.MQM-SERVER-Uxxxxxx

The above command is correct in a situation where only three
components (MQM-BASE, MQM-RUNTIME, MQM-SERVER) had previously been
installed from 7.0.0.0.

1c.Using interactive mode (specifying general MQSERIES package):

If you have installed only some of the components, this method of
installing a fix pack should be expected to run and achieve the
desired result of installing all relevant components, but error
messages from the installer should be expected.

In the directory where the service update package is located, use
swinstall:

swinstall -s $PWD/hp-Uxxxxxx.v11

* Select the MQSERIES line
* From the menu, choose Actions > Mark for Install
* Click OK on the information box
* From the menu, choose Actions > Install...
* Follow the prompts

Updates will be installed only for the WebSphere MQ components
which match the set of components that are already installed.
Unmatched components will cause error messages to appear. Samples
of these error messages are given further down this page.

1d.Using interactive mode (specifying specific lower-level MQSERIES
components):

If you have installed only some of the components, this method of
installing a fix pack should be expected to run without errors.

In the directory where the service update package is located, use
swinstall:

swinstall -s $PWD/hp-Uxxxxxx.v11

* Select the MQSERIES line.
* From the menu, choose Actions > Open Item
* Select all component names matching the MQSERIES.MQM-* components
already installed.
* From the menu, choose Actions > Mark for Install
* Click OK on the information box.
* From the menu, choose Actions > Close Level
* Should see "Partial" against MQSERIES.
* If GSKit updates are required:
* Select the gsk7bas and gsk7bas64 lines.
* From the menu, choose Actions > Mark for Install
* From the menu, choose Actions > Install...
* Follow the prompts.

2. Special note

It is possible that your administrator has created a depot containing
both the WebSphere MQ v7.0 product AND fix pack.

Note that you must install the base package first, followed by the
maintenance package. You must not select them both for simultaneous
install.

If you are installing WebSphere MQ v7.0 for HP-UX from a software
depot that has been created this way, you will need to use the install
option "autoselect_dependencies=false".

In the swinstall GUI, this can be done by unchecking the option
"autoselect dependencies when marking software" in the
"Options" -> "Change Options" panel.

Warning: Disabling the autoselect_dependencies will disable some
checking for dependencies and must not be used when uninstalling
maintenance packs.

3. Error messages:

If you have installed only some of the components, then specifying
the general MQSERIES package from the hp-Uxxxxxx.v11 file can be
expected to install all relevant components, but error messages
from the installer should be expected.

To test whether the installation of the components you require has
been successful, you can use swlist as described below.

Updates will be installed only for the WebSphere MQ components
which match the set of components that are already installed.
Unmatched components will cause error messages to appear.

The following examples are for a situation where only three components
(MQM-BASE, MQM-RUNTIME, MQM-SERVER) were installed from 7.0.0.0.

When running swinstall operating on the general MQSERIES package,
lines like these may appear on the console (or in the GUI panels
when running under the swinstall GUI):

ERROR: "hpux11.mycompany.com:/": The software dependencies for 20
products or filesets cannot be resolved.
* The analysis phase failed for "hpux11.mycompany.com:/".
ERROR: "hpux11.mycompany.com:/": 22 filesets were determined to
be skipped in the analysis phase.
* The execution phase failed for "hpux11.mycompany.com:/".
* Analysis and Execution had errors.

Lines like these may appear in the swjob output for such a
swinstall session:

ERROR: 20 of 25 filesets had Errors.
* 2 of 25 filesets were Skipped.
* 3 of 25 filesets had no Errors or Warnings.
ERROR: The Execution Phase had errors. See the above output for
details.

To verify what has been successfully installed, use the swlist
command. This is an example command and its output.

swlist MQSERIES

# Initializing...
# Contacting target "hpux11.mycompany.com"...
#
# Target: hpux11.mycompany.com:/
#

# MQSERIES 7.0.0.0 WebSphere MQ for HP-UX
MQSERIES.MQM-BASE 7.0.0.0 WebSphere MQ SDK fileset
MQSERIES.MQM-RUNTIME 7.0.0.0 WebSphere MQ Runtime fileset
MQSERIES.MQM-SERVER 7.0.0.0 WebSphere MQ Server fileset
# MQSERIES 7.0.1.10 WebSphere MQ update for HP-UX (Uxxxxxx)
MQSERIES.MQM-BASE-Uxxxxxx 7.0.1.10 WebSphere MQ Update for HP-UX
MQSERIES.MQM-RUNTIME-Uxxxxxx 7.0.1.10 WebSphere MQ Update for HP-UX
MQSERIES.MQM-SERVER-Uxxxxxx 7.0.1.10 WebSphere MQ Update for HP-UX

3.3.6.3 Linux

1. Log in as root.
2. To find out which packages are installed on your machine, enter the
following:

rpm -q -a | grep MQSeries

For example, if you have a minimum WebSphere MQ installation and SDK
component, at level 7.0.0.0, this will return:

MQSeriesRuntime-7.0.0-0
MQSeriesSDK-7.0.0-0
MQSeriesServer-7.0.0-0

3. Now install all available updates for the packages you have on your
system:

rpm -ivh MQSeriesRuntime-Uxxxx-7.0.1-9.i386.rpm \
MQSeriesSDK-Uxxxx-7.0.1-9.i386.rpm \
MQSeriesServer-Uxxxx-7.0.1-9.i386.rpm

Note: You must install all 7.0.1.10 packages that apply to those 7.0.0.0,
7.0.0.1, 7.0.0.2, 7.0.1.0, 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 or 7.0.1.9 packages that are currently installed on your system.

4. Repeat step 2, and you will see that the Runtime, SDK and Server
packages are now at level 7.0.1.10:

MQSeriesRuntime-7.0.0-0
MQSeriesSDK-7.0.0-0
MQSeriesServer-7.0.0-0
MQSeriesRuntime-Uxxxxxx-7.0.1-10
MQSeriesSDK-Uxxxxxx-7.0.1-10
MQSeriesServer-Uxxxxxx-7.0.1-10

3.3.6.4 Solaris

1. Change to the directory containing the maintenance packages.
2. Enter the following:

pkgadd -d packagename

where packagename corresponds to the image file name, for example,

mqm-Uxxxxxx.img

3. Follow the on-screen instructions.

3.3.6.5 Windows

Before installing this fix pack, remove any installed WebSphere MQ
interim and test fixes.

1. Run the uncompressed executable file installing a maintenance pack.
2. Running this file presents you with a dialog screen on which you
can choose to temporarily unpack or save the executable file. Select
the appropriate option (and if saving select the default folder, or
change it if required) and click Install.
3. Click Finish when the file has been unpacked into the temporary
folder to end the dialog.
4. The installation program AMQICSDN.EXE file now runs and presents
you with a dialog screen on which you can choose a folder in which to
back up any files that are to be changed by the maintenance process.

The topic "Silently installing maintenance updates" in the Quick Beginnings
for Windows section of the WebSphere MQ Information Center
(http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/topic/com.ibm.mq.amqtac.doc/wq11250_.htm)
describes the parameters which can be passed when installing maintenance.
These apply to attended installations as well, that is when the -s flag is
not set.

In particular, the option MQPINUSEOK is useful when the installation
fails reporting that files are in use (eg. AMQ4756).

Example syntax in this case would be:

WebSphereMQMDV7.0.1.10EnUs.exe [-s] -a MQPINUSEOK=1
(For the self extracting version from the web)

AMQICSDN.exe MQPINUSEOK=1
(Running amqicsdn from the unpacked version)

Where
The -s option tells the unpacking to run silently, and
the -a option passes the subsequent parameter to amqicsdn.exe.

Notes for 64-bit Windows operating systems.

Release 7.0.0.0 includes support for the 32-bit WebSphere MQ
product and 32-bit applications running on Windows XP Professional x64
Edition, Windows Server 2003 (Standard or Enterprise) x64 Edition,
Microsoft Windows Server 2008 (Standard or Enterprise 64-bit Edition)
and Microsoft Windows Vista (64-bit versions of Business, Enterprise, or
Ultimate Edition).

Install directories used on 64-bit Windows operating systems.

On 64-bit Windows, the default installation location is 'C:\Program
Files (x86)\IBM\WebSphere MQ'. On 32-bit windows the default is
'C:\Program Files\IBM\WebSphere MQ'.

If the user modifies the default location to 'C:\Program Files\....'
the Microsoft Windows Installer (MSI) will change this to 'C:\Program
Files (x86)\....'. If the user sets the default location to some other
value, MSI does not change its value.

Note - see the appropriate Quick Beginnings section of the WebSphere MQ
Information Center for more information about how to install or remove
the fix pack.

3.4 Post installation
---------------------

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

1. Verify the installation. Refer to the Quick Beginnings guides for the
appropriate platform.
2. Restart the queue managers

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


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

GSKit version history:

WebSphere MQ GSKit
Version versions
-------------- -------------
7.0.1.10 7.0.4.44, 8.0.14.26
7.0.1.9 7.0.4.41, 8.0.14.22
7.0.1.8 7.0.4.38, 8.0.14.14
7.0.1.7 7.0.4.33, 8.0.14.9
7.0.1.6 7.0.4.33, 8.0.14.9
7.0.1.5 7.0.4.29, 8.0.14.9
7.0.1.4 7.0.4.29, 8.0.14.7
7.0.1.3 7.0.4.27
7.0.1.2 7.0.4.27
7.0.1.1 7.0.4.23
7.0.1.0 7.0.4.23
7.0.0.2 7.0.4.20
7.0.0.1 7.0.4.20
7.0.0.0 7.0.4.14

IBM Java SDK and JRE version history:

WebSphere MQ IBM Java SDK Java JRE
Version version version
-------------- ------------- --------------
7.0.1.10 Not included 1.5 SR 15
7.0.1.9 Not included 1.5 SR 13 FP 1
7.0.1.8 Not included 1.5 SR 13
7.0.1.7 Not included 1.5 SR 12 FP 5
7.0.1.6 Not included 1.5 SR 12 FP 4
7.0.1.5 Not included 1.5 SR 12 FP 3
7.0.1.4 Not included 1.5 SR 11
7.0.1.3 Not included 1.5 SR 11
7.0.1.2 Not included 1.5 SR 11 on Unix platforms
7.0.1.2 Not included 1.5 SR 5 on Windows
7.0.1.1 Not included 1.5 SR 10 on Unix platforms
7.0.1.1 Not included 1.5 SR 5 on Windows
7.0.1.0 Not included 1.5 SR 5
7.0.0.2 Not included 1.4.2 SR 12
7.0.0.1 Not included
7.0.0.0 1.5.0 SR5

IA9H version history:

WebSphere MQ IA9H
Version version
-------------- -------------
7.0.1.10 2.0.0.10
7.0.1.9 2.0.0.9
7.0.1.8 2.0.0.8
7.0.1.7 2.0.0.7
7.0.1.6 2.0.0.6
7.0.1.5 2.0.0.5
7.0.1.4 2.0.0.4
7.0.1.3 2.0.0.3
7.0.1.2 2.0.0.2
7.0.1.1 2.0.0.1
7.0.1.0 2.0.0

3.4.3 Installing GSKit version 7
--------------------------------

These instructions are applicable to GSKit version 7 only.

3.4.3.1 AIX

Install the gskta.rte and gsksa.rte packages from the installation
media using the installp command, for example, assuming the media
containing the fix pack is the current directory:

installp -ac -d. gskta.rte gsksa.rte

The level of GSKit provided with this fix pack, 7.0.4.44, requires the
following system patches (listed by version of AIX) to be installed
before GSKit is installed.

AIX 5.2.0:
xlC.aix50.rte.6.0.0.3 or later

AIX 5.3.0:
xlC.aix50.rte.6.0.0.3 or later
If running Technical Level 5, bos.rte.libc:5.3.0.53 or greater is required

3.4.3.2 HP-UX

The GSKit packages are included in the same depot as the WebSphere MQ
fix pack. Selection of the MQSERIES filesets for installation will
automatically select the appropriate GSKit packages.

HP-UX for PA-RISC:
The level of GSKit provided with this fix pack, 7.0.4.44, requires the
following system patches (listed by version of HP-UX) to be installed
before GSKit will install.

32-bit HP-UX 11i:
PHSS_26946 or later,
PHSS_33033 or later,
PHCO_34275 or later

64-bit HP-UX 11i:
PHSS_26946 or later,
PHSS_33033 or later,
PHCO_34275 or later

3.4.3.3 Linux

Before installing the WebSphere MQ fix pack upgrade the GSKit packages
using the rpm -U command as follows ( xxxx represents the architecture
string for the platform )

For a system where a 32-bit version of GSKit is installed:
rpm -U gsk7bas-7.0.4.44.xxxx.rpm

and

For a system where a 64-bit version of GSKit is installed:
rpm -U gsk7bas64-7.0.4.44.xxxx.rpm

Ensure that, on 64-bit platforms, BOTH packages are installed. This is
because both 64-bit and 32-bit processes may need to load GSKit
libraries.

The level of GSKit provided with this fix pack, 7.0.4.44, requires the
following system patches (listed by version/flavour of Linux) to be
installed before GSKit will install.

Linux on PPC32 / PPC64:
RHEL v5.0 requires compat-libstdc++-33-3.2.3-61 or later

Linux on x86:
Red Hat Enterprise Linux 4.0 ES requires compat-libstdc++-33-3.2.3-47.3
or later
Red Hat Enterprise Linux 5.0 ES requires compat-libstdc++- 33-3.2.3-61
or later

Linux on s390:
Red Hat Enterprise Linux 4.0 AS requires compat-libstdc++-33-3.2.3-47.3
or later
RHEL 5.0 requires compat-libstdc++-33-3.2.3-61 or later

Linux on x86_64:
RHEL 4.0 WS/AS/ES requires compat-libstdc++-33-3.2.3-47.3 or later
RHEL 5.0 ES requires compat-libstdc++-33-3.2.3-61 or later

Linux on s390x:
Red Hat Enterprise Linux 4.0 AS compat-libstdc++- 33-3.2.3-47.3 or
later
RHEL 5.0 compatlibstdc++-33-3.2.3-61 or later

3.4.3.4 Solaris

Shut down all WebSphere MQ applications and any other products that are
using GSKit. Before installing the WebSphere MQ fix pack uninstall the
old level of the GSKit packages using the commands:

pkgrm gsk7bas

pkgrm gsk7bas64

During the uninstallation process you will be warned that other
products have a dependency on the GSKit packages, reply 'Yes' to
continue the uninstallation process.

When installing the WebSphere MQ fix pack the new GSKit packages
gsk7bas and gsk7bas64 will be listed with the WebSphere MQ package.

If the system uses SSL channels, or will use SSL channels, these should
BOTH be selected for installation.

This is because both 64-bit and 32-bit processes may need to load GSKit
libraries.

The level of GSKit provided with this fix pack, 7.0.4.44, requires the
following system patches (listed by version of Solaris) to be installed
before GSKit is installed.

Solaris v8 for SPARC(for both 32 and 64 bit GSkit binaries):
108434-14 or later,
111327-05 or later,
108991 or later,
108993-31 or later,
108528-29 or later,
113648-03 or later,
116602-01 or later,
111317-05 or later,
111023-03 or later,
115827-01 or later

Solaris v9 for SPARC(for both 32 and 64 bit GSkit binaries):
111711-08 or later

3.4.3.5 Windows

On Windows the new version will be installed automatically when the
fix pack is installed and will be removed if the fix pack
is removed.


3.4.4 Installing GSKit version 8
--------------------------------

These instructions are applicable to GSKit version 8 only.

3.4.4.1 AIX

Compressed versions (.tar.Z files) of the GSKit Version 8 runtime
packages are placed in the directory into which you expand your
WebSphere MQ fix pack. Files providing both 32-bit and 64-bit support
are provided. Uncompress and install all these files.

1. Log in as root.
2. Change to the directory into which you expanded the Fix Pack.
3. Uncompress the .tar.Z files by using the following commands:

zcat gskcrypt32-8.0.14.26.aix.ppc.tar.Z | tar -xf -
zcat gskssl32-8.0.14.26.aix.ppc.tar.Z | tar -xf -
zcat gskcrypt64-8.0.14.26.aix.ppc.tar.Z | tar -xf -
zcat gskssl64-8.0.14.26.aix.ppc.tar.Z | tar -xf -

The string 8.0.14.26 represents the version number of GSKit being
installed and can vary as new modifications of GSKit are released.

4. Install GSKit v8 by using the following commands:

inutoc /tmp/MQ/gsk8
installp -acgqw -d /tmp/MQ/gsk8 GSKit8.gskcrypt32.ppc.rte \
GSKit8.gskssl32.ppc.rte \
GSKit8.gskcrypt64.ppc.rte \
GSKit8.gskssl64.ppc.rte

Note that /tmp/MQ represents the directory into which you expanded
the fix pack.

3.4.4.2 HP-UX

Compressed versions (.tar.Z files) of the GSKit Version 8 runtime
packages are placed in the directory into which you expand your
WebSphere MQ fix pack. Files providing both 32-bit and 64-bit support
are provided. Uncompress and install all these files.

1. Log in as root.
2. Change to the directory into which you expanded the Fix Pack.
3. Uncompress the .tar.Z files by using the following commands:

zcat gskcrypt32-8.0.14.26.hpux.arch.tar.Z | tar -xf -
zcat gskssl32-8.0.14.26.hpux.arch.tar.Z | tar -xf -
zcat gskcrypt64-8.0.14.26.hpux.arch.tar.Z | tar -xf -
zcat gskssl64-8.0.14.26.hpux.arch.tar.Z | tar -xf -

Note: WebSphere MQ does not support 32-bit SSL on HP-UX on Itanium.
Only the 64-bit files are provided.

The string 8.0.14.26 represents the version number of GSKit being
installed and can vary as new modifications of GSKit are released.

Note: arch represents your system architecture, for example "ia64".

4. Install GSKit v8 by using the following commands:

swinstall -s /tmp/MQ/gskcrypt32 gskcrypt32
swinstall -s /tmp/MQ/gskssl32 gskssl32
swinstall -s /tmp/MQ/gskcrypt64 gskcrypt64
swinstall -s /tmp/MQ/gskssl64 gskssl64

Note that /tmp/MQ represents the directory into which you expanded
the fix pack.

3.4.4.3 Linux

The GSKit Version 8 runtime packages are placed in the directory into
which you expand your WebSphere MQ fix pack.

RPM files providing both 32-bit and 64-bit support are provided. The
32-bit package names begin with gskcrypt32 or gskssl32. The 64-bit
package names begin with gskcrypt64 or gskssl64.

The 32-bit package must always be installed. Not all platforms support
both 32-bit and 64-bit SSL, so the 64-bit package is required only on
64-bit capable platforms.

1. Log in as root.
2. Change to the directory into which you expanded the Fix Pack.
3. Install the 32-bit packages by using the following command:

rpm -ivh gskcrypt32-8.0.14.26.linux.arch.rpm gskssl32-8.0.14.26.linux.arch.rpm

The string 8.0.14.26 represents the version number of GSKit being
installed. This value varies by architecture and as new modifications
of GSKit are released.

Note: arch represents your system architecture, for example "x86".

4. Optional: Install the 64-bit packages by using the following command:

rpm -ivh gskcrypt64-8.0.14.26.linux.arch.rpm gskssl64-8.0.14.26.linux.arch.rpm

See above for notes about "8.0.14.26" and "arch".

3.4.4.4 Solaris

Compressed versions (.tar.Z files) of the GSKit Version 8 runtime
packages are placed in the directory into which you expand your
WebSphere MQ fix pack. Files providing both 32-bit and 64-bit support
are provided. Uncompress and install all these files.

1. Log in as root.
2. Change to the directory into which you expanded the Fix Pack.
3. Uncompress the .tar.Z files by using the following commands:

zcat gskcrypt32-8.0.14.26.sun.arch.tar.Z | tar -xf -
zcat gskssl32-8.0.14.26.sun.arch.tar.Z | tar -xf -
zcat gskcrypt64-8.0.14.26.sun.arch.tar.Z | tar -xf -
zcat gskssl64-8.0.14.26.sun.arch.tar.Z | tar -xf -

The string 8.0.14.26 represents the version number of GSKit being
installed and can vary as new modifications of GSKit are released.

Note: arch represents your system architecture, for example "sparc".

4. Install GSKit v8 by using the following command:

pkgadd -d. gsk8cry32 gsk8ssl32 gsk8cry64 gsk8ssl64

3.4.4.5 Windows

Executable (.exe) files are placed in the directory into which you
expand your WebSphere MQ fix pack. Files providing both 32-bit and
64-bit support are provided. Run the appropriate files either
interactively or at the command prompt. If you need an accessible
version of the installer, use the unattended installation method.

* For an interactive 32-bit installation:

1. Double-click the gsk8crypt32.exe file and follow the
installation prompts, and progress through the wizard
following the prompts until the product is successfully
installed.
2. Repeat for the gsk8ssl32.exe file.

* For an interactive 64-bit installation:

1. Double-click the gsk8crypt64.exe file and follow the
installation prompts, and progress through the wizard
following the prompts until the product is successfully
installed.
2. Repeat for the gsk8ssl64.exe file.

* For a silent (unattended) 32-bit installation:

1. At the command prompt, enter the following commands:

gsk8crypt32.exe /s /v"/quiet"
gsk8ssl32.exe /s /v"/quiet"

* For a silent (unattended) 64-bit installation:

1. At the command prompt, enter the following commands:

gsk8crypt64exe /s /v"/quiet"
gsk8ssl64.exe /s /v"/quiet"

Following either an interactive or silent installation, update your
PATH environment variable to include the location of the GSKit Version
8 /bin and /lib folders.


3.4.5 Reverting to an earlier level of GSKit
--------------------------------------------
If you need to revert to an earlier level of GSKit you should uninstall
the currently installed level using the appropriate uninstall command
for your operating system and reinstall the required level from the
media on which it was supplied using the instructions that came with
it.

Note that you should normally use the highest level of GSKit required
by any product in use on the system.


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


3.5 Uninstalling
----------------
3.5.1 Prior to uninstallation
-----------------------------
You must ensure that all WebSphere MQ processes are stopped. 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

3.5.2 Uninstalling WebSphere MQ fix pack 7.0.1.10
-------------------------------------------------

3.5.2.1 AIX

1. Display the appropriate smit panel using this sequence:
2. Software Installation and Maintenance
Software Maintenance and Utilities
Reject Applied Software Updates (Use Previous Version)

Alternatively, use a fastpath command (smitty install_reject).
3. Complete the SOFTWARE name field. Enter MQM to restore all
applicable fileset updates to your installation.

Note: Although there is an option to restore only selected fileset
updates for WebSphere MQ for AIX, this still results in all applicable
fileset updates for the service update being restored.

4. Use the displayed default values for all other fields to reject the
current service level and reinstate the previous service or install
level.
5. Press Enter to display a confirmation message, before starting the
reject process. While the command runs, it displays progress messages
terminating with an Installp Summary table, confirming which components
of WebSphere MQ for AIX have been rejected.

3.5.2.2 HP-UX

1. Use the swremove command to remove the maintenance package from the
system. For example, to remove the 7.0.1.10 maintenance level, use the
command:

swremove MQSERIES,r=7.0.1.10

Make sure that autoselect_dependencies is set to true before you remove
any maintenance packages from the system.

3.5.2.3 Linux

1. Log in as root.
2. To find out which packages are installed on your machine, enter the
following:

rpm -q -a | grep MQSeries

Using the example given in Applying service, the above command returns:

MQSeriesRuntime-7.0.0-0
MQSeriesSDK-7.0.0-0
MQSeriesServer-7.0.0-0
MQSeriesRuntime-Uxxxxxx-7.0.1-10
MQSeriesSDK-Uxxxxxx-7.0.1-10
MQSeriesServer-Uxxxxxx-7.0.1-10

3. Remove all the updates applied at level 2, with the following commands:

rpm -ev MQSeriesRuntime-Uxxxxxx-7.0.1-10 \
MQSeriesSDK-Uxxxxxx-7.0.1-9 MQSeriesServer-Uxxxxxx-7.0.1-10

4. Repeat step 2 to check that the update packages have been removed:

MQSeriesRuntime-7.0.0-0
MQSeriesSDK-7.0.0-0
MQSeriesServer-7.0.0-0

3.5.2.4 Solaris

1. Use the pkgrm command to remove the latest service update from the
system.

pkgrm packagename

where packagename is the name of the package that you want to remove.
Note: Ignore any error messages of the form <shared pathname not
removed>.

2. If you have installed a WebSphere MQ client, and the client was
updated after installing the service level that is being removed, you
must specifically update your WebSphere MQ client installation again,
after the service level has been removed.

3.5.2.5 Windows

1. Ensure that you are logged on as an Administrator.
2. Ensure that all queue managers are stopped.
3. Ensure that all channel listeners are stopped.
4. Ensure that the IBM. WebSphere MQ Service has stopped.
Click
Start > Programs > IBM WebSphere MQ > Remove Fix Pack 7.0.1.10
5. Click Remove to start the process. This returns the installation to the
state it was in before the maintenance package was applied.

Note - Please also refer the Quick Beginnings manuals for more
information on how to install or remove the fix pack.

3.6 List of fixes
-----------------
Fixes included in WebSphere MQ v7.0.1.10 :

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



++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ ++
++ 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 are trademarks of Oracle 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 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":{"code":"SSFKSJ","label":"WebSphere MQ"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"APAR \/ Maintenance","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0.1.3;7.0.1;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

MQ WMQ

Document Information

Modified date:
17 June 2018

UID

swg27038425