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.

Les commandes et paramètres du groupe PolicySetManagement de l'objet AdminTask permettent de personnaliser la configuration de votre ensemble de règles.
  • 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.
Remarque : Si une valeur ou un nom de propriété indiqué avec le paramètre -attributes n'est pas valide, les commandes setPolicyType et setBinding échouent et génèrent une exception. La propriété qui n'est pas valide est consignée sous forme d'erreur ou d'avertissement dans le fichier SystemOut.log. Toutefois, l'exception de la commande ne contient pas toujours d'informations détaillées relatives à la propriété à l'origine de l'exception. Si les commandes setPolicyType et setBinding échouent, recherchez dans le fichier SystemOut.log d'éventuels messages d'erreur ou d'avertissement indiquant que l'entrée du paramètre -attributes contient une ou plusieurs propriétés non valides.
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.
Pour les utilisateurs en transition Pour les utilisateurs en transition: Dans WebSphere Application Server version 7.0 et les versions ultérieures, le modèle de sécurité était amélioré de sorte à être centré sur le domaine et non plus centré sur le serveur. La configuration du niveau de sécurité globale par défaut ( cellule) et les liaisons par défaut au niveau du serveur ont également changé dans cette version du produit. Dans WebSphere Application Server version 6.1 Feature Pack for Web Services, vous pouvez configurer un ensemble de liaisons par défaut pour la cellule et configurer en option un ensemble de liaisons par défaut pour chaque serveur. Dans la version 7.0 et les versions ultérieures, vous pouvez configurer une ou plusieurs liaisons générales de fournisseur de services et une ou plusieurs liaisons générales de client de services. Après avoir configuré des liaisons générales, vous pouvez choisir la liaison par défaut parmi celles-ci. Vous pouvez éventuellement spécifier des liaisons générales utilisées par défaut pour un serveur d'applications ou un domaine de sécurité. trns

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

Configurez la règle WSReliableMessaging en définissant les propriétés suivantes à l'aide de la commande setPolicyType :
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]]"]')
L'exemple suivant utilise la commande setPolicyType pour définir une valeur pour chaque propriété de règle :
AdminTask.setPolicyType('[-policySet "CustomWSReliableMessaging"  -policyType 
 WSReliableMessaging -attributes "[[specLevel 1.1][inOrderDelivery true][qualityOfService 
 unmanagedNonPersistent]]"]')

Attributs de configuration de liaison WSReliableMessaging

Si vous paramétrez la propriété de règle qualityOfService sur managedNonPersistent ou managedPersistent, configurez la liaison WSReliableMessaging en indiquant des valeurs pour les propriétés suivantes, à l'aide de la commande setBinding :
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]]"]')
L'exemple de code suivant explique comment utiliser la commande setBinding pour définir des valeurs de chaque attribut de liaison :
AdminTask.setBinding('[-bindingLocation "" -bindingName cellWideBinding2 -policyType 
 WSReliableMessaging -attributes "[[busName myBus][messageEngineName messageEngine001]]"]')

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=rxml_wsfpreliablemessaging
Nom du fichier : rxml_wsfpreliablemessaging.html