Das Beispiel zeigt wie man mittels JMS eine MQ Nachricht verschicken und empfangen kann.
Die Architektur steht hier nicht im Vordergrund, das nur die MQ Kommunikation.

Für das Versenden von MQ Nachrichten ist ein MQQueueSender verantwortlich, entsprechendes gilt für das Empfangen (MQQueueReceiver).
Da bei MQ mehrere Clients Nachrichten verschicken können und jedem Client nur seine Antworten interessieren, gibt es die Möglichkeit dem Receiver einen Filter (Selector) anzugeben. Mit diesem Selector werden dann nur die MQ Nachrichten geliefert (empfangen), welche die Kriterien erfüllen.
Hier lohnt es sich (nur) Correlation und Message ID zu nutzen, da andere Eigenschaften zu langsam in der Filterung sind.
Bei der Correlation ID muss noch das Präfix ‘ID:’ angehangen werden, welches bei der Message ID schon automatisch vorhanden ist.

Nachfolgend ein kleines MQ JMS Beispiel

import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.Session;
import javax.jms.TextMessage;

import com.ibm.jms.JMSTextMessage;
import com.ibm.mq.jms.JMSC;
import com.ibm.mq.jms.MQQueue;
import com.ibm.mq.jms.MQQueueConnection;
import com.ibm.mq.jms.MQQueueConnectionFactory;
import com.ibm.mq.jms.MQQueueReceiver;
import com.ibm.mq.jms.MQQueueSender;
import com.ibm.mq.jms.MQQueueSession;
import com.ibm.msg.client.wmq.v6.base.internal.MQC;

public class TestMQJMSPlain {

     public static void main(String[] args) {

         MQQueueConnectionFactory cf = new MQQueueConnectionFactory();

         try {

           cf.setHostName("...");
           cf.setPort(1415);
           cf.setTransportType(JMSC.MQJMS_TP_CLIENT_MQ_TCPIP);
           cf.setQueueManager("...");
           cf.setChannel("SYSTEM.DEF.SVRCONN");
           String qIn = "...";
           String qOut = "...";

           MQQueueConnection connection = (MQQueueConnection) cf.createQueueConnection();
           // create a new Session, which is not transacted
           MQQueueSession session = (MQQueueSession) connection.createQueueSession(false, Session.AUTO_ACKNOWLEDGE);
           // create queues
           MQQueue queueRead = (MQQueue) session.createQueue(qIn);
           MQQueue queueWrite = (MQQueue) session.createQueue(qOut);
           // if the client on the other side is a non-jms client set this property
           queueWrite.setTargetClient(JMSC.MQJMS_CLIENT_NONJMS_MQ);

           // create a sender
           MQQueueSender sender =  (MQQueueSender) session.createSender(queueWrite);
           MQQueueReceiver receiver = null;      

           // create the message which will be sent over MQ
           JMSTextMessage message = (JMSTextMessage) session.createTextMessage(dat);
          // define the message type (not really necessary, depends from the client on the other side)
          message.setJMSType(MQC.MQFMT_STRING);
          // set a correlation ID
          message.setJMSCorrelationID("MyIdSomethingElse" + System.currentTimeMillis());
          // set the replay queue
          message.setJMSReplyTo(queueRead);

          // lets start the connection
          connection.start();

          // send the JMS-Message
          sender.send(message);

          // create the selector to retrieve only the right response
          // the combination of message and correlation ID depends the individually defined constraints
          // it is wise to use the correlation and message ID for the selector, cause this are
          // faster as some other properties
          // Hint: the format for correlation ID is
          // JMSCorrelationID = 'ID:AF01CE....hex string...'
          // the prefix 'ID' is mandatory. However the message ID contains the fragment 'ID:'
          String selector = "JMSCorrelationID = 'ID:" + dumpId2Hex(message.getJMSCorrelationIDAsBytes()) +
                                 "' AND JMSMessageID = '" + message.getJMSMessageID() + "'";

          // create a receiver with the defined selector
          receiver = (MQQueueReceiver) session.createReceiver(queueRead, selector);

          // receive the response (with match the filter in the selector). This call blocks max. 20000 ms
          Message receivedMessage = receiver.receive(20000);

          // check if message is received and a text message
          if (receivedMessage instanceof TextMessage) {
               // get the content...
              String replyString = ((TextMessage) receivedMessage).getText();
         }

         // close everything...
         sender.close();
         receiver.close();
         session.close();
         connection.close();		    

           }
	    catch (JMSException jmsex) {
	    	log.error("JMSException", jmsex);
	    }
	    catch (Exception ex) {
	    	log.error("An other error occurred.", ex);
	    }
     }
}

$> ls
copyright                              MQSeriesMsg_hu-7.0.0-0.i386.rpm
gsk7bas-7.0-4.14.i386.rpm              MQSeriesMsg_it-7.0.0-0.i386.rpm
ibm-java2-i386-sdk-5.0-5.0.i386.rpm    MQSeriesMsg_ja-7.0.0-0.i386.rpm
lap                                    MQSeriesMsg_ko-7.0.0-0.i386.rpm
licenses                               MQSeriesMsg_pl-7.0.0-0.i386.rpm
mqlicense.sh                           MQSeriesMsg_pt-7.0.0-0.i386.rpm
MQSeriesClient-7.0.0-0.i386.rpm        MQSeriesMsg_ru-7.0.0-0.i386.rpm
MQSeriesConfig-7.0.0-0.i386.rpm        MQSeriesMsg_Zh_CN-7.0.0-0.i386.rpm
MQSeriesEclipseSDK33-7.0.0-0.i386.rpm  MQSeriesMsg_Zh_TW-7.0.0-0.i386.rpm
MQSeriesFTA-7.0.0-0.i386.rpm           MQSeriesRuntime-7.0.0-0.i386.rpm
MQSeriesJava-7.0.0-0.i386.rpm          MQSeriesSamples-7.0.0-0.i386.rpm
MQSeriesJRE-7.0.0-0.i386.rpm           MQSeriesSDK-7.0.0-0.i386.rpm
MQSeriesKeyMan-7.0.0-0.i386.rpm        MQSeriesServer-7.0.0-0.i386.rpm
MQSeriesMan-7.0.0-0.i386.rpm           MQSeriesTXClient-7.0.0-0.i386.rpm
MQSeriesMsg_cs-7.0.0-0.i386.rpm        PreReqs
MQSeriesMsg_de-7.0.0-0.i386.rpm        readadd.txt
MQSeriesMsg_es-7.0.0-0.i386.rpm        READMEs
MQSeriesMsg_fr-7.0.0-0.i386.rpm

Bevor die Installation begonnen werden kann, muss die Lizenz akzeptiert werden:

$>./mqlicense.sh -accept

Zur Installation des MQ Servers reicht folgendes:

$>rpm -ivh --nodeps MQSeriesRuntime-7.0.0-0.i386.rpm MQSeriesServer-7.0.0-0.i386.rpm

Das Flag –nodeps ist notwendig, um nicht die Abhängigkeit zu /bin/sh aufzulösen.

Nach der Installation gibt es einen neuen User mqm. Dieser hat die Verwaltungs-Rechte für den MQServer.

Um einen Queue Manager (qm.world) zu erstellen, der eine Queue (q.one) beinhaltet sind folgende Befehle notwendig:

mqm:$> crtmqm -q qm.world
mqm:$> strmqm
mqm:$> runmqsc
define qlocal (q.one)
end

Mit -q wird eine Standard-Queue definiert, somit braucht man bei den restlichen Befehlen keine QueueManager-Angaben machen.

Zum Testen kann man die Beispiel-Programme verwenden:

mqm:/opt/mqm/samp/bin$> ./amqsput Q.ONE
Sample AMQSPUT0 start
target queue is Q.ONE
Das ist ein Beispieltext mit wenig Inhalt etc.

Mit der Eingabe einer leeren Zeile kommt man aus dem Programm raus. In dem Beispiel wurde ein Satz in die Queue geschrieben. Zum Lesen aus der Queue:

mqm:/opt/mqm/samp/bin$> ./amqsget Q.ONE

Der Server ist jetzt installiert und funktionstüchtig. Nun wird der Client installiert. Zum Testen auch auf dem gleichen Rechner.

$>rpm -ivh --nodeps MQSeriesClient-7.0.0-0.i386.rpm

Um mit dem Server zu kommunizieren benötigt man noch einen Channel:

mqm:$> runmqsc
define channel (ch.one) chltype (svrconn) trptype (tcp) mcauser ('mqm')
define listener (l.one) trptype (tcp) control (qmgr)
start listener (l.one)
end

Beim dem Listener wird der Standardport genutzt (1414, ansonsten “port (…)” hinzufügen).

Dem Client muss der Host und der Channel mitgeteilt werden:

$>export MQSERVER='CH.ONE/TCP/localhost'

Um Daten in die Queue zu schreiben bzw. zu lesen existieren auch hierfür Beispielprogramme:

mqm:/opt/mqm/samp/bin$> ./amqsputc Q.ONE qm.world
Ein Text vom Client.
mqm:/opt/mqm/samp/bin$> ./amqsgetc Q.ONE qm.world

Man beachte jeweils das “c” an den Programmnamen.

Somit sind Server und Client installiert. Möchte man nun mit Java auf die Queues zugreifen, benötigt man die entsprechenden Bibliotheken:

rpm -ivh --nodeps MQSeriesJava-7.0.0-0.i386.rpm

Die libs sind unter

$>ls /opt/mqm/java/lib
CL3Export.jar                  com.ibm.mq.pcf.jar       jta.jar
CL3Nonexport.jar               com.ibm.mq.postcard.jar  ldap.jar
com.ibm.mq.commonservices.jar  com.ibm.mq.soap.jar      libmqjbnd.so
com.ibm.mq.defaultconfig.jar   connector.jar            libmqjexitstub02.so
com.ibm.mq.headers.jar         dhbcore.jar              libPgmIpLayer.so
com.ibm.mq.jar                 fscontext.jar            OSGi
com.ibm.mq.jmqi.jar            jca                      providerutil.jar
com.ibm.mqjms.jar              jms.jar                  rmm.jar
com.ibm.mq.jms.Nojndi.jar      jndi.jar                 soap

zu finden.

Demnächst folgt ein Beitrag zur Java Entwicklung mit MQ.

[Update 23.06.2009]
Ein Java Beispiel mit JMS gibt es nun auch.

Links:

[1] IBM WebSphere MQ

[2] IBM WebSphere MQ 7, Trail-Download. (Zugangsdaten sind notwendig, kostenlose Registrierung ist möglich)

[3] IBM Help: WebSphere MQ Linux install