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

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 Single Sign-On (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, développez 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).

    Remarque

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

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

    Nom de connexion

    Type de transport

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

    Gestionnaire de files d’attente (il s’agit d’une propriété sensible à 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 des gestionnaires de réception, sélectionnez l’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 des pipelines 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 (MQMD, MQXQH, MQIIH et structures 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éfini sur Non pour conserver les propriétés dans le corps du message.

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

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

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

    Défini sur Non pour ne pas conserver l’ordre des messages.

    Pour le classement 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 l’ordre côté réception, si vous utilisez Orchestration, vous devez également définir la propriété Order Delivery sur True dans votre orchestration pour l’emplacement de réception.

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

    Valeur par défaut : Non
    Arrêter en cas d'erreur Affectez la valeur 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.

    Valeur par défaut : Non
    Suspendre sans reprise possible Affectez la valeur Oui pour déplacer un message vers la file d’attente suspendue en cas d’erreur et indiquer s’il est pouvant être repris ou non.

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

    Valeur par défaut : Non
    Transaction prise en charge Lorsqu’il est défini sur Oui, l’adaptateur MQSC fonctionne avec le client transactionnel étendu WebSphere MQ (Extended-Client) sur l’ordinateur BizTalk Server pour empêcher la perte de messages et garantir une remise de messages une seule fois et une seule fois.

    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 (Base-Client) pour l’intégration à MQSeries.

    Valeur 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 l’heure 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.

    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 serveur MQSeries 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é sensible à 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 les 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 lu configuré 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 de lancement 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 du 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é sur la fin du serveur du canal. La valeur est une chaîne dont la longueur maximale est 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 Permet de vérifier le nom unique (également appelé DN) du certificat à partir du gestionnaire de file d’attente homologue ou du client à 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.

    Valeur par défaut : TCP
    ID 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, 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 les 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 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 de l’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 Les messages maximum dans Batch fonctionnent ensemble afin que la limite soit 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 de lot fonctionnent ensemble afin que la limite soit 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 les messages (MQGet).

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

    Notez qu’il s’agit d’une propriété sensible à la casse.
    Gestionnaire de file d'attente Nom du Gestionnaire de file d’attente MQSeries qui contient les files d’attente à partir desquels 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é sensible à 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