Configuration de l'environnement requis pour le transfert JMS

Etant donné que l'échange de documents sur InterChange Server nécessite l'utilisation de l'Adaptateur pour JMS et de files d'attente JMS, vous devez effectuer les tâches d'installation et de configuration décrites dans le tableau 53. Pour plus d'informations sur la manière de configurer WebSphere Partner Gateway pour une utilisation avec InterChange Server via JMS, voir Configuration de WebSphere Partner Gateway pour InterChange Server.

Tableau 53. Configuration de l'environnement requis pour l'utilisation du protocole JMS
Etape de configuration Pour plus d'informations
1. Configurez vos files d'attente JMS. Configuration des files d'attente JMS

2. Configurez WebSphere Business Integration Adapter for JMS.

Configuration de l'Adaptateur pour JMS

Remarque : Si vos documents contiennent des pièces jointes, vous devez également installer et configurer le composant Attachment Data Handler. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes.

Configuration des files d'attente JMS

Pour utiliser le protocole JMS avec InterChange Server, vous devez configurer le système JMS fourni par WebSphere MQ. Les versions prises en charge d'InterChange Server utilisent 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 l'Adaptateur pour JMS et InterChange Server a déjà été configuré pendant l'installation d'InterChange Server.

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

Tableau 54. Attribution de noms aux files d'attente JMS pour la directionnalité d'InterChange Server
Nom de file d'attente d'origine Nom de file d'attente directionnelle
inQ ICS2HUB
outQ HUB2ICS

Configuration de l'Adaptateur pour JMS

Adapter for JMS permet à WebSphere Partner Gateway d'échanger des documents avec InterChange Server sous la forme de messages JMS. Il prend en charge les interactions suivantes avec InterChange Server :

Important : WebSphere Partner Gateway n'intègre pas WebSphere Business Integration Adaptateur pour JMS. Vous devez vous procurer ce produit séparément et l'installer conformément aux instructions figurant dans le document Guide de l'Adaptateur pour JMS. Il est important de lire attentivement les opérations décrites dans ce document afin d'installer et de configurer correctement l'Adaptateur pour JMS.

Lorsque vous avez configuré l'Adaptateur pour JMS pour communiquer avec InterChange Server, suivez les étapes de cette section afin de configurer cet adaptateur pour qu'il accepte les messages JMS envoyés par WebSphere Partner Gateway :

Spécification du gestionnaire de données utiles

Comme l'illustre la figure 23, l'Adaptateur pour JMS utilise un gestionnaire de données pour convertir les objets métier reçus depuis InterChange Server en un message JMS.

Remarque : Le gestionnaire de données que l'Adaptateur pour JMS appelle convertit les données utiles du document. Si votre document est inclus dans une enveloppe XML (car il comprend des pièces jointes ou l'indicateur d'enveloppe est sur Oui), configurer le gestionnaire de données en pièce jointe de sorte qu'il fonctionne comme un gestionnaire de données utiles. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes.

Pour indiquer quel gestionnaire de données utiliser pour convertir les données utiles, vous devez suivre les étapes spécifiées dans la section Conversion d'objet métier. De plus, vous devez configurer l'Adaptateur pour JMS pour qu'il utilise ce gestionnaire de données utiles. Dans le panneau de configuration du connecteur, suivre les étapes suivantes :

  1. Définissez les propriétés de configuration du connecteur afin d'identifier le gestionnaire de données utiles à utiliser :
    Remarque : Vous définissez soit les propriétés DataHandlerConfigMO et DataHandlerMimeType soit la propriété DataHandlerClassName.
  2. Ajoutez le métaobjet du gestionnaire de données de niveau supérieur dans la liste des objets métier pris en charge.

Vous pouvez également indiquer quel gestionnaire de données utiliser dans le métaobjet dynamique ou statique. Les mêmes propriétés (DataHandlerMimeType , DataHandlerConfigMO et DataHandlerClassName) sont disponibles en tant qu'attributs dans ces métaobjets. Pour plus d'informations, voir le document Guide utilisateur de l'Adaptateur pour JMS.

Identification des files d'attente JMS

Lorsque l'Adaptateur pour JMS reçoit un document d'InterChange Server, il le place dans sa file d'attente de sortie, qui est ensuite interrogée par le réceptionnaire de WebSphere Partner Gateway. De même, lorsque WebSphere Partner Gateway envoie un document à InterChange Server, il place le document dans sa file d'attente de sortie, qui est interrogée par l'Adaptateur pour JMS.

Le tableau 55 résume comment configurer les files d'attente que l'Adaptateur pour JMS utilise pour recevoir et envoyer des documents.

Remarque : Pour plus d'informations sur la configuration des files d'attente JMS, voir le document Guide utilisateur de l'Adaptateur pour JMS.

Tableau 55. Files d'attente JMS
File d'attente JMS Jeu de configuration
File d'attente d'entrée

Affectez à la propriété de configuration du connecteur InputDestination le nom de la file d'attente JMS que l'Adaptateur pour JMS interrogera pour obtenir les messages entrants.

Vérifiez que le nom de cette file d'attente est identique à celui que WebSphere Partner Gateway utilise comme file d'attente JMS de sortie. Si cette file d'attente n'est pas spécifiée dans la propriété InputDestination, l'Adaptateur pour JMS n'interrogera pas la file d'attente.

Remarque : La propriété InputDestination contient une liste de files d'attente d'entrée séparée par des virgules. Si l'Adaptateur pour JMS interroge plusieurs files d'attente, assurez-vous que cette liste contient le nom de la file d'attente JMS qu'utilise WebSphere Partner Gateway comme file d'attente JMS de sortie.
File d'attente de sortie Pendant l'exécution, la collaboration peut affecter de manière dynamique à l'attribut OutputQueue dans le métaobjet dynamique le nom de la file d'attente JMS que l'Adaptateur pour JMS utilise pour envoyer son message.

Vous devez vous assurer que les métaobjets statiques ou dynamiques sont configurés pour pouvoir écrire sur la file d'attente sur laquelle la cible de WebSphere Partner Gateway est en mode écoute.

Copyright IBM Corp. 2003, 2005