Création de files d'attente JMS

Le protocole de transfert JMS utilise les files d'attente JMS pour contenir les messages JMS transmis entre Business Integration Connect et le système dorsal. Avec WebSphere MQ version 5.3, la création de files d'attente JMS comprend les étapes suivantes :

  1. Création de files d'attente MQ
  2. Création de canaux et d'une file d'attente de transmission MQ
  3. Création de files d'attente locales MQ JMS

Création de files d'attente MQ

Si vous n'avez pas encore défini de gestionnaire de files d'attente pour Business Integration Connect et le système dorsal, faites-le avant de créer les files d'attente JMS MQ. Vous aurez besoin d'un gestionnaire de files d'attente si vous effectuez une intégration JMS. Vous devez décider soit d'installer un nouveau gestionnaire de files d'attente, soit d'en utiliser un existant. Un gestionnaire de files d'attente existant peut être le même que celui de Business Integration Connect, le même que celui du système dorsal ou tout autre gestionnaire de files d'attente existant. Pour plus d'informations sur la création d'un gestionnaire de files d'attente, voir la documentation de WebSphere MQ.

Remarque :
Si votre système dorsal et Business Integration Connect résident sur des machines différentes, le gestionnaire de files d'attente peut résider sur l'une ou l'autre machine. Business Integration Connect et le système dorsal spécifie le nom d'hôte de la machine lorsqu'ils accèdent au gestionnaire de files d'attente.

L'exemple fourni dans ce chapitre présuppose qu'un gestionnaire de files d'attente WebSphere MQ existe et qu'il porte le nom suivant :

bcg.queue.manager
 

Création de canaux et d'une file d'attente de transmission MQ

Une fois que le gestionnaire de files d'attente existe, assurez-vous que les objets suivants sont créés :

Pour créer les canaux et la file d'attente de transmission MQ, utilisez l'outil WebSphere MQ Command Environment, runmqsc, fourni avec WebSphere MQ. Cet outil intègre une interface de ligne de commande qui permet d'entrer des commandes de gestion des files d'attente.

Remarque :
La manière de créer ces objets MQ dépend de la plateforme que vous utilisez. Pour plus d'informations sur la création de ces objets, voir la documentation de WebSphere MQ.

Pour utiliser l'outil runmqsc afin de créer vos canaux et votre file d'attente de transmission MQ, procédez comme suit :

  1. Ouvrez une invite de commandes et accédez au répertoire suivant :
    WebSphereMQ_Root\java\bin
     

    WebSphereMQ_Root correspond au répertoire d'installation de WebSphere MQ.

  2. Pour démarrer WebSphere MQ Command Environment, entrez la commande suivante :
    runmqsc queueManager
     

    queueManager est le nom de votre gestionnaire de files d'attente WebSphere MQ.

    Remarque :
    Vous devez vous connecter en tant qu'utilisateur mqm pour utiliser l'outil runmqsc.
  3. Sur la ligne de commande runmqsc, entrez les commandes suivantes :
    1. Définissez une file d''attente de transmission JMS :
      define qlocal(transQueueName) usage(xmitq) put(enabled)
          get(enabled)
       

      transQueueName correspond au nom que vous souhaitez affecter à la file d'attente de transmission JMS.

    2. Définissez un canal émetteur :
      define channel(sndrChannelName) chltype(sdr) xmitq(transQueueName)
          conname('remote m/c ip')
       stop channel(sndrChannelName)
       

      sndrChannelName correspond au nom que vous souhaitez affecter à votre canal émetteur JMS et transQueueName correspond au nom de la file d'attente de transmission JMS que vous avez créée à l'étape 3a.

    3. Définissez un canal récepteur :
      define channel(rcvrChannelName) chltype(rcvr) xmitq(transQueueName)
       stop channel(rcvrChannelName)
       

      rcvrChannelName correspond au nom que vous souhaitez affecter à votre canal récepteur JMS et transQueueName correspond au nom de la file d'attente de transmission JMS que vous avez créée à l'étape 3a.

  4. Vous pouvez laisser la fenêtre de WebSphere MQ Command Environment ouverte car vous en aurez besoin pour les commandes de gestion des files d'attente ultérieures.

La Figure 30 illustre la création d'un exemple de canaux JMS et d'une file d'attente de transmission hébergés par le gestionnaire de files d'attente bcg.queue.manager.

Figure 30. Commandes permettant la création d'un exemple de canaux et d'une file d'attente de transmission JMS

runmqsc bcg.queue.manager
 
   define qlocal(TRANSQ) usage(xmitq) put(enabled) get(enabled) 
    define channel(SENDER) chltype(sdr) xmitq(TRANSQ) 
       conname('remote m/c ip')
    stop channel(SENDER)
    define channel(RECEIVER) chltype(rcvr)
    stop channel(RECEIVER)
 

Les commandes représentées à la Figure 30 permettent de créer les objets MQ suivants :

Création de files d'attente locales MQ JMS

Pour créer les files d'attente locales MQ JMS, utilisez l'outil WebSphere MQ Command Environment, runmqsc.

Remarque :
Vous devez créer ces files d'attente MQ JMS sur la machine où Business Integration Connect réside.

Pour utiliser l'outil runmqsc afin de créer vos files d'attente MQ locales, procédez comme suit :

  1. Sur la ligne de commande runmqsc, entrez les commandes suivantes :
    1. Définissez la file d'attente entrante JMS, qui reçoit des messages à partir du système dorsal :
      define qlocal(inQueueName)
       

      inQueueName correspond au nom de la file d'attente entrante JMS que vous avez affecté.

    2. Définissez la file d'attente JMS sortante, qui envoie des messages au système dorsal :
      define qlocal(outQueueName)
       

      outQueueName correspond au nom de la file d'attente JMS sortante que vous avez affecté.

  2. Pour quitter WebSphere MQ Command Environment, entrez la commande suivante :
    end
     

    Vous pouvez laisser votre fenêtre d'invite de commandes ouverte car vous en aurez besoin pour les étapes de configuration qui suivent.

Remarque :
Si les interactions avec Business Integration Connect ne nécessitent qu'une seule direction de communication avec le système dorsal, vous pouvez créer uniquement une file d'attente pour la direction que Business Integration Connect prendra en charge.

La Figure 31 illustre la création d'un exemple de files d'attente JMS hébergée par le gestionnaire de files d'attente bcg.queue.manager.

Figure 31. Commandes qui permettent la création des exemples de files d'attente JMS

   define qlocal(JMSIN)
    define qlocal(JMSOUT)
  
 

Les commandes représentées sur la Figure 31 permettent de créer les files d'attente JMS suivantes :

Copyright IBM Corp. 1997, 2004