Exemple de configuration de lien IBM MQ

Cet exemple de configuration illustre l'utilisation d'un lien IBM MQ pour connecter un moteur de messagerie d'intégration de service WebSphere Application Server à un moteur de messagerie IBM MQ.

Un lien IBM MQ permet de connecter un moteur de messagerie d'intégration de service, appelé moteur de messagerie de passerelle, à un gestionnaire de files d'attente IBM MQ ou à un groupe de partage de files d'attente, appelé gestionnaire de file d'attente de passerelle. Tous les moteurs de messagerie du bus d'intégration de services utilisent le moteur de messagerie de passerelle pour acheminer des messages vers et depuis le réseau IBM MQ. Tous les gestionnaires de files d'attente et tous les groupes de partage de files d'attente du réseau IBM MQ utilisent le gestionnaire de file d'attente de passerelle pour acheminer des messages vers et depuis le bus d'intégration de services.

En général, un lien IBM MQ est constituée de deux connexions TCP/IP :
  • Le canal émetteur de lien IBM MQ, qui achemine les messages entre l'intégration de service et IBM MQ.
  • Le canal récepteur de lien IBM MQ, qui achemine les messages entre WebSphere MQ et l'intégration de service.
IBM MQ appelle ces canaux de connexion TCP/IP, à savoir un canal récepteur qui se connecte au canal émetteur de lein IBM MQ et un canal émetteur qui se connecte au canal récepteur de lien IBM MQ. Le schéma ci-après illustre la configuration qui vient d'être décrite précédemment, avec un canal émetteur de lien WebSphere MQ appelé BUS1.TO.QM01 et un canal récepteur de lien IBM MQ appelé QM01.TO.BUS1.
Un bus d'intégration de services appelé BUS1 contient trois moteurs de messagerie, l'un d'entre eux étant un moteur de messagerie de passerelle. Un réseau WebSphere MQ, considéré comme un bus, contient deux gestionnaires de files d'attente, QM01 et QM02. QM01 est le gestionnaire de file d'attente de passerelle. Le bus d'intégration de services et le "bus" WebSphere MQ sont connectés via un canal émetteur de lien WebSphere MQ appelé BUS1.TO.QM01 et via un canal récepteur de lien WebSphere MQ appelé QM01.TO.BUS1.

Si les messages ne doivent circuler que dans un seul sens, il vous suffit de définir une seule connexion TCP/IP. Par exemple, un canal émetteur de lien IBM MQ dans l'intégration de service qui se connecte à un canal récepteur dans IBM MQ est suffisant pour prendre en charge le flux de messages entre l'intégration de service et IBM MQ. Cet exemple présente toutefois une configuration qui permet aux messages de circuler dans les deux sens.

Exemple de contexte de configuration

Cet exemple explique comment connecter une configuration WebSphere Application Server à une configuration IBM MQ de manière à permettre aux messages asynchrones de circuler dans les deux sens entre les deux systèmes de messagerie. Cet exemple part du principe que vous avez défini une configuration WebSphere Application Server telle que celle présentée ci-dessous :
  • Un serveur d'applications appelé server1 situé sur un noeud London. Dans un déploiement réseau, server1 peut être l'un des nombreux serveurs d'une cellule et l'un des nombreux serveurs d'un cluster, mais cet exemple s'applique aussi bien à un déploiement de base qui ne contient qu'un seul serveur d'applications.
  • Le nom d'hôte IP du serveur London est LONDON.
  • Un bus d'intégration de services appelé BUS1.
  • server1 appartient à BUS1 ; il contient un moteur de messagerie appelé London.server1-BUS1.
  • Une destination de bus de type file d'attente appelée ServiceIntegrationQueue1. Il s'agit de l'une des destinations de BUS1.
Cet exemple part également du principe que vous avez défini une configuration IBM MQ telle que celle présentée ci-dessous :
  • Des gestionnaires de files d'attente appelés QM01 et QM02 appartiennent à un réseau de gestionnaires de files d'attente et de groupes de partage de files d'attente IBM MQ interconnectés. Si vous ne disposez que d'un seul gestionnaire de files d'attente, vous pouvez ignorer QM02 dans cet exemple.
  • Le nom d'hôte IP pour le serveur sur lequel QM01 s'exécute est PARIS.
  • Une file d'attente appelée WMQ11 située sur QM01 et une file d'attente appelée WMQ21 située sur QM02. D'autres files d'attente peuvent être définies dans le réseau IBM MQ mais cet exemple ne s'intéresse qu'aux deux files d'attente IBM MQ auxquelles vous allez accéder depuis WebSphere Application Server.

Vous sélectionnez London.server1-BUS1 comme moteur de messagerie de passerelle et QM01 comme gestionnaire de file d'attente de passerelle.

Exemple de configuration des connexions

Cette section décrit les paramètres qui doivent être configurés par vous ou votre administrateur IBM MQ pour les connexions :
  • Commandes utilisées par votre administrateur IBM MQ pour configurer les composants IBM MQ qui correspondent au lien IBM MQ :
    • Canal émetteur
    • Canal récepteur
    • File d'attente de transmission
    Pour les programmes JMS, l'administrateur IBM MQ définit également une destination JMS qui identifie la file d'attente dans le bus d'intégration de services. Pour en savoir plus sur ces commandes, voir la documentation IBM MQ.
  • Paramètres requis lorsque vous procédez à la configuration à l'aide de la console d'administration WebSphere Application Server :
    • Une connexion de bus externe, qui inclut le bus externe représentant le réseau de gestionnaires de files d'attente et de groupes de partage de files d'attente IBM MQ, et le lien IBM MQ représentant la connexion à ce réseau.
    • Les destinations JMS qui identifient les files d'attente dans le réseau IBM MQ.

Une fois que vous avez configuré et activé ces composants, vos applications peuvent échanger des messages entre le moteur de messagerie d'intégration de service WebSphere Application Server et le moteur de messagerie IBM MQ. Vous pouvez éventuellement configurer d'autres artefacts d'administration pour définir un contrôle plus détaillé des files d'attente et des destinations. Voir Exemple de configuration des destinations.

Commande IBM MQ permettant de configurer le canal émetteur
DEFINE    CHL(QM01.TO.BUS1) +
          CHLTYPE(SDR) +
          TRPTYPE(TCP) +
          CONNAME('LONDON(5558)') +
          XMITQ(BUS1)
Votre administrateur IBM MQ choisit le nom du canal émetteur, en l'occurrence, QM01.TO.BUS1.

Le paramètre CONNAME spécifie l'hôte IP et le port du moteur de messagerie de passerelle.

Le paramètre XMITQ indique le nom de la file d'attente de transmission. Ce nom est généralement le même que celui du gestionnaire de files d'attente virtuelles du bus d'intégration de services, lequel est de préférence identique au nom du bus.

Commande IBM MQ pour configurer le canal récepteur
DEFINE    CHL(BUS1.TO.QM01) +
          CHLTYPE(RCVR) +
          TRPTYPE(TCP)
Votre administrateur IBM MQ choisit le nom du canal récepteur, en l'occurrence, BUS1.TO.QM01.
Commande IBM MQ pour configurer la file d'attente de transmission
DEFINE   QL(BUS1) +
         USAGE(XMITQ)
Votre administrateur IBM MQ choisit le nom de la file d'attente de transmission, mais il est préférable d'utiliser le nom du bus d'intégration de services, BUS1. Si le nom du bus d'intégration de services n'est pas un nom de gestionnaire de files d'attente IBM MQ valide, l'administrateur WebSphere Application Server doit définir un autre nom de gestionnaire de files d'attente virtuelles ici.
Commande IBM MQ JMSAdmin pour configurer la destination JMS
DEFINE   Q(ServiceIntegrationQueue1) +
         QMGR(BUS1) +
         QUEUE(ServiceIntegrationQueue1)
Vos applications JMS IBM MQ peuvent utiliser cette destination JMS pour envoyer des messages vers la destination de bus d'intégration de services ServiceIntegrationQueue1 dans BUS1.
Paramètres WebSphere Application Server pour la connexion de bus externe
Vous configurez une connexion de bus externe dans le cadre de la topologie du bus d'intégration de services. En l'occurrence, le bus d'intégration de services est BUS1 et la connexion de bus externe utilise les paramètres suivants :
Réglage Valeur
Type de connexion de bus Connexion directe
Type de bus externe IBM MQ
Moteur de messagerie qui héberge la connexion London.server1-BUS1
Nom du gestionnaire de files d'attente virtuelles BUS1 (utilisez le nom du bus local)
Nom du bus externe QM01 (utilisez le nom du gestionnaire de file d'attente de passerelle IBM MQ)
Nom du lien MQ TO.QM01
Activer le flux de messages du bus d'intégration de services à IBM MQ Option sélectionnée (par défaut)
Nom du canal récepteur IBM MQ BUS1.TO.QM01
Nom d'hôte PARIS
port 1414
Activer le flux de messages de IBM MQ au bus d'intégration de services Option sélectionnée (par défaut)
Nom du canal émetteur IBM MQ QM01.TO.BUS01
Il existe d'autres options dans l'assistant qui sont liées à la messagerie de publication/d'abonnement et à la sécurité. Conservez les valeurs par défaut de ces paramètres.
Paramètres WebSphere Application Server pour les destinations JMS
Vous configurez les destinations JMS de sorte que les applications JMS d'intégration de service puissent accéder aux files d'attente du réseau IBM MQ. En l'occurrence, des destinations JMS sont nécessaires pour la file d'attente WMQ11 dans le gestionnaire de files d'attente QM01 et pour la file d'attente WMQ21 dans le gestionnaire de files d'attente QM02.

Notez que bien que ces destinations JMS soient des files d'attente IBM MQ, pour les besoins de cet exemple, vous accédez à ces files d'attente à partir de programmes JMS d'intégration de service. Par conséquent, vous devez définir des destinations JMS pour le fournisseur de messagerie par défaut (intégration de service) et non pour le fournisseur JMS IBM MQ.

Pour WMQ11, configurez les paramètres suivants :
Paramètre Valeur
Name WMQ11
Nom JNDI jms/WMQ11
Nom du bus QM01
Nom de la file d'attente WMQ11
Conservez les valeurs par défaut des autres paramètres.
Pour WMQ21, configurez les paramètres suivants :
Paramètre Valeur
Name WMQ21
Nom JNDI jms/WMQ21
Nom du bus QM01
Nom de la file d'attente WMQ21@QM02
Conservez les valeurs par défaut des autres paramètres.

Exemple de configuration des destinations

Les exemples de destination JMS de l'exemple de configuration des connexions pointent directement vers les files d'attente et les destinations d'intégration de service IBM MQ correspondantes. Si vous le souhaitez, vous pouvez configurer d'autres composants, comme suit :
  • La destination JMS IBM MQ pointe vers une file d'attente IBM MQ (il s'agit en réalité d'une file d'attente d'alias ou éloignée), laquelle pointe vers la destination d'intégration de service.
  • Les destinations JMS d'intégration de service pointent vers des destinations d'intégration de service (en réalité, il s'agit de destinations externes ou d'alias), lesquelles pointent vers les files d'attente IBM MQ.

Pour savoir quand et comment définir des files d'attente d'alias et éloignées, voir la documentation IBM MQ.

Paramètres WebSphere Application Server pour des destinations externes
Vous pouvez configurer des destinations externes pour les files d'attente IBM MQ afin de contrôler l'accès des applications d'intégration de service à chaque file d'attente. Par exemple, vous pouvez configurer des destinations externes pour chacune des deux files d'attente et spécifier que l'intégration de service ajoute un en-tête MQRFH2 dans les messages envoyés vers une seule de ces files d'attente.

Vous configurez des destinations externes comme ressources de destination du bus d'intégration de services.

Pour WMQ11, configurez les paramètres suivants :
Paramètre Valeur
Identificateur WMQ11
Bus QM01
Conservez les valeurs par défaut des autres paramètres.
Pour WMQ21, configurez les paramètres suivants :
Paramètre Valeur
Identificateur WMQ21@QM02
Bus QM01
Si la destination externe est une destination IBM MQ, l'identificateur doit être au format qName@qmName, où qName représente le nom de la file d'attente et qName le nom du gestionnaire de files d'attente. Pour cet exemple, l'identificateur de WMQ21 sur le gestionnaire de files d'attente QM02 est WMQ21@QM02.

Conservez les valeurs par défaut des autres paramètres.

Une fois que vous avez défini ces destinations externes, vous pouvez, par exemple, définir la propriété personnalisée _MQRFHAllowed pour l'une de ces destinations ou les deux, en fonction de vos besoins.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjc0222_
Nom du fichier : rjc0222_.html