Déploiement d'applications JMS sur Liberty en vue d'utiliser le fournisseur de messagerie IBM MQ

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

  1. 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.

  2. 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.

  3. 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>
  4. Configurez les applications JMS pour se connecter en mode BINDINGS.
    Pour permettre aux applications JMS de se connecter à l'aide des mémoires partagées ou en mode BINDINGS à IBM MQ, Liberty et IBM MQ doivent être déployés sur le même serveur. Pour permettre aux applications JMS de se connecter en mode BINDINGS, utilisez l'élément nativeLibraryPath dans le fichier server.xml pour spécifier l'emplacement des bibliothèques natives IBM MQ.
     <wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>
    Remarque : Pour utiliser le mode BINDINGS, le serveur doit être configuré avec la fonction zosTransaction-1.0.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_dep_msg_wmq.html