Effectuez la médiation d'une destination en utilisant la console d'administration pour définir un membre de bus de serveur IBM MQ dans lequel le point de médiation doit être affecté et une file d'attente IBM MQ doit être utilisé comme point de médiation où sont stockés les messages. Pour effectuer la médiation
de la destination à l'aide d'une médiation d'intégration de services, vous devez
indiquer un autre membre de bus (autre qu'un serveur IBM MQ pour l'utiliser
comme point d'exécution de médiation et traiter les messages.
Avant de commencer
Déterminez la méthode à utiliser pour configurer ces ressources. Vous
pouvez associer une médiation à une destination à l'aide de la console
d'administration, comme décrit dans cette tâche, ou à l'aide de la Commande mediateSIBDestination.
Avant
d'exécuter cette tâche, vérifiez que les ressources suivantes existent :
- la médiation que vous voulez appliquer à la médiation
- le membre de bus du serveur IBM MQ
auquel le point de médiation doit être attribué
- la file d'attente IBM MQ à utiliser
comme point de médiation, avec les attributs de file d'attente définis sur shareable
- pour la médiation d'une intégration de services, un second membre de bus (pas un membre de bus du serveur IBM MQ) à utiliser comme point d'exécution de la médiation où s'exécute le code
de la médiation.
Remarque : Le gestionnaire de files d'attente du réseau IBM MQ
n'est pas nécessairement disponible après avoir exécuté cette tâche, mais vous pourrez
utiliser la destination uniquement si le gestionnaire de files d'attente est disponible.
Pourquoi et quand exécuter cette tâche
Vous pouvez effectuer la médiation d'une destination avec un point de
médiation IBM MQ. Elle garantit la médiation des messages qui
arrivent à la file d'attente IBM MQ
désignée. Dans
ce scénario, les messages dont la médiation est déjà faite sont distribués au
point de la file d'attente ou à une autre destination déterminée par la destination
du chemin d'accès de réacheminement par défaut ou par le code de médiation. La médiation peut être hébergée
par l'intégration de services ou par IBM MQ.
Procédure
- Démarrez la console d'administration.
- Naviguez à la liste de destinations pour le bus approprié. Cliquez sur .
- Sélectionnez la case à cocher de la destination pour laquelle effectuer la médiation, puis cliquez sur Effectuer la médiation. L'assistant Médiation s'ouvre.
- Etape 1 :
Sélectionner la médiation.
Pour effectuer la médiation d'une destination en utilisant une médiation hébergée par l'intégration de services :
- Sélectionnez Médiation à appliquer à cette destination.
- Dans la liste déroulante, sélectionnez la médiation.
- Cliquez sur Suivant.
Pour effectuer une médiation en utilisant un programme
IBM MQ (un flux
IBM MQ, par exemple) :
- Sélectionnez Médiation effectuée en externe.
- Cliquez sur Suivant.
- Etape 2 :
Affecter la médiation à un membre de bus.
Lorsqu'une médiation est attribuée à un membre de bus du serveur IBM MQ, vous avez besoin d'un membre de bus distinct qui n'est pas un serveur IBM MQ afin de l'utiliser comme point d'exécution de la médiation et traiter les messages.
- Dans la liste déroulante, sélectionnez le membre de bus du serveur IBM MQ auquel le point de médiation doit être attribué.
- Facultatif : Si vous effectuez une médiation d'intégration de services,
sélectionnez le membre de bus où la médiation doit être effectuée.
Pour
une médiation hébergée par l'intégration de services, sélectionnez un membre de bus dans la zone de liste
libellée Sélectionner un membre de bus où la médiation sera exécutée. Si vous effectuez une médiation externe, elle n'est pas, par définition, exécutée dans un membre de bus.
- Cliquez sur Suivant.
- Facultatif : Si le point de médiation est une file d'attente IBM MQ, définissez les attributs du point de médiation IBM MQ.
Remarque : Cette étape n'apparaît que si
vous avez attribué le point de médiation à une file d'attente IBM MQ à l'étape précédente.
- Définissez une valeur dans la zone Filtre du nom de file d'attente IBM MQ, puis cliquez sur Go.
The wizard automatically discovers available IBM MQ . Toutefois, certaines topologies
IBM MQ comportent des milliers de files d'attentes définies
dans un gestionnaire de files d'attente. Utilisez ce filtre pour limiter le nombre de files d'attente répertoriées.
La valeur par défaut est un astérisque (*). Si cette valeur (ou aucune valeur) est définie,
toutes les files d'attente ou toutes celles d'un type particulier (selon la propriété personnalisée de file
d'attente définie) sont répertoriées. Toutes les autres valeurs spécifiées doivent répondre aux critères suivants :- Il doit comporter entre 1 et 48 caractères.
- Il doit être conforme aux conventions de dénomination de file d'attente IBM MQ (voir la rubrique Rules for
naming IBM MQ objects dans le centre de documentation IBM MQ).
Vous pouvez également utiliser le caractère générique (*) avec un autre texte. Par
exemple, si vous entrez la valeur PAYROLL*, toutes les files d'attente disponibles portant un nom commençant
par PAYROLL s'affichent.
- Indiquez un nom de file d'attente
IBM MQ.
Sélectionnez un nom de file d'attente dans la liste filtrée. Si la liste ne contient pas
la file d'attente demandée, sélectionnez la dernière entrée dans la liste intitulée
Autre, à spécifier. Une zone de saisie s'affiche en regard de la liste déroulante. Entrez le nom de la file d'attente dans la zone de saisie.
Si la file d'attente se trouve sur le système
IBM MQ distant, ses propriétés définies dans
IBM MQ s'affichent dans les zones en lecture seulement. Cela peut
permettre de confirmer que vous avez trouvé la file d'attente de votre choix et qu'elle est configurée comme vous l'aviez
prévu. Si la file d'attente est introuvable, ces zones en lecture seulement sont retirées de la vue.
- Indiquez les niveaux de fiabilité dont vous avez besoin lorsque des messages
IBM MQ persistants et non
persistants entrants sont convertis en messages de format d'intégration.
Les médiations reçoivent des messages directement de la file d'attente
IBM MQ spécifiée. En règle générale, le niveau de fiabilité
d'un message n'a donc pas beaucoup d'intérêt pour la médiation étant donné que le message
a déjà été délivré. Toutefois, le message est converti au format de l'intégration de
services (et, en principe, en message d'intégration de services au format JMS) comme s'il était reçu,
cette option permettant de spécifier le niveau de fiabilité du message au format de l'intégration de services. Pour plus
d'informations sur les niveaux de fiabilité disponibles, voir
Points de file d'attente IBM MQ [Paramètres].
- Indiquez si vous voulez que
IBM MQ intègre un en-tête de message
MQRFH2 lors de l'envoi de messages à la file d'attente.
L'en-tête MQRFH2 stocke des informations sur la messagerie d'intégration de services sans
zone d'en-tête de message IBM MQ correspondante. Lorsqu'un
message est envoyé à la destination, l'intégration de services demande à
IBM MQ d'écrire le message dans la file d'attente. Cette option permet de préciser si l'intégration de services demande à IBM MQ d'écrire le message avec un en-tête MQRFH2.
Si le destinataire du message (dans le cas présent, la médiation) est une application JMS s'exécutant dans
IBM MQ ou une intégration de services, une application
IBM MQ XMS ou une application
IBM MQ MQI qui attend un en-tête MQRFH2, sélectionnez cette option. Si
la médiation est une application IBM MQ MQI qui n'attend pas
d'en-tête MQRFH2, ne sélectionnez pas cette option.
- Cliquez sur Suivant.
- Vérifiez le récapitulatif de vos choix, puis cliquez sur Terminer pour
confirmer la médiation de la destination.
Résultats
Vous avez effectué la médiation d'une destination en utilisant une file d'attente
IBM MQ comme point de médiation.