Über den WebSphere MQ-Messaging-Provider in Liberty Profile können JMS-Messaging-Anwendungen
(Java™ Message Service) Ihr WebSphere MQ-System als einen externen Provider von JMS-Messaging-Ressourcen nutzen.
Vorbereitende Schritte
Sie müssen sicherstellen, dass ein Liberty Profile-Server erstellt wird,
in dem Sie die Messaging-Anwendung implementieren möchten, die JMS verwendet.
Weitere Informationen finden Sie unter Liberty Profile-Server manuell erstellen.
Informationen zu diesem Vorgang
Das Feature wmqJmsClient-2.0 bietet Unterstützung für Anwendungen,
die JMS 2.0-Spezifikationen verwenden.
Anmerkung: Das Feature wmqJmsClient-2.0 unterstützt die Features der Spezifikationen JMS 1.1 und JMS 2.0. Sie können jedoch das Feature wmqJmsClient-1.1 verwenden, wenn Sie nur die Features nutzen möchten, die mit der Spezifikation JMS 1.1 kompatibel sind.
Vorgehensweise
- Fügen Sie das Feature wmqJmsClient-2.0
der Datei server.xml hinzu. Wenn
Sie eine JNDI-Suche durchführen möchten, müssen Sie auch das Feature jndi-1.0 hinzufügen.
<featureManager>
<feature>wmqJmsClient-2.0</feature>
<feature>jndi-1.0</feature>
</featureManager>
Wenn Sie das Feature
wmqJmsClient-2.0 hinzufügen, kann der Liberty-Server die
benötigten WebSphere MQ-Bundles laden, mit denen Sie die JMS-Ressourcen von WebSphere MQ
definieren können. Beispielsweise stellen die Verbindungsfactory- und Aktivierungsspezifikationseigenschaften Clientbibliotheken bereit,
mit denen eine Verbindung zum WebSphere MQ-Netz hergestellt werden kann.
- Geben Sie die Position des WebSphere MQ-Ressourcenadapters an, indem Sie den folgenden Eintrag der Datei server.xml hinzufügen:
<variable name="wmqJmsClient.rar.location" value="/Pfad/zu/wmq/rar/wmq.jmsra.rar"/>
Das
Attribut
value gibt den absoluten Pfad zur
Datei des WebSphere MQ-Ressourcenadapters,
wmq.jmsra.rar, an.
Details zu den unterstützten Versionen und zum Abrufen
der Datei wmq.jmsra.rar finden Sie im technischen Hinweis 1633761 zu WebSphere MQ.
Rufen Sie die Datei wmq.jmsra.rar ab und installieren Sie sie
über Fix
Central.
- Fügen Sie die Verbindungsfactory-Definitionen der Datei server.xml hinzu.
<jmsConnectionFactory jndiName="jms/wmqCF" connectionManagerRef="ConMgr6">
<properties.wmqJms
transportType="CLIENT"
hostName="localhost"
port="1414"
channel="SYSTEM.DEF.SVRCONN"
queueManager="QM1"/>
</jmsConnectionFactory>
<connectionManager id="ConMgr6" maxPoolSize="2"/>
<jmsQueue id="jms/queue1" jndiName="jms/wmqQ1">
<properties.wmqJms
baseQueueName="MDBQ"
baseQueueManagerName="QM1"/>
</jmsQueue>
- Konfigurieren Sie die JMS-Anwendungen für die Verbindungsherstellung im Bindungsmodus.
Um den JMS-Anwendungen zu ermöglichen, die Verbindung
WebSphere MQ mit den gemeinsam genutzten Speichern oder im Bindungsmodus herzustellen,
müssen sowohl Liberty Profile als auch
WebSphere MQ auf demselben Server implementiert sein. Um
JMS-Anwendungen zu ermöglichen, die Verbindung im Bindungsmodus herzustellen,
müssen Sie das Element
nativeLibraryPath in der Datei
server.xml verwenden, um die Position
der nativen
WebSphere MQ-Bibliotheken anzugeben.
<wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>