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é.
- Caractéristiques des files d'attente et des messages - où vous spécifiez des propriétés pour les caractéristiques des files d'attente et des messages.
- Règles de distribution - où vous spécifiez le mode de distribution des messages.
- Options de nouvelle tentative - où vous spécifiez le temps d'attente entre chaque tentative et le nombre de tentatives avant l'échec.
Une fois les tâches Configurer terminés, Mappage de sorties pour l'activité.
Caractéristiques des files d'attente et des messages
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.
|
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
- 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.