Via le fournisseur de messagerie WebSphere MQ dans le profil Liberty, les applications de messagerie
JMS (Java™ Message Service) peuvent utiliser votre système WebSphere MQ en tant que fournisseur externe des ressources de messagerie JMS.
Avant de commencer
Vous devez vous assurer qu'un serveur de profil Liberty sur lequel déployer l'application de messagerie qui utilise le service JMS a été créé. Pour plus d'informations, voir Création manuelle d'un serveur de profil Liberty.
Pourquoi et quand exécuter cette tâche
La fonction
wmqJmsClient-2.0
prend en charge les applications qui utilisent les spécifications
JMS 2.0.
Remarque : La fonction *
wmqJmsClient-2.0
prend en charge les fonctions des spécifications JMS 1.1 et JMS 2.0. Toutefois, vous pouvez choisir d'utiliser la fonction
wmqJmsClient-1.1
si vous voulez utiliser uniquement les fonctions qui sont conformes à
la spécification JMS 1.1.
Procédure
- Ajoutez la fonction
wmqJmsClient-2.0 au fichier server.xml. Si vous voulez effectuer une recherche JNDI, vous devez aussi ajouter
la fonction jndi-1.0.
<featureManager>
<feature>wmqJmsClient-2.0</feature>
<feature>jndi-1.0</feature>
</featureManager>
L'ajout de la fonction
wmqJmsClient-2.0
permet au serveur Liberty de charger les bundles
WebSphere MQ nécessaires à la
définition des ressources JMS
WebSphere MQ. Par exemple, la fabrique de connexions et la spécification d'activation fournissent des bibliothèques client pour la connexion au réseau WebSphere MQ.
- Spécifiez l'emplacement de l'adaptateur de ressources WebSphere MQ en ajoutant l'entrée suivante au fichier server.xml :
<variable name="wmqJmsClient.rar.location" value="/chemin/vers/wmq/rar/wmq.jmsra.rar"/>
où l'attribut
value spécifie le chemin d'accès absolu vers le fichier d'adaptateur de ressources
WebSphere MQ,
wmq.jmsra.rar.
Pour plus d'informations sur les versions prises en charge et sur l'obtention du fichier wmq.jmsra.rar, reportez-vous à la Note technique 1633761 de WebSphere MQ. Procurez-vous le fichier wmq.jmsra.rar depuis le site Fix central et installez-le.
- Ajoutez les définitions de fabrique de connexion au fichier server.xml.
<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>
- Configurez des applications JMS pour la connexion en mode liaison.
Pour que les applications JMS puissent se connecter avec des
mémoires partagées ou en mode liaison à
WebSphere MQ, le profil
Liberty et
WebSphere MQ
doivent être déployés sur le même serveur. Pour que les applications JMS puissent se connecter en mode liaison, utilisez l'élément
nativeLibraryPath dans le fichier
server.xml afin de spécifier l'emplacement des bibliothèques natives de
WebSphere MQ.
<wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>