Knowledge Collection: Application/API for WebSphere MQ



This Knowledge Collection is a focused compilation of links to documents for Application/API for WebSphere MQ.


Collecting documentation for Application/API problems

1. Read First: Collect and analyze WebSphere MQ MustGather data on Linux, UNIX & Windows (1229861)
If you are experiencing a problem with WebSphere MQ on an AIX, HP-UX, Linux, Solaris or Windows system, you need a way to collect and analyze data to find a solution. This index links to directions for collecting and analyzing data (often called "MustGather" data) for a wide variety of WebSphere MQ issues.


1. Problems with Wily Introscope when exploiting the MQ JMS client from WebSphere Application Server (1605479)
You are seeing several types of errors that are difficult to explain, such as memory leaks and disconnections.

2. Knowledge Collection: Java Message Service (JMS) for WebSphere Application Server (7020347)
This Knowledge Collection is a focused compilation of links to documents for Java Message Service (JMS).

3. MQRC and MQCC Understanding MQ reason codes and completion codes 2030, 2033, 2035, 2080, 2085, 2092, 2110, 2189 (1167821)
WebSphere MQ program fails to process an MQ API call. MQ notifies the program of the failure, by returning a completion code (MQCC), and a reason code (MQRC).

4. 2085 MQRC UNKNOWN OBJECT NAME (1166940)
Your program fails with reason code 2085 (MQRC_UNKNOWN_OBJECT_NAME). 2085 0x00000825 MQRC UNKNOWN OBJECT NAME

5. 2033 MQRC NO MSG AVAILABLE (1232330)
You attempt to get a message from your queue. The getting application fails with the following: 2033 0x000007f1 MQRC_NO_MSG_AVAILABLE

Your first MQGET fails with MQRC_TRUNCATED_MSG_FAILED. This happens because your message buffer is too small. You increased the buffer, and did another MQGET. When you process the message, you find the data is not converted.

7. After upgrading to MQ V7, MQMessage.format inside a base Java V6 application returns incorrect value of "MQSTR" instead of "MQHRF2" when getting JMS messages (1472676)
You have a WebSphere MQ V6 Base Java™ application that gets different types of messages (JMS, C-based from amqsput, etc) from a queue in an MQ V6 queue manager.

8. mqjbnd05.dll is not found after installing MQ V7 (1420737)
After installing WebSphere MQ V7, you are unable to find the mqjbnd05.dll.

9. WebSphere MQ v7 MQJE086: End of file exception (1504021)
Your WebSphere MQ Java client application read messages without error at WebSphere MQ v6, however, after upgrading to WebSphere MQ v7 you start seeing the error MQJE086: End of file exception

10. How to extract Queue Manager Name from CF / QCF in your J2EE JMS application (1260441)
You have a J2EE JMS application deployed to WebSphere Application Server and need to extract the WebSphere MQ Queue Manager (Qmgr) name programmatically.

11. MQRC_HOBJ_ERROR Reason Code 2019 when MQPUT is issued from a different DB2 stored procedure than the MQOPEN (1213692)
You pass a Unit of Work (UOW) from DB2 through RRS under control of WLM to WebSphere MQ.

12. MQRC 2080 - Resize buffer and continue to get MQRC_TRUNCATED_MSG_FAILED (1220396)
Your application receives a 2080 (MQRC_TRUNCATED_MSG_FAILED). The application then resizes the buffer to handle the new message size. Intermittently the 2080 error is received again.

13. AMQ2068 error when accessing qremote (remote queue) (1179685)
You are trying to display the current depth of a qremote (remote queue). You receive error, AMQ2068 MQRC_SELECTOR_NOT_FOR_TYPE.

Webcast Replays

1. Open Mic Replay: WebSphere MQ Problem Diagnostics - Reading Traces (7018159)
This session gives you the opportunity to ask questions related to using traces to diagnose MQ and application problems..

2. Webcast replay: Installation and Migration of WebSphere MQ V7 including Publish/Subscribe Configuration (7016064)
This WebSphere Support Technical Exchange is designed to present common pitfalls during the installation and migration for WebSphere MQ V7 for Unix and Windows.

3. Webcast replay: How to gather, format and interpret MQ for z/OS diagnostic traces (7014667)
This WebSphere Support Technical Exchange summarizes how to gather, diagnose, and interpret WebSphere MQ diagnostic traces, including MSTR internal trace, CHIN internal trace, channel line trace, GTF trace and basic MQ Java and JMS traces.

developerWorks Articles

1. Using WebSphere MQ Telemetry and Pachube to connect to remote sensors and devices
This article shows you how to use the new WebSphere MQ Telemetry function to bridge the two networks and share data, and includes a downloadable utility to facilitate the integration.

2. Connecting WebSphere MQ with social networks: Twitter notifications for queue managers and MQ applications
The examples in this article use WebSphere MQ and the Twitter API with JEE technology (simple message-driven beans) targeted at the WebSphere Application Server Community Edition runtime.

3. Grouping messages using the WebSphere MQ Java and JMS APIs
This article introduces the message group support in WebSphere MQ, and explains how you can use it to provide logical message ordering and enable the grouping of related messages. The article demonstrates grouping using the WebSphere MQ Java classes and shows you how to implement this same behavior using the JMS API.

Other WebSphere MQ articles on developerWorks


1. Is it safe?
Security requirements vary from application to application.  WebSphere MQ is no different.  For instance, if you ignore security considerations for WebSphere MQ on i5/OS, UNIX and Windows systems, you simply won't be able to implement WebSphere MQ.  Ignoring these on WebSphere MQ for z/OS means any user will be able to access and change your MQ resources.

2. MQ API Exerciser
What ever happened to the MQ API Exerciser? I have used this tool in prior versions of WebSphere MQ and I can't find it in WebSphere MQ V7.  My mistake it is included in V7, but it's hard to find.

3. WebSphere MQ domain user security
WebSphere MQ running on a Windows platform can participate in a domain.  Sometimes, when participating in a domain, there are domain users who will access WebShere MQ objects (queue managers, queues, channels, etc.).  There might be domain user accounts that will manage the objects.  If so, then the WebSphere MQ product should be configured so that it will allow domain account access.


1. Technical Introduction to IBM WebSphere MQ
This course is a technical overview of IBM WebSphere MQ. It provides a conceptual understanding of messaging and queuing as implemented by IBM WebSphere MQ.


1. IBM Redbooks: Universal Messaging with IBM WebSphere MQ
WebSphere MQ provides simple, rapid, reliable, and secure transport of messages and data offering flexible connectivity for applications, web services, and other programming environments.

2. IBM Redbooks: WebSphere MQ Telemetry
If you are experiencing a problem with WebSphere MQ on an AIX, HP-UX, Linux, Solaris or Windows system, you need a way to collect and analyze data to find a solution. This index links to directions for collecting and analyzing data (often called "MustGather" data) for a wide variety of WebSphere MQ issues.

Knowledge Collections for WebSphere MQ

Knowledge Collection: Index for WebSphere MQ

Definition of a Knowledge Collection
A Knowledge Collection is a focused compilation of links to documents that share a common theme. Knowledge Collections are navigation aids that organize content to help users quickly find relevant information. Knowledge Collections are not designed to be an all-inclusive list of all documents dealing with the specific theme.

Product Alias/Synonym

WebSphere MQ WMQ

Rate this page:

(0 users)Average rating

Add comments

Document information

More support for:

WebSphere MQ
Application / API

Software version:

2.1, 3.0, 5.3, 5.3.1, 6.0, 7.0, 7.1, 7.5, 8.0

Operating system(s):

AIX, HP Itanium, HP NonStop, HP-UX, Linux, OpenVMS, Solaris, TRU64 UNIX, Tandem NSK, VSE, Windows, i5/OS, z/OS

Software edition:

All Editions

Reference #:


Modified date:


Translate my page

Machine Translation

Content navigation