Troubleshooting
Problem
A WebSphere MQ queue manager is failing to convert a message properly, and you need to collect MustGather data to find a solution.
Environment
These instructions apply only to WebSphere MQ V5.3.1 and V5.3 on HP NonStop Server. Refer to the IBM MQ Read First page for instructions on other operating systems:
Resolving The Problem
Please answer these questions about the problem and then follow the steps below:
- What data conversion problem did you observe on the system?
- What is the MQMD.Format of the message and its original MQMD.CodedCharSetId (CCSID)?
- What is the intended MQMD.CodedCharSetId to which the message should be converted?
- Which specific characters in the message are invalid, and which did you expect to see instead?
Step 1: Generate Data
If the data conversion problem is reproducible or is happening right now, generate data to provide more information about the problem:
- Guardian users should run the osh TACL command to switch to the OSS environment. Then, browse the message immediately after it has been put to WebSphere MQ using a program like the opt/mqm/samp/bin/amqsbcg sample. It is important to see the message in hex in order to examine the MQMD header and the byte values of the message data. For example:
- Alternatively, generate a trace of the queue manager while the application is putting the message.
- If the message contents are corrupted while flowing over an MQ channel with CONVERT(YES), generate a trace of the queue manager while the message is flowing across the sending channel.
- Browse the message using a program like the opt/mqm/samp/bin/amqsbcg sample program just before it is retrieved by the target application.
- If the message contents are corrupted when the target application gets the message, generate a trace of the queue manager while the application is getting the message.
Browsing My.Queue on queue manager QMA
osh> amqsbcg My.Queue QMA > My.Queue.browse.txt
Step 2: Collect Data
- Record the MQ version and maintenance level.
- Record the operating system version and maintenance level.
- On the sending side, use runmqsc to record your queues, channels and channel status information. If any command gives an error, carry on with the others:
- On the receiving side, use runmqsc to record your queues, channels and channel status information. If any command gives an error, carry on with the others:
- Use the sdcp script to package your files for IBM, including files containing the output from the commands listed in Step 1 and 2.
DISPLAY QMGR ALL
DISPLAY QLOCAL(*) ALL
DISPLAY QALIAS(*) ALL
DISPLAY QREMOTE(*) ALL
DISPLAY CHANNEL(*) ALL
DISPLAY CHSTATUS(*) ALL
DISPLAY QMGR ALL
DISPLAY QLOCAL(*) ALL
DISPLAY CHANNEL(*) ALL
DISPLAY CHSTATUS(*) ALL
Step 3: Send Data to IBM
- Send your data to the IBM ECuRep repository by email to websphere_support@ecurep.ibm.com, or by standard or secure HTTP or FTP.
- While the data is transferring, send an email or use the IBM Service Request tool to update your PMR with your description of the problem and of the data you are sending.
- Contact your country representative if you need to speak to an IBM technical support representative, or in the US call 1-800-IBM-SERV. Refer to the IBM Software Support Handbook for more information on working with IBM.
A good description of the problem and the data is the most important information you can provide to IBM. Please do not send data without providing a description!
Product Synonym
WebSphere MQ WMQ
Was this topic helpful?
Document Information
Modified date:
22 June 2018
UID
swg21176955