Activité MQ Interroger file d'attente

Utilisez l'activité MQ Interroger file d'attente pour rechercher régulièrement des messages dans la file d'attente MQ en fonction d'un intervalle entre les tentatives que vous avez spécifié.

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és, Mappage de sorties 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 dans laquelle les messages sont recherchés.
Type de données utiles Indique le type de données de la charge de message, binaire ou chaîne.
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
Interroger les modifications Indique la fréquence d'interrogation de la file d'attente par le dispositif d'intégration pour rechercher des modifications. Pour plus d'informations, voir Comportement de l'intervalle d'interrogation.
Où les messages ont des ID uniques Indique si les messages de la file d'attente ont des ID uniques.
Distribuer des messages Les options disponibles ici varient selon que vous avez ou non coché la case Où les messages ont des ID uniques. Si cette case est cochée, les trois options sont disponibles. Si elle n'est pas cochée, seule l'option Au moins une s'affiche.
  • 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.
  • Une fois exactement - Indique que le message est distribué une seule fois. Les échecs de connexion ou du dispositif d'intégration n'affectent pas la distribution avec cette option. Le dispositif d'intégration utilise les ID de messages MQ pour garantir que chaque messages est extrait et traité une fois exactement.
    Remarque : Si vous sélectionnez l'option Une fois exactement, vous devez activer la persistance. Pour plus d'informations, voir Activation de la persistance.

Options de nouvelle tentative

Configurez les options de nouvelle tentative de l'activité MQ Interroger file d'attente, comme défini dans le tableau suivant :

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 d'extraire des messages du serveur MQ.
2) Tenter de se connecter __ fois avant l'échec. Indique le nombre maximum de fois que le dispositif d'intégration tente d'extraire des messages du serveur MQ avant l'échec.

Si vous déployez une orchestration qui commence par une activité MQ Interroger file d'attente et que le dispositif d'intégration ne peut pas se connecter au serveur MQ spécifié ou ne peut pas extraire les messages de la file d'attente, le dispositif d'intégration consigne les erreurs en tant qu'avertissements dans le journal système jusqu'à ce que la valeur du nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans le journal système, remet le nombre de tentatives en cours à zéro et poursuit les tentatives d'établissement d'une connexion au serveur MQ.

Par exemple, si vous indiquez la valeur 3 pour le nombre de tentatives, les première, deuxième et troisième erreurs 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 remet à zéro le nombre de tentatives en cours. Par conséquent, la cinquième erreur de connexion génère un avertissement dans le journal système. Le dispositif d'intégration continue de tenter l'extraction de messages de la file d'attente.

Mappage de sorties

Il n'est pas obligatoire de mapper les paramètre de sortie pour cette activité. Toutefois, si vous mappez l'un de ces paramètres, notez les points suivants :
Paramètres :
  • Les paramètres payload et mqmdheader sont extraits du message envoyé de la file d'attente.
  • Le paramètre rfh2header est extrait si le schéma de l'en-tête RFH2 est spécifié dans la tâche Configurer.