Comment configurer un emplacement de réception MSMQ

Vous pouvez définir des variables d’adaptateur d’emplacement de réception MSMQ dans la console Administration de BizTalk Server. Si les propriétés ne sont pas définies à l’emplacement de réception, les valeurs de gestionnaire de réception par défaut définies dans la console Administration de BizTalk Server sont utilisées.

Remarque

Avant d’effectuer la procédure suivante, vous devez avoir déjà ajouté un port de réception. Pour plus d’informations, consultez Comment créer un port de réception.

Important

Si une instance hôte est associée à un port d’envoi OU un emplacement de réception MSMQ, vérifiez que le service MSMQ s’exécute sur cet ordinateur. Si le service n’est pas en cours d’exécution, les ports de réception MSMQ s’arrêtent peu après leur démarrage et les messages envoyés aux ports d’envoi MSMQ sont suspendus.

Dans un scénario cluster, non seulement l’instance MSMQ en cluster doit être en cours d’exécution, mais le service MSMQ local sur chaque ordinateur de cluster doit également être en cours d’exécution.

Pour configurer des variables pour un emplacement de réception MSMQ

Procédez comme suit pour configurer des variables pour un emplacement de réception MSMQ :

1. Dans la console Administration de BizTalk Server, développez Administration bizTalk Server, développez Groupe BizTalk, développez Applications, puis développez l’application dans laquelle vous souhaitez créer un emplacement de réception.

2. Dans la console Administration de BizTalk Server, dans le volet gauche, cliquez sur le nœud Port de réception . Ensuite, dans le volet droit, cliquez avec le bouton droit sur le port de réception associé à un emplacement de réception existant ou que vous souhaitez associer à un nouvel emplacement de réception, puis cliquez sur Propriétés.

3. Dans la boîte de dialogue Propriétés du port de réception , dans le volet gauche, sélectionnez Emplacements de réception, puis, dans le volet droit, double-cliquez sur un emplacement de réception existant ou cliquez sur Nouveaupour créer un emplacement de réception.

4. Dans la boîte de dialogue Propriétés de l’emplacement de réception , dans la section Transport en regard de Type, sélectionnez MSMQ dans la liste déroulante, puis cliquez sur Configurer.

5. Dans la boîte de dialogue Propriétés du transport MSMQ , procédez comme suit :

   Utiliser cette option	Pour ce faire	Type de date	Valeur par défaut
   Mot de passe	Définissez un mot de passe à utiliser pour une file d’attente distante.	Chaîne	Vide
   Nom d’utilisateur	Déterminez le nom d’utilisateur à utiliser, en combinaison avec le mot de passe, pour accéder à une file d’attente distante. Vous ne pouvez pas utiliser l’utilisateur local de l’ordinateur distant pour le nom d’utilisateur.	Chaîne	Vide
   Taille du lot	Configurez la taille du lot. L’adaptateur MSMQ envoie des messages à la base de données MessageBox par lots. La taille de lot par défaut est 20, et la taille minimale du lot est de 1. Note: Si la propriété transactionnelle de l’emplacement de réception a la valeur True ; chaque lot de messages est envoyé à la base de données MessageBox dans le contexte d’une transaction MSDTC (Microsoft Distributed Transaction Coordinator). La transaction MSDTC créée pour un lot de messages reste ouverte jusqu’à ce que chaque message du lot ait été conservé dans messageBox et placé dans la file d’attente d’abonné appropriée. Par conséquent, la durée de cette transaction MSDTC est augmentée à mesure que le paramètre Taille du lot est augmenté. Étant donné qu’un grand nombre de transactions MSDTC ouvertes simultanément peut avoir un impact négatif sur les performances globales, le paramètre Batch Size ne doit pas être défini sur une valeur très importante lorsque la prise en charge des transactions est activée.	Int	20
   En cas d’échec	Spécifiez la façon dont l’adaptateur doit répondre à une erreur. Définissez cette propriété sur l’une des valeurs suivantes : - Arrêter. Arrêtez la réception de messages via cet emplacement de réception si une condition d’erreur se produit. - Suspend(non pouvant être repris). Suspendez les messages et marquez comme non pouvant être repris. - Suspend(pouvant être repris). Suspendez les messages et marquez comme pouvant être repris. Important: Si l’option True pour la propriété Traitement ordonné , l’option Arrêter pour la propriété Échec et l’option False de la propriété Transactionnelle sont appliquées en même temps, tous les messages qui échouent ne seront pas suspendus ou laissés dans la file d’attente source. Dans ce scénario, la perte de messages peut se produire. Pour éviter la perte de données, lors de l’utilisation de la fonctionnalité Traitement ordonné , l’option Arrêter pour la propriété En cas d’échec ne doit être appliquée que si l’option True de la propriété transactionnelle est appliquée. Ensuite, si un échec de remise de message se produit, le message d’origine est laissé dans la file d’attente MSMQ source. Si la propriété Traitement ordonné est définie sur la valeur False, la propriété On Failure ne prend pas effet et si un échec de remise de message se produit, le message est suspendu avec l’état Suspendu (pouvant être repris).	Chaîne	Suspend(pouvant être repris)
   Traitement ordonné	Définissez cette propriété sur True ou False. Cela indique s’il faut traiter les messages en série. La définition de la propriété sur True prend en charge la remise des messages ordonnés lorsqu’elle est utilisée conjointement avec une messagerie BizTalk ou un port d’envoi d’orchestration dont l’option Livraison ordonnée a la valeur True. Pour plus d’informations, consultez Remise ordonnée des messages. La définition de cette propriété sur True optimise également l’utilisation des ressources lors de la gestion des messages volumineux en rendant l’adaptateur monothread. Pour plus d’informations, consultez Envoi et réception de messages volumineux à l’aide de l’adaptateur MSMQ.	Booléen	Faux
   Queue	Tapez un chemin d’accès de file d’attente valide. Selon le chemin de file d’attente que vous spécifiez, le système effectue les validations appropriées. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères. Note: L’adaptateur de réception MSMQ utilise un mécanisme d’interrogation pour surveiller la file d’attente MSMQ spécifiée pour les nouveaux messages toutes les 0,5 secondes. Cet intervalle de 0,5 seconde est un intervalle fixe.	Chaîne	Vide
   Transactionnelle	Définissez cette propriété sur True ou False. Note: L’adaptateur prend en charge les lectures transactionnelles des files d’attente distantes avec Message Queuing 4.0 ou version ultérieure uniquement. Dans ce scénario, BizTalk Server et le serveur Message Queuing distant doivent exécuter Message Queuing 4.0 ou version ultérieure. Pour plus d’informations, consultez Configuration de l’adaptateur MSMQ et considérations relatives à l’exécution de gestionnaires d’adaptateurs au sein d’un hôte cluster.	Booléen	Faux

   Remarque

   Le nom d’utilisateur et le mot de passe s’appliquent uniquement aux comptes Windows utilisés pour accéder aux files d’attente distantes.

6. Cliquez sur OK.

7. Dans la boîte de dialogue Propriétés de l’emplacement de réception, entrez les valeurs appropriées pour terminer la configuration de l’emplacement de réception, puis cliquez sur OK pour enregistrer les paramètres. Pour plus d’informations sur la boîte de dialogue Propriétés des emplacements de réception , consultez Comment créer un emplacement de réception.

Voir aussi

Configuration de l’adaptateur MSMQ