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 :
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.
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
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.
Pour utiliser l'outil runmqsc afin de créer vos canaux et votre file d'attente de transmission MQ, procédez comme suit :
WebSphereMQ_Root\java\bin
où WebSphereMQ_Root correspond au répertoire d'installation de WebSphere MQ.
runmqsc queueManager
où queueManager est le nom de votre gestionnaire de files d'attente WebSphere MQ.
define qlocal(transQueueName) usage(xmitq) put(enabled) get(enabled)
où transQueueName correspond au nom que vous souhaitez affecter à la file d'attente de transmission JMS.
define channel(sndrChannelName) chltype(sdr) xmitq(transQueueName) conname('remote m/c ip') stop channel(sndrChannelName)
où 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.
define channel(rcvrChannelName) chltype(rcvr) xmitq(transQueueName) stop channel(rcvrChannelName)
où 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.
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.
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 :
Pour créer les files d'attente locales MQ JMS, utilisez l'outil WebSphere MQ Command Environment, runmqsc.
Pour utiliser l'outil runmqsc afin de créer vos files d'attente MQ locales, procédez comme suit :
define qlocal(inQueueName)
où inQueueName correspond au nom de la file d'attente entrante JMS que vous avez affecté.
define qlocal(outQueueName)
où outQueueName correspond au nom de la file d'attente JMS sortante que vous avez affecté.
end
Vous pouvez laisser votre fenêtre d'invite de commandes ouverte car vous en aurez besoin pour les étapes de configuration qui suivent.
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 :