Via le fournisseur de messagerie IBM MQ dans Liberty, les applications de messagerie
JMS (Java™ Message Service) peuvent utiliser votre système IBM MQ
en tant que fournisseur externe des ressources de messagerie JMS.
Avant de commencer
Vous devez vous assurer qu'un serveur 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 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
IBM MQ nécessaires à la
définition des ressources JMS
IBM MQ. Par exemple, la fabrique de connexions et la spécification d'activation fournissent des bibliothèques client pour la connexion au réseau IBM MQ.
- Spécifiez l'emplacement de l'adaptateur de ressources IBM MQ en ajoutant l'entrée suivante dans le fichier
server.xml:
<variable name="wmqJmsClient.rar.location" value="/path/to/wmq/rar/wmq.jmsra.rar"/>
où
l'attribut
value spécifie le chemin d'accès absolu du fichier de l'adaptateur de ressources
IBM 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 IBM MQ
Note technique 1633761. 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 à
IBM MQ, Liberty et
IBM 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
IBM MQ.
<wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>