Den Hub für das JMS-Transportprotokoll konfigurieren

Sie haben WebSphere MQ als Teil der Installation von WebSphere Business Integration Connect installiert. WebSphere MQ enthält eine JMS-Implementierung, mit der Sie eine JMS-Kommunikation konfigurieren können.

WebSphere MQ ist allerdings nicht standardmäßig für JMS konfiguriert. Dieser Abschnitt enthält die Schritte zum Konfigurieren von JMS.

Verzeichnis für JMS erstellen

Zunächst erstellen Sie ein Verzeichnis für JMS. Angenommen, Sie wollen z. B. ein Verzeichnis namens JMS im Verzeichnis c:\temp einer Windows-Installation erstellen. Hierzu müssen Sie die folgenden Schritte ausführen:

  1. Öffnen Sie einen Windows-Explorer.
  2. Öffnen das Verzeichnis C:\temp.
  3. Erstellen Sie einen neuen Ordner namens JMS.

Die Standard-JMS-Konfiguration modifizieren

In diesem Abschnitt aktualisieren Sie die Datei JMSAdmin.config, die Teil der WebSphere MQ-Installation ist, um die Kontextfactory und die Provider-URL-Adresse zu ändern.

  1. Navigieren Sie zum Verzeichnis Java\bin von WebSphere MQ. In einer Windows-Installation würden Sie z. B. zu C:\IBM\MQ\Java\bin navigieren.
  2. Öffnen Sie die Datei JMSAdmin.config mit einem einfachen Texteditor, wie z. B. Editor oder vi.
  3. Fügen Sie das Zeichen # am Anfang der folgenden Zeilen hinzu:
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
     PROVIDER_URL=ldap://polaris/o=ibm,c=us
     
  4. Entfernen Sie das Zeichen # vom Anfang der folgenden Zeilen:
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory 
     #PROVIDER_URL=file:/C:/JNDI-Directory
     
  5. Ändern Sie die Zeile PROVIDER_URL=file:/C:/JNDI-Directory so, dass der Name dem Namen des JMS-Verzeichnisses gleicht, das Sie in Verzeichnis für JMS erstellen definiert haben. Wenn Sie z. B. das Verzeichnis c:/temp/JMS definiert haben, würde die Zeile wie folgt aussehen:
    PROVIDER_URL=file:/c:/temp/JMS
     
  6. Speichern Sie die Datei.

Warteschlangen und den Kanal erstellen

In diesem Abschnitt erstellen Sie mit WebSphere MQ die Warteschlangen, die Sie zum Senden und Empfangen von Dokumenten verwenden, und den Kanal für diese Kommunikation. Es wird davon ausgegangen, dass ein Warteschlangenmanager erstellt wurde. Der Name des Warteschlangenmanagers sollte eingesetzt werden, wo <name des warteschlangenmanagers> in den folgenden Schritten aufgeführt wird. Es wird ferner davon ausgegangen, dass ein Listener für diesen Warteschlangenmanager am TCP-Port 1414 gestartet wurde.

  1. Öffnen Sie eine Eingabeaufforderung.
  2. Geben Sie den folgenden Befehl ein, um den WebSphere MQ-Befehlsserver zu starten:
    strmqcsv <name des warteschlangenmanagers>
     
  3. Geben Sie den folgenden Befehl ein, um die WebSphere MQ-Befehlsumgebung zu starten:
    runmqsc <name des warteschlangenmanagers>
     
  4. Geben Sie den folgenden Befehl ein, um eine WebSphere MQ-Warteschlange zu erstellen, die Eingangsdokumente enthalten soll, die an den Hub gesendet wurden:
    def ql(<warteschlangenname>)
     

    Geben Sie z. B. Folgendes ein, um eine Warteschlange namens JMSIN zu erstellen:

    def ql(JMSIN)
     
  5. Geben Sie den folgenden Befehl ein, um eine WebSphere MQ-Warteschlange zu erstellen, die Dokumente enthalten soll, die vom Hub gesendet wurden:
    def ql(<warteschlangenname>)
     

    Geben Sie z. B. Folgendes ein, um eine Warteschlange namens JMSOUT zu erstellen:

    def ql(JMSOUT)
     
  6. Geben Sie den folgenden Befehl ein, um einen WebSphere MQ-Kanal zu erstellen, der für Dokumente verwendet werden soll, die an den und vom Hub gesendet wurden:
    def channel(<kanalname>) CHLTYPE(SVRCONN)
     

    Geben Sie z. B. Folgendes ein, um einen Kanal namens java.channel zu erstellen:

    def channel(java.channel) CHLTYPE(SVRCONN)
     
  7. Geben Sie den folgenden Befehl ein, um die WebSphere MQ-Befehlsumgebung zu verlassen:
    end 
     

Ihrer Umgebung eine Java-Laufzeit hinzufügen

Geben Sie den folgenden Befehl ein, um eine Java-Laufzeit Ihrem Systempfad hinzuzufügen:

set PATH=%PATH%;<pfad zum installationsverzeichnis>\_jvm\jre\bin
 

Dabei steht installationsverzeichnis für das Verzeichnis, in dem WebSphere Business Integration Connect installiert ist.

Die JMS-Konfiguration definieren

Führen Sie die folgenden Schritte aus, um die JMS-Konfiguration zu definieren:

  1. Wechseln Sie in das WebSphere MQ-Java-Verzeichnis (<pfad zum Websphere MQ-installationsverzeichnis>\java\bin)
  2. Starten Sie die JMSAdmin-Anwendung, indem Sie den folgenden Befehl eingeben:
    JMSAdmin
     
  3. Definieren Sie einen neuen JMS-Kontext, indem Sie die folgenden Befehle an der Eingabeaufforderung InitCtx> eingeben:
    define ctx(jms) 
     
    change ctx(jms) 
     
  4. Geben Sie an der Eingabeaufforderung InitCtx/jms> die folgende JMS-Konfiguration ein:
    define qcf(WBICHub) 
         tran(CLIENT) 
         host(<Ihre_IP-adresse>)
         port(1414) 
         chan(java.channel) 
         qmgr(<name des warteschlangenmanagers>)
     
    define q(<name>) queue(<warteschlangenname>) qmgr(<name des warteschlangenmanagers>)
     
    define q(<name>) queue(<warteschlangenname>) qmgr(<name des warteschlangenmanagers>)
     
    end 
     

Das folgende Beispiel stellt eine JMSAdmin-Sitzung dar, mit der die Verbindungsfactory für Warteschlangen als WBICHub mit einer IP-Adresse von sample.ibm.com definiert wird, wo sich der MQ-Warteschlangenmanager (<name des warteschlangenmanagers> von sample.queue.manager) befindet. Das Beispiel verwendet die JMS-Warteschlangennamen und den Kanalnamen, die Sie in Warteschlangen und den Kanal erstellen erstellt haben. Beachten Sie, dass die Benutzereingabe an der Eingabeaufforderung > erfolgt.

InitCtx> define ctx(jms)
 InitCtx> change ctx(jms) 
 InitCtx/jms> define qcf(WBICHub) 
     tran(CLIENT) 
     host(sample.ibm.com) 
     port(1414) 
     chan(java.channel) 
     qmgr(sample.queue.manager) 
 InitCtx/jms> define q(inQ) queue(JMSIN) qmgr(sample.queue.manager) 
 InitCtx/jms> define q(outQ) queue(JMSOUT) qmgr(sample.queue.manager) 
 InitCtx/jms>end 
 

Copyright IBM Corp. 1997, 2004