Configuration de WebSphere Partner Gateway pour Message Broker

La section Configuration de WebSphere Partner Gateway donne un aperçu général sur la manière dont WebSphere Partner Gateway est configuré pour communiquer avec un système dorsal. Cette section résume les étapes nécessaires pour configurer WebSphere Partner Gateway afin de communiquer avec Message Broker.

La configuration de WebSphere Partner Gateway implique les étapes suivantes :

Prise en charge des documents sortants

Pour que WebSphere Partner Gateway puisse envoyer des documents à un système dorsal, vous devez effectuer les opérations expliquées à la section Définition de la destination du document du participant. Si Message Broker est votre système dorsal dorsale, vous devez créer une passerelle dont le type de transfert correspond au protocole de transfert utilisé pour échanger des messages entre WebSphere Partner Gateway et Message Broker. Lorsque le concentrateur envoie un document à Message Broker, il doit savoir vers où acheminer le document. Cet emplacement doit être conforme au protocole de transfert utilisé. Le protocole de transfert doit être pris en charge par Message Broker (voir Transferts de messages pris en charge par Message Broker).

Les sections ci-dessous résument comment créer des passerelles pour les protocoles de transfert suivants pris en charge par Message Broker :

Configuration pour l'envoi de documents via le protocole de transfert HTTP

Lorsque le concentrateur envoie un document à Message Broker via le protocole HTTP, il transmet le message via la passerelle définie. Cette passerelle identifie l'adresse URL à laquelle Message Broker peut recevoir le document. Lorsque Message Broker utilise le protocole HTTP, il achemine le document vers le noeud HTTPInput du flux de messages associé à l'adresse URL indiquée.

Pour que le concentrateur puisse envoyer des documents via une passerelle sur le protocole de transfert HTTP, créez une passerelle sur la page Caractéristiques de la passerelle de la Console de communauté. Cette passerelle doit être configurée pour utiliser le protocole de transfert HTTP 1.1 et écrire à l'adresse URL du noeud HTTPInput situé à l'extrémité. Comme le montre le tableau 61, cette adresse URL est indiquée dans la zone URI cible de la définition de passerelle.

Remarque : La section Définition de la destination du document du participant décrit comment créer une passerelle.

Tableau 61. Valeurs HTTP de la page Caractéristiques de la passerelle pour la communication avec Message Broker
Zone Caractéristiques de la cible Valeur Remarques et restrictions
Identificateur URI de la cible L'adresse URL doit être identique à celle configurée pour le noeud HTTPInput dans le flux de messages Message Broker. Extrayez cette adresse URL de la configuration du flux de messages dans l'intégration de WebSphere Business Integration Message Broker.

Configuration pour la réception de documents via le protocole de transfert JMS

Lorsque le concentrateur envoie un document à Message Broker via le protocole JMS, il transmet le document à la file d'attente JMS correspondante, d'où il peut être ensuite transféré à la file d'attente JMS à partir de laquelle il peut être récupéré par Message Broker. Pour que le concentrateur puisse obtenir l'emplacement de la file d'attente JMS, vous devez créer une passerelle dans WebSphere Partner Gateway, qui utilise le protocole de transfert JMS. Cette passerelle doit être configurée pour écrire dans la file d'attente dont le contenu est transféré à la file d'attente sur laquelle Message Broker reçoit des messages.

Remarque : Pour plus d'informations sur la création d'une passerelle, voir Définition de la destination du document du participant.

Pour que le concentrateur puisse envoyer des documents via une passerelle sur le protocole de transfert JMS, créez une passerelle sur la page Caractéristiques de la passerelle de la Console de communauté. Lors de l'utilisationde WebSphere MQ, version 5.3 comme fournisseur JMS, voir leGuide de configuration du concentrateur pour obtenir les étapes détaillées. Par ailleurs, utilisez les informations contenues dans le tableau 62 pour le protocole JMS sur la page Caractéristiques de la passerelle.

Tableau 62. Valeurs JMS de la page Caractéristiques de la passerelle pour la communication avec Message Broker
Zone Caractéristiques de la passerelle Valeur Remarques et restrictions
Nom de file d'attente JMS Nom de la file d'attente JMS sur l'ordinateur sur lequel réside WebSphere Partner Gateway

Les documents reçus sur cette file d'attente sont transférés vers la file d'attente JMS de l'ordinateur sur lequel réside Message Broker.

Prise en charge des documents entrants

Pour que WebSphere Partner Gateway puisse recevoir des messages à partir d'un système dorsal, vous devez effectuer les opérations indiquées à la section Définition du lieu d'extraction du document dorsal. Si Message Broker est votre système dorsal, vous devez effectuer les opérations suivantes :

  1. Dans le cadre de la définition du profil de participant du Gestionnaire de communauté, définissez le type de passerelle et indiquez l'adresse IP associée sur laquelle le réceptionnaire écoute.
  2. Créez une cible dont le type de transfert correspond au protocole de transfert utilisé pour échanger des documents entre WebSphere Partner Gateway et Message Broker.

    Pour que le concentrateur reçoive un document depuis Message Broker, il doit connaître l'emplacement où récupérer les messages. Cet emplacement doit être compatible avec le protocole de transfert utilisé.

Les sections suivantes résument comment créer des cibles pour les protocoles de transfert pris en charge par Message Broker.

Configuration de documents entrants sur le protocole de transfert HTTP

Lorsque le concentrateur reçoit un document sur le protocole de transfert HTTP, son réceptionnaire extrait le document de la cible définie. Cette cible identifie l'adresse URL sur laquelle le réceptionnaire récupère les documents depuis Message Broker. Lorsque Message Broker utilise le protocole HTTP, le noeud HTTPRequest envoie le document à une adresse URL, où il est récupéré par le concentrateur.

Pour que le concentrateur puisse recevoir les documents via une cible sur le protocole de transfert HTTP, vous devez créer une cible sur la page Liste cible de la Console de communauté. Cette cible doit utiliser le protocole HTTP 1.1. Le concentrateur détermine cette URL sous la forme d'une combinaison des informations suivantes :

Remarque : La section Définition du lieu d'extraction du document dorsal décrit comment créer une cible.

Pour que Message Broker puisse transmettre des documents à cette cible, le noeud HTTPRequest du flux de messages doit être doit être configuré pour transmettre des documents à cette URL. Par conséquent, vous devez vous assurer que cette URL cible est disponible pour la configuration de Message Broker.

Configuration de documents entrants sur le protocole de transfert JMS

Lorsque le concentrateur reçoit un document à partir de Message Broker via le protocole JMS, il récupère le document dans la file d'attente d'entrée JMS appropriée, où il a été transféré à partir de la file d'attente de sortie JMS dans laquelle Message Broker l'a envoyé. Pour que le concentrateur puisse connaître l'emplacement de la file d'attente JMS, vous devez créer une cible dans WebSphere Partner Gateway, qui utilise le protocole de transfert JMS. Par le biais de cette cible, le concentrateur interroge la file d'attente pour savoir si des documents ont été transmis, puis les récupère.

Remarque : Pour plus d'informations sur la création d'une cible, voir Définition du lieu d'extraction du document dorsal.

Pour que le concentrateur puisse recevoir les documents via une cible sur le transfert JMS, vous devez créer une cible sur la page Liste cible de la Console de communauté. Lors de l'utilisation de WebSphere MQ, version 5.3 comme fournisseur JMS, voir leGuide de configuration du concentrateur pour obtenir les étapes détaillées. Par ailleurs, utilisez les informations contenues dans le tableau 63 pour le protocole JMS sur la page Caractéristiques de la cible.

Tableau 63. Valeurs JMS de la page Caractéristiques de la cible pour la communication avec Message Broker
Zone Caractéristiques de la cible Valeur Remarques et restrictions
Nom de file d'attente JMS Nom de la file d'attente d'entrée JMS qui reçoit des documents de la file d'attente de sortie de Message Broker

Les documents de cette file d'attente d'entrée sont transférés à partir de la file d'attente de sortie JMS sur l'ordinateur sur lequel réside Message Broker.

Copyright IBM Corp. 2003, 2005