Utilisation du protocole de transfert JMS avec Message Broker

Cette section explique comment configurer les composants pour échanger des documents entre WebSphere Partner Gateway et WebSphere Business Integration Message Broker via le protocole de transfert JMS. Elle contient les informations suivantes qui expliquent comment envoyer et recevoir des documents :

Composants requis pour les documents envoyés sur JMS

L'échange de documents entre WebSphere Partner Gateway et la version 5.0 de Message Broker à l'aide du protocole de transfert JMS nécessite WebSphere MQ comme fournisseur JMS. Les sections qui suivent expliquent comment WebSphere Partner Gateway, Message Broker et WebSphere MQ collaborent pour échanger des documents via le protocole de transfert HTTP.

Envoi de documents via le transfert JMS

Pour que WebSphere Partner Gateway envoie un document à Message Broker par le biais du protocole JMS, vous devez utiliser les files d'attente JMS. WebSphere Partner Gateway envoie un document à sa file d'attente de sortie JMS d'où il est transféré, vers la file d'attente d'entrée JMS sur laquelle Message Broker est en mode écoute. Lorsque Message Broker reçoit un document, il l'extrait de sa file d'attente d'entrée. Le flux de messages de Message Broker contient des noeuds de transfert WebSphere MQ (JMS) spéciaux qui traitent l'accès aux files d'attente JMS. La figure 25 illustre comment WebSphere Partner Gateway envoie des documents à Message Broker via le protocole JMS.

Figure 25. Flux de messages entre WebSphere Partner Gateway et un flux de messages via le protocole de transfert JMS
Cette figure montre comment un objet métier est envoyé depuis unparticipant à WebSphere Partner Gateway, comment WebSphere Partner Gateway envoie un message JMS à une file d'attente de sortie et commentMessage Broker extrait le message depuis une file d'attente d'entrée.

Les étapes suivantes expliquent comment WebSphere Partner Gateway envoie un document à un flux de messages dans Message Broker via le protocole de transfert JMS :

  1. WebSphere Partner Gateway place un message dans sa file d'attente de sortie JMS.

    Si le type de regroupement du document était l'intégration dorsale, WebSphere Partner Gateway a intégré des propriétés personnalisées dans ce message. L'en-tête de message JMS, JMSType, est défini avec le type de contenu des données utiles.

    Remarque : Dans WebSphere Partner Gateway, vous devez configurer une passerelle qui identifie la file d'attente de sortie JMS à laquelle WebSphere Partner Gateway envoie le message et dans laquelle Message Broker effectue des interrogations. Pour plus d'informations, voir Configuration pour la réception de documents via le protocole de transfert JMS.
  2. WebSphere MQ transfère le document de la file d'attente de sortie de l'ordinateur sur lequel réside WebSphere Partner Gateway vers la file d'attente d'entrée dans laquelle Message Broker effectue des interrogations.
  3. Lorsque Message Broker détecte un message dans la file d'attente d'entrée, il extrait le message et l'envoie au flux de messages approprié.

    Pour plus d'informations sur la procédure de configuration de cette file d'attente, voir Configuration de l'environnement requis pour le transfert JMS.

  4. Le noeud MQInput envoie le document au noeud suivant du flux de messages. Ce noeud est généralement un noeud de calcul.
  5. Les noeuds du flux de messages exécutent la logique applicative.

    Une fois la logique applicative est terminée, le flux de messages envoie le document résultant à son noeud MQOutput.

  6. Le noeud MQOutput envoie le document à la file d'attente appropriée.

Réception de documents via le transfert JMS

Pour que WebSphere Partner Gateway reçoive un document de Message Broker par le biais du protocole JMS, vous devez utiliser des files d'attente JMS. Message Broker envoie un document à sa file d'attente de sortie JMS d'où il est transféré, vers la file d'attente d'entrée JMS sur laquelle WebSphere Partner Gateway est en mode écoute. Lorsque WebSphere Partner Gateway reçoit un document, il l'extrait de sa file d'attente d'entrée. Le flux de messages de Message Broker contient des noeuds de transfert WebSphere MQ (JMS) spéciaux qui traitent l'accès aux files d'attente JMS. La figure 26 illustre la façon dont les documents sont envoyés de Message Broker à WebSphere Partner Gateway.

Figure 26. Flux de messages entre un flux de messages et WebSphere Partner Gateway via le protocole de transfert JMS
Cette figure montre comment un message JMS est envoyé depuisMessage Broker à sa file d'attente de sortie et à la file d'attente d'entrée deWebSphere Partner Gateway.

Les étapes suivantes expliquent comment WebSphere Partner Gateway reçoit un document à partir d'un flux de messages dans Message Broker via le protocole de transfert JMS :

  1. Le flux de messages dans Message Broker reçoit un document dans son noeud MQInput.

    Le flux de messages reçoit sont message entrant d'une file d'attente d'entrée JMS.

  2. La file d'attente MQInput du flux de messages reçoit le document et l'envoie au noeud suivant du flux de messages. Ce noeud est généralement un noeud de calcul.
  3. Les noeuds du flux de messages exécutent la logique applicative.

    Une fois la logique applicative est terminée, le flux de messages envoie le document résultant à son noeud MQOutput.

  4. Le noeud MQOutput envoie le document à la file d'attente de sortie JMS appropriée.
  5. WebSphere MQ transfère le document de la file d'attente de l'ordinateur sur lequel réside Message Broker vers la file d'attente dans laquelle WebSphere Partner Gateway effectue des interrogations.
  6. WebSphere Partner Gateway reçoit le message à partir de sa file d'attente d'entrée JMS, telle qu'elle est configurée dans sa cible.

    Pour plus d'informations sur la cible, voir Configuration de documents entrants sur le protocole de transfert JMS. Pour plus d'informations sur la procédure de configuration de cette file d'attente, voir Configuration de l'environnement requis pour le transfert JMS.

Configuration de l'environnement requis pour le transfert JMS

L'échange de documents sur Message Broker nécessite des files d'attente JMS (éloignées et locales). Pour plus d'informations sur la manière de configurer WebSphere Partner Gateway pour une utilisation avec Message Broker via JMS, voir Configuration de WebSphere Partner Gateway pour Message Broker. Pour utiliser le protocole JMS avec Message Broker, vous pouvez configurer le système JMS fourni par WebSphere MQ. La version 5.0 de Message Broker utilise la version 5.3 de WebSphere MQ comme fournisseur JMS. Vous pouvez utiliser les étapes duGuide de configuration du concentrateur pour configurer le mécanisme de protocole JMS.

Important : Les opérations décrites dans le Guide de configuration du concentrateur doivent être effectuées sur l'ordinateur où WebSphere Partner Gateway réside. Ce document présume que le mécanisme de transfert JMS requis par Message Broker a déjà été configuré pendant l'installation de Message Broker.

Lors de la création de vos files d'attente JMS à utiliser entre WebSphere Partner Gateway et Message Broker, prenez en considération les points suivants :

Tableau 70. Attribution de noms aux files d'attente JMS pour la directionnalité de Message Broker
Nom de file d'attente d'origine Nom de file d'attente directionnelle
inQ MB2HUB
outQ HUB2MB

Création du flux de messages pour le transfert JMS

Pour qu'un flux de messages Message Broker traite les documents via le protocole de transfert JMS, il utilise les noeuds de transfert suivants :

L'ordre dans lequel ces noeuds de transfert sont utilisés est fonction du sens de la communication :

Tableau 72. Noeuds permettant la réception de documents de Message Broker
Type de noeud Fonction Remarques et restrictions
MQInput Reçoit le document dans le flux de messages Ce noeud de transfert reçoit le document entrant d'une file d'attente d'entrée JMS.
Calcul Effectue des tâches de logique applicative, telles que la mise à jour des informations d'en-tête Aucun
MQOutput Reçoit le document du noeud de calcul et l'envoie à WebSphere Partner Gateway La valeur de la zone Nom de file d'attente (dans les propriétés de base) de ce noeud de transfert correspond à la file d'attente de sortie du flux de messages. WebSphere MQ doit être configuré de sorte que cette file d'attente JMS envoie des documents à la file d'attente d'entrée de WebSphere Partner Gateway. Pour plus d'informations, voir Configuration de documents entrants sur le protocole de transfert JMS.

Pour plus de détails sur la création et la configuration des noeuds de flux de messages, consultez la documentation WebSphere Business Integration Message Broker.

Copyright IBM Corp. 2003, 2005