Comment configurer un port de réception et un emplacement de réception pour l’adaptateur MQSC

  • Article

Vous configurez un port de réception et un emplacement de réception pour l’adaptateur BizTalk pour WebSphere MQ à l’aide de la console Administration BizTalk Server. Vous devez être connecté avec un compte membre du groupe d'administrateurs BizTalk Server. En outre, vous devez disposer des autorisations appropriées dans la base de données Sign-On unique (SSO).

Pour configurer un port de réception et un emplacement de réception

  1. Dans Programmes, sélectionnez Microsoft BizTalk Server, puis BizTalk Server Administration.

  2. Dans l’arborescence de la console, développez Groupe BizTalk, Applications, puis sélectionnez l’application pour laquelle vous souhaitez créer un port de réception.

  3. Cliquez avec le bouton droit sur Ports de réception, pointez sur Nouveau, puis cliquez sur Port de réception unidirectionnel.

  4. Dans la fenêtre Propriétés du port de réception , configurez les propriétés du port, puis cliquez sur OK.

  5. Dans l’arborescence de la console, cliquez avec le bouton droit sur Emplacements de réception, pointez sur Nouveau, puis cliquez sur Emplacement de réception unidirectionnel.

  6. Dans la fenêtre Sélectionner un port de réception , cliquez sur le port de réception que vous avez créé à l’étape précédente, puis cliquez sur OK.

  7. Dans la fenêtre Propriétés de l’emplacement de réception, sélectionnez l’adaptateur MQSC comme Type de transport, puis cliquez sur Configurer.

  8. Dans la fenêtre Propriétés de transport de l’adaptateur, configurez les propriétés de l’emplacement de réception (reportez-vous aux tables à la fin de cette procédure).

    Notes

    Les propriétés suivantes sont requises pour configurer un emplacement de réception :

    Nom du canal (il s’agit d’une propriété respectant la casse.)

    Nom de connexion

    Type de transport

    File d’attente (il s’agit d’une propriété respectant la casse.)

    Gestionnaire de files d’attente (il s’agit d’une propriété respectant la casse.)

    Si vous ne spécifiez pas de propriété Channel Name, vous devez fournir un fichier de définition de canal client pour permettre au client WebSphere MQ installé sur l’ordinateur BizTalk Server de communiquer avec les gestionnaires de files d’attente distants. Vous devez également fournir un fichier de définition de canal client si vous configurez SSL (Secure Sockets Layer) pour qu’il fonctionne avec la messagerie transactionnelle. Pour plus d’informations, consultez Guide pratique pour configurer un fichier de définition de canal client.

  9. Une fois que vous avez terminé de configurer les propriétés, cliquez sur OK.

  10. Dans la fenêtre Propriétés de l’emplacement de réception, dans la liste Gestionnaire de réception, sélectionnez le instance de l’hôte BizTalk Server sur lequel l’emplacement de réception s’exécutera.

    Le gestionnaire de réception doit être exécuté sur cet hôte.

  11. Dans la liste Pipeline de réception, sélectionnez le pipeline de réception à utiliser pour recevoir des messages à cet emplacement de réception.

  12. Cliquez sur OK.

  13. Dans la fenêtre Emplacements de réception , cliquez avec le bouton droit sur l’emplacement de réception dans la colonne Nom , puis sélectionnez Activer.

    Propriétés des emplacements de réception

    Dans la section Avancé de la fenêtre Propriétés du transport , vous pouvez définir les propriétés suivantes.

    Propriété Pour
    Décalage des données d'en-tête L’adaptateur utilise des valeurs des en-têtes MQSeries (structures MQMD, MQXQH, MQIIH et MQCIH) et remplit les valeurs correspondantes dans les propriétés de contexte BizTalk Server. Par défaut, il supprime ces propriétés MQSeries du corps du message. Définissez sur Non pour conserver les propriétés dans le corps du message.

    Par défaut : Oui
    Seuil d'erreurs journal événements Nombre maximal de la même erreur à consigner pour certaines conditions d’erreur. L’adaptateur continue de fonctionner et, si l’adaptateur récupère, il journalise l’événement dans le journal des applications.

    Valeur par défaut : 10
    Trié Définissez sur Oui pour conserver l’ordre des messages reçus à partir de la file d’attente MQSeries et envoyés à l’BizTalk Server MessageBox.

    Pour le côté envoi, l’adaptateur envoie le message à la file d’attente dans le même ordre qu’il reçoit de la boîte de message.

    Définissez sur Non pour ne pas maintenir l’ordre des messages.

    Pour les commandes côté envoi, si vous n’utilisez pas Orchestration, vous devez activer la livraison ordonnée dans les options avancées de transport de la configuration du port d’envoi.

    Pour les commandes côté réception, si vous utilisez Orchestration, vous devez également définir la propriété Livraison ordonnée sur True dans votre orchestration pour l’emplacement de réception.

    La livraison ordonnée peut diminuer les performances ; sauf si vous avez besoin d’une livraison commandée, il n’est pas recommandé.

    Par défaut : Non
    Arrêter en cas d'erreur Définissez sur Oui pour arrêter le traitement en cas d’erreur. Cette option permet de mettre fin à la transaction et de désactiver l'emplacement de réception en cas d'erreur.

    Par défaut : Non
    Suspendre sans reprise possible Définissez sur Oui pour déplacer un message dans la file d’attente suspendue en cas d’erreur et indiquer s’il peut être repris ou non.

    L’activation de cette valeur ne préserve pas la remise ordonnée en cas d’erreur, mais permet à l’emplacement de réception de continuer à recevoir des messages.

    Par défaut : Non
    Transaction prise en charge Lorsqu’elle est définie sur Oui, l’adaptateur MQSC fonctionne avec le client transactionnel étendu (Client étendu) WebSphere MQ sur l’ordinateur BizTalk Server pour éviter la perte de messages et garantir la remise unique des messages.

    Lorsqu’il est défini sur Non, la duplication des messages peut se produire. Dans ce cas, l’adaptateur utilise le client WebSphere MQ non transactionnel (client de base) pour l’intégration à MQSeries.

    Par défaut : Non
    Intervalle d’attente Lorsque MQGet est effectué pour récupérer des messages à partir de la file d’attente MQSeries, l’option MQGMO pour l’intervalle d’attente peut être définie. S’il n’y a aucun message dans la file d’attente, l’adaptateur attend la durée spécifiée (en secondes) avant de fermer la demande du client. Dès que les messages arrivent dans la file d’attente, l’adaptateur commence à récupérer les messages.

    Valeur par défaut : 3

    Dans la section Définition de canal du Fenêtre Propriétés de transport, vous pouvez définir les propriétés suivantes.

    Propriété Pour
    Nom du canal Nom du canal défini sur l’ordinateur MQSeries Server avec lequel le client communique. Il doit s’agir d’un type de canal « Connexion au serveur ».

    Notez qu’il s’agit d’une propriété respectant la casse.
    Nom de connexion Nom du serveur MQSeries qui contient le Gestionnaire de files d’attente et les files d’attente dont l’adaptateur MQSC reçoit des messages.

    Pour le type de transport TCP, le format à spécifier est SERVERNAME(PORT). Le numéro de port est équivalent au numéro de port défini dans l’écouteur associé au gestionnaire de files d’attente.

    Le nom du serveur peut également être spécifié en tant qu’adresse IP.

    Pour LU6.2, spécifiez le nom de l’unité logique ou le nom du pool d’unités logiques configurés dans Host Integration Server.
    Battement de coeur Nombre de secondes entre les vérifications pour vérifier que la connexion client/serveur fonctionne.

    Par défaut : 300
    Mot de passe Mot de passe qui peut être utilisé par le MCA lors de la tentative d’initialisation d’une session lu 6.2 sécurisée avec un MCA distant.

    La valeur initiale de cette propriété facultative est null.
    Spécification de chiffrement SSL Définit une spécification de chiffrement unique pour une connexion SSL qui sera utilisée par le point de terminaison configuré dans l’adaptateur. Les deux extrémités d’une définition de canal SSL WebSphere MQ doivent inclure l’attribut, et la valeur spécifiée ici doit correspondre au nom spécifié à l’extrémité du serveur du canal. La valeur est une chaîne d’une longueur maximale de 32 caractères.

    Obligatoire uniquement lorsque SSL est configuré pour la communication entre le client MQSeries et les gestionnaires de files d’attente distants.
    Nom de l’homologue SSL Utilisé pour case activée le nom unique (également appelé DN) du certificat à partir du gestionnaire de files d’attente ou du client homologue à l’autre extrémité d’un canal WebSphere MQ. Si le nom unique reçu de l’homologue ne correspond pas à cette valeur, le canal ne démarre pas.

    Obligatoire uniquement lorsque SSL est configuré pour la communication entre le client MQSeries et les gestionnaires de files d’attente.
    Type de transport TCP et LU6.2 sont pris en charge.

    Par défaut : TCP
    Identifiant utilisateur Identificateur d’utilisateur MCA utilisé par MQSeries MCA pour l’autorisation d’accéder aux ressources MQSeries.

    La valeur initiale est null. Propriété facultative. Lorsque cet attribut est vide, le MCA utilise son identificateur d’utilisateur par défaut.

    Dans la section MQSeries du Fenêtre Propriétés de transport, vous pouvez définir les propriétés suivantes.

    Propriété Pour
    Jeu de caractères Jeu de caractères vers lequel le message doit être converti lorsque des messages sont reçus à partir de la file d’attente MQSeries. Si cette propriété est définie sur une valeur autre que None, l’adaptateur définit l’option CONVERT MQGMO lors de l’exécution d’un MQGet.

    Aucun : ne pas convertir.

    UCS-2 et UTF-16 : convertissez en ces jeux de caractères. MQSeries ne fait pas de distinction entre eux.

    UTF-8 : convertir en jeu de caractères UTF-8.

    Valeur par défaut : None
    Segmentation autorisée Définir MQSeries pour assembler les messages segmentés ou pour obtenir le message tel quel. Utilisez Aucune action pour lire les messages de la file d'attente MQSeries sans activer la segmentation. Utilisez Achever message pour que MQSeries assemble les messages segmentés avant leur transmission à l'adaptateur.

    Valeur par défaut : aucune action

    Dans la section Performances du Fenêtre Propriétés de transport, vous pouvez définir les propriétés suivantes.

    Propriété Pour
    Taille maximale du lot Taille maximale d’un lot de messages en Ko.

    Cette propriété et Le nombre maximal de messages dans Batch fonctionnent ensemble de sorte que la limite correspond à la valeur que l’adaptateur atteint en premier.

    Valeur par défaut : 100
    Maximum de messages dans le lot Nombre maximal de messages compris entre 1 et 10 000 dans un lot.

    Cette propriété et la taille maximale du lot fonctionnent ensemble de sorte que la limite correspond à la valeur que l’adaptateur atteint en premier.

    Valeur par défaut : 10
    Threads Nombre de threads utilisés par emplacement de réception.

    Valeur par défaut : 2

    Dans la section Définition de file d’attente du Fenêtre Propriétés de transport, vous pouvez définir les propriétés répertoriées dans le tableau suivant.

    Propriété Pour
    File d'attente File d’attente MQSeries à partir de laquelle l’adaptateur recevra des messages (MQGet).

    Les files d’attente de transmission, les files d’attente locales et les files d’attente d’alias sont prises en charge.

    Notez qu’il s’agit d’une propriété respectant la casse.
    Gestionnaire de file d'attente Nom du Gestionnaire de files d’attente MQSeries qui contient les files d’attente à partir desquelles l’adaptateur récupère les messages.

    Les gestionnaires de file d’attente en cluster sont pris en charge.

    Notez qu’il s’agit d’une propriété respectant la casse.

  14. Cliquez sur OK.

Voir aussi

Adaptateur BizTalk pour WebSphere MQ
Guide pratique pour configurer un fichier de définition de canal client
Comment configurer un port d’envoi pour l’adaptateur MQSC