Activité MQ Placer message

Utilisez l'activité MQ Placer message pour envoyer un message à la file d'attente spécifiée lors de l'exécution.

Remarque : Vous devez avoir créé sur un noeud final pour l'activité MQ avant de configurer l'activité.
La tâche Configurer est composée de trois sections :

Une fois les tâches Configurer terminées et Entrées de mappage pour l'activité.

Remarque : La taille maximale de message est 100 Mo.

Caractéristiques des files d'attente et des messages

Spécifiez les caractéristiques des files d'attente et des messages à l'aide des zones du tableau suivant. Les zones obligatoires sont marquées d'un astérisque.
Zone Description
Nom de file d'attente * Indique le nom de la file d'attente où sont placés les messages.
Type de données utiles Indique le type de données de la charge de message, binaire ou chaîne.
Type de message Datagramme - Indiquez si le message doit être envoyé et si aucune réponse n'est nécessaire.

Demande - Indiquez si le message doit recevoir une réponse. Veillez à définir la propriété File d'attente de réponse pour les messages de demande.

Réponse - Indiquez si le message est une réponse à une demande précédente.

File d'attente de réponse Indique la file d'attente à laquelle la réponse doit être envoyée pour les messages de demande.
Gestionnaire de file d'attente de réponse Indique le nom du gestionnaire de file d'attente auquel appartient la file d'attente (spécifié dans la zone File d'attente de réponse).
Persistant
  • True - Les messages sont restaurés dans des files d'attente si le gestionnaire de file d'attente tombe en panne.
  • False - Les messages peuvent être perdus de la file d'attente si le gestionnaire de file d'attente tombe en panne.
  • Par défaut - Les messages utilisent le paramètre de persistance pour la file d'attente (valeur par défaut).
Priorité Spécifie la priorité du message.Par défaut, la priorité du message est la priorité par défaut de la file d'attente. Si la file d'attente utilise des priorités pour classer les messages et qu'une priorité particulière doit être définie pour ce message, sélectionnez Spécifier et entrez la priorité. Les priorités peuvent aller de 1 (la plus faible) jusqu'à 9 (la plus élevée).
Remarque : La priorité ne doit pas excéder le nombre de priorité maximum défini pour la file d'attente MQ. Vérifiez ces informations auprès de votre administrateur système MQ.
Expiration du message Nombre de secondes pendant lesquelles les messages sont conservés dans la file d'attente avant leur expiration. La valeur par défaut est Jamais, ce qui assure que le message est distribué et attend en file d'attente jusqu'à son extraction, quelle que soit cette durée.

Si des messages de cette file d'attente doivent expirer et être supprimés après une durée déterminée, sélectionnez Spécifier et entrez le nombre maximum de secondes pendant lequel le message doit être conservé en file d'attente.

Fragment de schéma pour en-tête MQRFH2 Indique qu'un en-tête MQRFH2 est inclus dans le message. S'il s'agit d'un message XML qui inclut un en-tête MQRFH2, cochez cette case et cliquez sur [...]. Dans la boîte de dialogue Recherche d'élément de type de schéma, recherchez le schéma XML qui définit l'en-tête, sélectionnez l'élément NameValueData dans ce schéma XML et cliquez sur OK. Le fragment de schéma est l'élément NameValueData et tous ses éléments enfant.
Remarque : Vous devez d'abord créer le schéma XML qui définit l'en-tête et le charger dans le projet pour pouvoir le sélectionner. Pour plus d'informations, voir Définition et chargement d'un schéma XML pour un en-tête MQRFH2.

Règles de distribution

Zone Description
Distribuer des messages Les options disponibles sont les suivantes :
  • Au moins une fois - Indique que le message est distribué au moins une fois mais qu'il peut être distribué plusieurs fois. Les échecs de la connexion ou du dispositif d'intégration peuvent générer des messages qui sont extraits et traités plusieurs fois. Cette option de distribution est généralement utilisée lorsque le système de réception peut détecter ou tolérer des messages dupliqués.
  • Pas plus d'une fois - Indique que le message est distribué une seule fois ou pas du tout. Les échecs de la connexion ou du dispositif d'intégration peuvent générer des messages qui sont perdus. Cette option de distribution est généralement utilisée lorsque le système de réception ne peut pas tolérer les messages dupliqués mais peut tolérer les messages perdus.

Options de nouvelle tentative

Configurez les options de nouvelle tentative pour la connexion à un serveur MQ. Le tableau suivant décrit les options de nouvelle tentative de connexion à un serveur MQ :

Option de nouvelle tentative Description
1) Attendre ___ seconde(s) entre chaque tentative. Nombre de secondes pendant lesquelles le dispositif d'intégration attend avant de tenter à nouveau de contacter le gestionnaire de files d'attente pour envoyer un message au serveur MQ.
2) Tenter de se connecter ___ fois avant l'échec. Indique le nombre maximum de fois que le dispositif d'intégration tente de contacter le gestionnaire de files d'attente pour envoyer un message au serveur MQ avant d'émettre une erreur et d'arrêter le traitement du travail d'orchestration en cours.

Si vous déployez une orchestration qui contient une activité MQ Placer message et que le dispositif d'intégration ne peut pas se connecter au gestionnaire de files d'attente du serveur MQ spécifié, le dispositif d'intégration consigne les erreurs en tant qu'avertissements dans les journaux du système et de l'orchestration jusqu'à ce que la valeur de nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans les journaux du système et de l'orchestration et arrête le traitement du travail d'orchestration en cours.

Par exemple, si vous indiquez la valeur 3 pour le nombre de tentatives, les erreurs de première, seconde et troisième connexions apparaissent dans le journal système en tant qu'avertissements. Le dispositif d'intégration consigne la quatrième erreur en tant qu'erreur et arrête le traitement du travail d'orchestration en cours.

Entrées de mappage

Vous devez mapper des paramètre d'entrée pour cette activité. Les paramètres suivants sont obligatoires ; ils doivent être mappés pour que la configuration soit complète. Tous les autres paramètres sont facultatifs. Pour plus d'informations, voir Création d'une mappe.
Paramètres d'entrée obligatoires
charge

Pour afficher les paramètres d'entrée facultatifs dans le panneau Vers l'activité du panneau Mapper les entrées, sélectionnez Mapper > Afficher les paramètres facultatifs dans le menu de la barre d'outils ou cliquez avec le bouton droit de la souris dans le panneau Vers l'activité et sélectionnez l'option Afficher les paramètres facultatifs. Si l'option Mapper > Afficher les paramètres facultatifs ne peut pas être sélectionnée dans le menu de la barre d'outils, cliquez sur un noeud dans le panneau Mapper les entrées pour activer cette option.