Mappage des zones de rapport MQMD à des propriétés spécifiques au fournisseur JMS

Les applications JMS peuvent utiliser des messages de rapport comme forme de traitement des requêtes/réponses gérées, afin de fournir aux expéditeurs des messages des informations en retour sur le résultat des opérations qu'ils ont envoyé et sur la manière dont leurs messages ont été traités. Une application JMS peut demander les types de messages de rapport suivants en définissant les options et propriétés de message JMS_IBM_Report_Xxxx appropriées.

Les applications JMS peuvent demander les types de messages de rapport suivants en définissant les options et propriétés de message JMS_IBM_Report_Xxxx appropriées. Les options ont la signification et la syntaxe générales suivantes :
MQRO_type-rapport
Un message de rapport du type indiqué est généré. Il contient le descripteur IBM MQ (MQMD) du message d'origine. Il ne contient aucun corps de message.
MQRO_type-rapport_WITH_DATA
Un message de rapport du type indiqué est généré. Il contient le MQMD, les éventuels en-têtes MQ et 100 octets du corps de message.
MQRO_type_rapport_WITH_FULL_DATA
Un message de rapport du type indiqué est généré. Il contient l'intégralité du message d'origine.

Utilisez le préfixe suivant avec chaque option : com.ibm.websphere.sib.api.jms.

Par exemple, pour demander un message de rapport COD (Confirm on delivery) contenant toutes les données, l'application JMS doit paramétrer JMS_IBM_Report_COD sur la valeur com.ibm.websphere.sib.api.jms.MQRO_COD_WITH_FULL_DATA.

Pour chaque type de message de rapport, le tableau suivant répertorie la propriété de message JMS_IBM_Report_Xxxx que peut définir une application JMS et les options de zone MQMD associées à la propriété.

Type de message de rapport Description Options et propriétés de message JMS_IBM_Report_Xxxx
Exception Envoie un message de rapport lorsque le message de demande ne peut pas être placé dans la file d'attente cible. Les messages de rapport d'exception sont générés lorsqu'un message a été redirigé vers la destination de l'exception. JMS_IBM_Report_Exception
  • MQRO_EXCEPTION
  • MQRO_EXCEPTION_WITH_DATA
  • MQRO_EXCEPTION_WITH_FULL_DATA
Suppression Supprimez le message de demande d'origine au lieu de l'envoyer vers une destination d'exception. Vous pouvez utiliser cette option avec la propriété JMS_IBM_Report_Exception paramétrée sur MQRO_EXCEPTION_WITH_FULL_DATA afin de retourner un message de demande non délivrable vers son expéditeur. JMS_IBM_Report_Discard_Msg
  • TRUE
  • FALSE
Expiration Envoie un message de rapport lorsque le message de demande a dépassé son heure d'expiration. JMS_IBM_Report_Expiration
  • MQRO_EXPIRATION
  • MQRO_EXPIRATION_WITH_DATA
  • MQRO_EXPIRATION_WITH_FULL_DATA
COA (Confirm On Arrival, confirmation à l'arrivée) Envoie un message de rapport une fois le message de demande placé dans la file d'attente cible.

Dans le cas de la messagerie de publication/d'abonnement, le message de rapport COA n'est généré que sur le moteur de messagerie des expéditeurs. En conséquence, ce type de rapport ne présente d'intérêt que pour les abonnements locaux.

Dans le cas de la messagerie point à point, les messages COA sont générés lorsque le message arrive à sa destination finale. Dans le cas des files d'attente partitionnées, le message de rapport n'est généré qu'une fois le placement du message validé et une destination finale sélectionnée. Toute option de rapport With_Data ou With_Full_Data est ignorée ; le message de rapport COA ne traite que les en-têtes de message.

Si un chemin d'acheminement de transmission est utilisé, le message COA est généré lorsque le message arrive à la destination finale du chemin.

JMS_IBM_Report_COA
  • MQRO_COA
  • MQRO_COA_WITH_DATA
  • MQRO_COA_WITH_FULL_DATA
COD (Confirm On Delivery, confirmation à la livraison) Envoie un message de rapport une fois que le message de demande a été supprimé de la file d'attente ou de l'espace des sujets par un destinataire du message.

Dans le cas de la messagerie de publication/d'abonnement, le message COD est généré lorsque tous les abonnés ont reçu le message de demande. En conséquence, un seul message COD est généré pour chaque COA. Lorsqu'un message est réceptionné par un destinataire, le nombre de référence du message sur l'espace de sujet est réduit. Lorsque le nombre de référence atteint zéro, le message est supprimé de l'espace de sujet et un message de rapport COD est généré.

Dans le cas de la messagerie de publication/d'abonnement, le message COD est généré une fois le message réceptionné par une application client. Toute option de rapport With_Data ou With_Full_Data est ignorée ; le message de rapport COD ne traite que les en-têtes de message.

JMS_IBM_Report_COD
  • MQRO_COD
  • MQRO_COD_WITH_DATA
  • MQRO_COD_WITH_FULL_DATA
PAN (Positive Action Notification, notification action positive) Demande à l'application client d'envoyer un message de rapport lorsqu'elle a réussi à traiter le message de demande. JMS_IBM_Report_PAN
  • TRUE
  • FALSE
NAN (Negative Action Notification,notification action négative) Demande à l'application client d'envoyer un message de rapport si elle n'a pas réussi à traiter le message de demande. JMS_IBM_Report_NAN
  • TRUE
  • FALSE
L'application demandeuse peut également contrôler les points suivants concernant le message de rapport :
  • Mode de génération de l'ID de message pour le message de rapport et pour tout message de réponse :
    MQRO_New_Msg_Id
    Il s'agit de la valeur par défaut. Un nouvel ID de message est généré pour le message de rapport.
    MQRO_Pass_Msg_Id
    L'ID de message du message de rapport est celui du message de demande.
  • Mode de définition de l'ID de corrélation du message de rapport ou de réponse.
    MQRO_Copy_Msg_Id_To_Correl_Id
    Il s'agit de la valeur par défaut. L'ID de corrélation du message de rapport est défini sur l'ID de message du message de demande.
    MQRO_Pass_Correl_Id
    L'ID de corrélation du message de rapport correspond à l'ID de corrélation du message de demande.

Pour plus d'informations sur les message de rapport et les propriétés et options associées, voir la section Using Java™ du centre de documentation WebSphere MQ accessible depuis la bibliothèque WebSphere MQ.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjc0009_
Nom du fichier : rjc0009_.html