Utilisation du protocole de transfert JMS avec Message Broker

Cette section explique comment configurer les composants pour échanger des documents entre WebSphere Business Integration Connect 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 document entre Business Integration Connect 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 Business Integration Connect, Message Broker et WebSphere MQ collaborent pour échanger des documents via le protocole de transfert HTTP.

Envoi de documents sur JMS

Pour que Business Integration Connect envoie un document à Message Broker par le biais du protocole JMS, vous devez utiliser les files d'attente JMS. Business Integration Connect 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 23 illustre comment Business Integration Connect envoie des documents à Message Broker sur le protocole JMS.

Figure 23. Flux de messages entre Business Integration Connect et un flux de messages via le protocole de transfert JMS


Les étapes suivantes expliquent comment Business Integration Connect envoie un document à un flux de messages dans Message Broker via le protocole de transfert JMS :

  1. Business Integration Connect place un message dans sa file d'attente de sortie JMS.

    Si le type de regroupement du document était l'intégration dorsale, Business Integration Connect 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 Business Integration Connect, vous devez configurer une passerelle qui identifie la file d'attente de sortie JMS à laquelle Business Integration Connect envoie le message et dans laquelle Message Broker effectue des interrogations. Pour plus d'informations, voir Configuration de documents sortants sur le protocole de transfert JMS.
  2. WebSphere MQ transfère le document de la file d'attente de sortie de la machine sur laquelle réside Business Integration Connect 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 permettent d'exécuter 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 sur JMS

Pour que Business Integration Connect reçoive un document de Message Broker via le 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 Business Integration Connect est en mode écoute. Lorsque Business Integration Connect 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 24 illustre la façon dont les documents sont envoyés de Message Broker à Business Integration Connect.

Figure 24. Flux de messages entre un flux de messages et Business Integration Connect via le protocole de transfert JMS


Les étapes suivantes expliquent comment Business Integration Connect 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 permettent d'exécuter 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 la machine sur laquelle réside Message Broker vers la file d'attente dans laquelle Business Integration Connect effectue des interrogations.
  6. Business Integration Connect 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 Business Integration Connect pour être utilisé avec Message Broker sur JMS, voir Configuration de Business Integration Connect 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. Par conséquent, vous pouvez suivre les étapes décrites dans Annexe A, Configuration d'un protocole JMS avec WebSphere MQ pour configurer le mécanisme de protocole JMS.

Important:
Les opérations décrites dans Annexe A, Configuration d'un protocole JMS avec WebSphere MQ doivent être effectuées sur la machine où WebSphere Business Integration Connect 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 Business Integration Connect et Message Broker, prenez en considération les points suivants :


Tableau 89. 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 MB2WBIC
outQ WBIC2MB

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 91. 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 à Business Integration Connect 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 Business Integration Connect. Pour plus d'informations, voir Configuration de documents sortants sur le protocole de transfert HTTP.

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. 1997, 2004