Using runmqsc tool to clear messages from Embedded Messaging queues
 Technote (troubleshooting)
 
Problem(Abstract)
Errors can occur when the Embedded Messaging queues become full in IBM® WebSphere® Application Server V5.0 and V5.1 releases. Use the runmqsc tool to manage queues, change their properties, and clear messages from a queue.

The following error message is a likely symptom of a full message queue:

WMSG0031E: Exception processing JMS Message for MDB ConnectorMDB, JMSDestination jms/ConnectorQueue : com.ibm.ejs.container.UnknownLocalException: ; nested exception is: com.ibm.ws.exception.WsEJBException: nested exception is: java.lang.OutOfMemoryError
 
Cause
Full embedded message queues can cause errors in WebSphere Application Server.

Note: the instructions in this technote should only be used when requested by IBM support.

 
Resolving the problem
  1. Change to the WebSphere MQ_home/bin directory.

  2. Run runmqsc.

  3. After the runmqsc shell runs, runmqsc requires that you specify the queue manager name when runmqsc starts. Specify the embedded queue manager name as WAS_nodename_servername, where nodename is the WebSphere Application Server node name and servername is the Application Server on which Embedded Messaging is running. Use jmsserver as the servername when the node has been federated to a cell.

  4. Type the command clear ql('WQ_MQQueueName') to clear the queue MQQueueName from the runmqsc prompt,

  5. For WebSphere Application Server Embedded Messaging queue names, you must prepend 'WQ_' to the queue name that is defined in WebSphere Application Server; use the single quotes as shown below:





Related information

For all IBM WebSphere MQ manuals:
http://www-306.ibm.com/software/integration/wmq/library/library53.html

Using the runmqsc tool, search for runmqsc in the MQ Information Center

Using the MQSC commands that can be issued from the runmqsc shell:
http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss?CTY=US&FNC=SRX&PBL=SC34-6055-03
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Java Message Service (JMS)
Operating system(s): Windows
Software version: 5.1.1
Software edition:
Reference #: 1175096
IBM Group: Software Group
Modified date: Aug 16, 2004