MQJE001: Completion Code '2', Reason '2298' in SystemErr.log when using WebSphere Application Server 7 with WebSphere MQ 6.0.2.4 or earlier

Technote (troubleshooting)


Problem(Abstract)

You have a J2EE application that runs fine with WebSphere Application Server 6.1 with Bindings transport type for the connection factory.

You migrate your application server from Version 6.1 to 7.0.0.x and the migration logs do not show any problems.
When you run the application you see this error in the SystemErr.log:

... SystemErr R com.ibm.mq.MQException: MQJE001: Completion Code '2', Reason '2298'.
... SystemErr R MQJE001: Completion Code '2', Reason '2298'.

You use the "mqrc 2298" command to find out the short name for this reason code:
2298 0x000008fa MQRC_FUNCTION_NOT_SUPPORTED

Cause

You capture the JMS trace in WebSphere Application Server as mentioned in the following technote 1199176

http://www.ibm.com/support/docview.wss?rs=171&uid=swg21199176
Enabling JMS trace for releases of WebSphere Application Server V5.0 and V6.0

Note: Even though the title does not explicitly include WAS 7, the same instructions for WAS 6 apply to WAS 7.


The trace log shows that the version of the MQ Resource Adapter that is being used is 7.0.0.0:

[10/9/09 2:46:12:890 EDT] 0000005f WMQRAClientIn < getVersion
(com.ibm.ws.wmqra.registration.WMQRAClientInstall) [:/6c8a6c8a] Exit
7.0.0.0

[10/9/09 2:47:00:928 EDT] 00000000 < UOW=
source=com.ibm.ws.wmqra.registration.WMQRAClientInstall
method=getVersion (com.ibm.ws.wmqra.registration.WMQRAClientInstall)
[:/75ea75ea] org=IBM prod=WebSphere component=Application Server
thread=[main]
Exit parm0=7.0.0.0

However, the following technote (1248089) indicates that the version of the MQ Resource Adapter that is shipped with WebSphere Application 7.0.0.x is different (such as: WAS 7.0.0.5 is MQ RA 7.0.1.0):
http://www.ibm.com/support/docview.wss?rs=171&uid=swg21248089
Which version of MQ is shipped with WebSphere Application Server


The following entry in the trace shows the reason code 2298:

[10/9/09 2:54:54:009 EDT] 00000015 R UOW= source=SystemErr org=IBM
prod=WebSphere component=Application Server thread=[WebContainer : 0]
10/09/09 02:54:54:009 EDT (ERR,1):
code: initQManager():
MQException caught! Completion code 2 Reason code 2298

Thus, part of the problem seems that the error "function not supported" is due to the use of an older version of the MQ Resource Adapter (7.0.0.0) instead of the latest one (7.0.1.0)

In addition, the bindings transport type is not supported when working with an MQ 6.0.2.4 (or earlier) queue manager when using WebSphere Application Server 7, as mentioned in the technote (1316899):
http://www.ibm.com/support/docview.wss?rs=171&uid=swg21316899
Information about using the WebSphere MQ messaging provider for WebSphere Application Server Version 7.0

The minimum version of MQ should be 6.0.2.5.


Resolving the problem

There are 2 parts to the solution:


+++
+++ Part 1: Upgrade the WebSphere MQ Queue Manager to v7.0.1 or later
+++

The MQ Refresh Packs (CSDs) and Fix Packs are available from our MQ support web site:
http://www.ibm.com/software/integration/wmq/support/

In the section "Download" in this web site, click on "Recommended Fixes".
You will be taken to another web page where you can select the desired version:
IBM WebSphere MQ Version 7.0

Then follow the prompts for the desired operating system.
Finally, you can select the desired package to download.

While you are at the web page that has the download material, you can take a look at the corresponding README file to see the cumulative history of all the changes for all the fix packs until the present one.

The installation instructions are available in the corresponding manual:
"MQ Quick Beginnings for <platform>".

IBM WebSphere MQ Version 7.5
IBM WebSphere MQ Version 7.1
IBM WebSphere MQ Version 7.0

Then follow the prompts for the desired operating system.
Finally, you can select the desired package to download.

While you are at the web page that has the download material, you can take a look at the corresponding README file to see the cumulative history of all the changes for all the fix packs until the present one.

MQ V7.0:
The installation instructions are available in the corresponding manual:
"MQ Quick Beginnings for <platform>".
This manual is available in the online MQ Information Center V7.0 at:
http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp

MQ 7.1:
The installation instructions are available in the online MQ Information Center V7.1 at:
http://publib.boulder.ibm.com/infocenter/wmqv7/v7r1/index.jsp

MQ 7.5:
The installation instructions are available in the online MQ Information Center V7.5 at:
http://publib.boulder.ibm.com/infocenter/wmqv7/v7r5/index.jsp
If you would prefer to use a PDF file for sections of the Information Center, restarting with MQ 7.5, you can download the PDF files from:
http://pic.dhe.ibm.com/infocenter/wmqv7/v7r5/topic/com.ibm.mq.pro.doc/q001040_.htm

WebSphere MQ > Product overview
WebSphere MQ 7.5 PDF documentation


+++
+++ Part 2: Adjusting the WebSphere MQ resource adapter configuration when migrating profiles
+++

There is a known problem in which an out of date WebSphere MQ Resource Adapter ends up being the one in use on a system updated to a later WebSphere Application Server fix pack. This is because the WebSphere Application Server 7.0.0.0 profile management tool unpacked the WebSphere MQ Resource Adapter into the profile, which is subsequently not updated when a WebSphere Application Server fix pack is later applied.

It is necessary to perform the steps mentioned below in order to ensure that the most up-to-date version of the WebSphere MQ Resource Adapter is used:

WebSphere Application Server Version 7
[Fix Pack 1 or later]
http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/com.ibm.websphere.soafep.multiplatform.doc/info/ae/ae/tmm_mig.html
Adjusting the WebSphere MQ resource adapter configuration when migrating profiles between maintenance level 7.0.0.0 and later levels


Related information

End Of Support for MQ V6

Product Alias/Synonym

WMQ MQ

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
Configuration

Software version:

6.0, 6.0.1, 6.0.2, 7.0, 7.0.1, 7.1, 7.5

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows

Reference #:

1410032

Modified date:

2009-11-11

Translate my page

Machine Translation

Content navigation