Propriétés de liaison et de règle WSReliableMessaging
Utilisez le paramètre attributes pour les commandes setPolicyType et setBinding, afin d'indiquer des informations de configuration supplémentaires relatives à la règle ReliableMessaging et à la liaison des ensembles de règles. La qualité de service WSReliableMessaging n'est disponible que pour les ensembles de règles d'une application.
WSReliableMessaging est une norme d'interopérabilité destinée à garantir la fiabilité de la transmission de messages entre deux points de contact. Utilisez WSReliableMessaging pour sécuriser et vérifier des transactions lors de l'utilisation de services Web d'un métier à l'autre.
- Utilisez le paramètre -attributes des commandes getPolicyType et getBinding pour afficher les propriétés de la configuration des règles et des liaisons. Pour obtenir un attribut, associez le nom de la propriété à la commande getPolicyType ou getBinding.
- Utilisez le paramètre -attributes pour les commandes setPolicyType et setBinding afin d'ajouter des propriétés à la configuration des règles et des liaisons, d'en mettre à jour ou d'en supprimer. Pour ajouter ou mettre à jour un attribut, spécifiez le nom de la propriété et sa valeur. Les commandes setPolicyType et setBinding mettent à jour la valeur si l'attribut existe ou ajoutent l'attribut et la valeur s'il n'existe pas. Pour supprimer un attribut, spécifiez la valeur sous forme de chaîne vide (""). Le paramètre -attributes admet l'objet properties.

Pour prendre en charge un environnement à cellules mixtes, WebSphere Application Server prend en charge des liaisons version 7.0 et version 6.1. Les liaisons générales de niveau cellule sont spécifiques à la version 7.0. Les liaisons propres à l'application restent à la version requise par celle-ci. Lorsque l'utilisateur crée une liaison propre à l'application, le serveur d'applications détermine la version de liaison requise à utiliser pour celle-ci.
Propriétés de règle WSReliableMessaging
- specLevel
- Sélectionnez la norme WS-ReliableMessaging à utiliser pour la transmission fiable de vos messages. La spécification WS-ReliableMessaging version 1.1 est la valeur par défaut. Pour choisir un niveau de spécification, utilisez les informations suivantes :
- Indiquez 1.0 comme valeur pour l'attribut specLevel, afin d'utiliser la spécification WS-ReliableMessaging version 1.0, niveau de spécification février 2005.
- Indiquez 1.1 comme valeur pour l'attribut specLevel, afin d'utiliser la spécification OASIS WS-ReliableMessaging version 1.1, niveau de spécification août 2006.
L'exemple de code suivant paramètre la propriété specLevel sur la spécification OASIS WS-ReliableMessaging version 1.1, août 2006 :AdminTask.setPolicyType('[-policySet "CustomWSReliableMessaging" -policyType WSReliableMessaging -attributes "[[specLevel 1.1]]"]')
- inOrderDelivery
- Indique si les messages doivent être traités dans l'ordre dans lequel ils sont reçus. Si vous utilisez la propriété inOrderDelivery, les messages entrants peuvent être mis en file d'attente jusqu'à la distribution des messages antérieurs.L'exemple de code suivant active la propriété inOrderDelivery :
AdminTask.setPolicyType('[-policySet "CustomWSReliableMessaging" -policyType WSReliableMessaging -attributes "[[inOrderDelivery true]]"]')
- qualityOfService
- Indique la qualité du service WSReliableMessaging à utiliser. Définissez une des trois valeurs suivantes pour l'attribut qualityOfService :
- unmanagedNonPersistent
Les défaillances de réseau et de système distant sont tolérées. La qualité de service unmanagedNonPersistent n'est pas transactionnelle. Lorsque cette valeur est configurée, les messages sont perdus en cas de défaillance d'un serveur. Cette qualité de service n'est prise en charge pour tous les environnements que si l'environnement est configuré sous la forme d'un demandeur de service Web.
- managedNonPersistent
Les défaillances de système, de réseau et de système distant sont tolérées. Cependant, l'état de message est ignoré lorsque le moteur de messagerie redémarre. La qualité de service managedNonPersistent n'est pas transactionnelle. Cette valeur empêche la perte de message en cas de défaillance d'un serveur. Cependant, les messages sont perdus si le moteur de messagerie échoue. Les applications de client géré et léger ne peuvent pas utiliser cette qualité de service.
- managedPersistent
Les défaillances de système, de réseau et de système distant sont tolérées. Cette valeur permet de traiter les messages au sein de transactions et de les conserver sur le demandeur et le fournisseur de service Web. Les messages peuvent être récupérés en cas de défaillance d'un serveur. Les messages qui ne sont pas correctement transmis au moment de la défaillance se poursuivent lors du démarrage de l'application ou du moteur de messagerie. Les applications de client géré et léger ne peuvent pas utiliser cette qualité de service.
L'exemple suivant définit la propriété qualityOfService comme étant non gérée non permanente :AdminTask.setPolicyType('[-policySet "CustomWSReliableMessaging" -policyType WSReliableMessaging -attributes "[[qualityOfService unmanagedNonPersistent]]"]')
- unmanagedNonPersistent
AdminTask.setPolicyType('[-policySet "CustomWSReliableMessaging" -policyType
WSReliableMessaging -attributes "[[specLevel 1.1][inOrderDelivery true][qualityOfService
unmanagedNonPersistent]]"]')
Attributs de configuration de liaison WSReliableMessaging
- busName
- Nom du bus d'intégration de services contenant le moteur de messagerie à utiliser pour les options de qualité de service managedNonPersistent ou managedPersistent.L'exemple suivant paramètre la propriété busName sur myBus :
AdminTask.setBinding('[-bindingLocation "" -bindingName cellWideBinding2 -policyType WSReliableMessaging -attributes "[[busName myBus]]"]')
- messagingEngineName
- Nom du moteur de messagerie à utiliser pour les options de qualité de service managedNonPersistent ou managedPersistent.L'exemple suivant paramètre la propriété messagingEngineName sur messagingEngine001 :
AdminTask.setBinding('[-bindingLocation "" -bindingName cellWideBinding2 -policyType WSReliableMessaging -attributes "[[messageEngineName messageEngine001]]"]')
AdminTask.setBinding('[-bindingLocation "" -bindingName cellWideBinding2 -policyType
WSReliableMessaging -attributes "[[busName myBus][messageEngineName messageEngine001]]"]')