Propriétés de configuration de Resource Adapter for JMS avec WebSphere Application Server
Lors du déploiement de l'Resource Adapter for JMS avec WebSphere Application Server, vous devez configurer un ensemble de ressources JMS que l'instance d'adaptateur de ressources déployée prend en charge.
Les tables ci-après répertorient les propriétés JMS et leurs valeurs.
Remarque : Les propriétés disponibles aux applications
exécutées dans l'environnement WebSphere
Application Server
ne sont pas toutes disponibles dans les environnements tiers. Certains
propriétés n'ont pas de signification en dehors de l'environnement WebSphere
Application Server, tandis que d'autres n'ont
pas de signification pour les clients à distance.
Nom de la propriété | Description | Valeurs admises | Valeut par défaut |
---|---|---|---|
BusName | Nom du bus d'intégration des services auquel se connecter. | ||
ClientID | Identificateur client JMS requis pour les abonnements durables à un sujet sur toutes les connexions créées à l'aide de cette fabrique de connexions. | ||
UserName | |||
Mot de passe | |||
NonPersistentMapping | Fiabilité appliquée aux messages JMS non persistants envoyés à l'aide de cette fabrique de connexions. | BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent | ExpressNonPersistent |
PersistentMapping | Fiabilité appliquée aux messages JMS persistants envoyés à l'aide de cette fabrique de connexions. | ReliablePersistent, AssuredPersistent | ReliablePersistent |
DurableSubscriptionHome | Nom du moteur de messagerie utilisé pour stocker les messages livrés à des abonnements durables pour des objets créés à partir de cette fabrique de connexions JMS. | ||
ReadAhead | La lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Ainsi le temps nécessaire à la satisfaction des demandes des destinataires est réduit. | AlwaysOn, AlwaysOff, Default | Valeut par défaut |
Cible | Nom d'une cible qui identifie un groupe de moteurs de messagerie. Définissez le type de cible en utilisant la propriété Type de cible. | ||
TargetType | Type de cible nommé dans la propriété Cible. | BusMember, Custom, ME | BusMember |
TargetSignificance | Signification du groupe cible. | Required, Preferred | Obligatoire |
TargetTransportChain | Nom du protocole qui se résout en groupe de moteurs de messagerie. | ||
ProviderEndpoints | Liste des noeuds finaux séparés par des virgules, utilisés pour établir une connexion avec un serveur d'amorçage. | ||
ConnectionProximity | Proximité des moteurs de messagerie pouvant accepter des demandes de connexion, en relation avec le moteur de messagerie d'amorçage. | Serveur, Cluster, Hôte, Bus | Bus |
TemporaryQueueNamePrefix | Préfixe, composé au maximum de douze caractères, utilisé dans les noms de files d'attente temporaires créées par les applications utilisant cette fabrique de connexions. | ||
TemporaryTopicNamePrefix | Préfixe utilisé au début des sujets temporaires créés par les applications utilisant cette fabrique de connexions. | ||
ShareDurableSubscriptions | Contrôle si les abonnements durables sont partagés par des connexions comportant des membres d'un cluster de serveurs. | InCluster, AlwaysShared, NeverShared | InCluster (Correspond toujours à AlwaysOff car le client se trouve toujours en dehors d'un serveur en cluster WebSphere Application Server) |
ProducerDoesNotModify |
Lorsque la propriété est activée, les données des messages de type objet ou octet envoyés par une application émettrice de messages et connectée au bus à l'aide de cette fabrique de connexions ne sont pas copiées lors de leur définition et le système sérialise les données des messages qu'en cas de nécessité. Les applications qui envoient ces messages ne doivent pas modifier les données une fois que celles-ci sont définies dans le message. | true, false | false |
Nom de la propriété | Description | Valeurs admises | Valeut par défaut |
---|---|---|---|
BusName | Nom du bus d'intégration des services auquel se connecter. | ||
UserName | |||
Mot de passe | |||
NonPersistentMapping | Fiabilité appliquée aux messages JMS non persistants envoyés à l'aide de cette fabrique de connexions. | BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent | ExpressNonPersistent |
PersistentMapping | Fiabilité appliquée aux messages JMS persistants envoyés à l'aide de cette fabrique de connexions. | ReliablePersistent, AssuredPersistent | ReliablePersistent |
ReadAhead | La lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Ainsi le temps nécessaire à la satisfaction des demandes des destinataires est réduit. | AlwaysOn, AlwaysOff, Default | Valeut par défaut |
Target | Nom d'une cible qui identifie un groupe de moteurs de messagerie. Définissez le type de cible en utilisant la propriété Type de cible. | ||
TargetType | Type de cible nommé dans la propriété Cible. | BusMember, Custom, ME | BusMember |
TargetSignificance | Signification du groupe cible. | Required, Preferred | Obligatoire |
TargetTransportChain | Nom du protocole qui se résout en groupe de moteurs de messagerie. | ||
ProviderEndpoints | Liste des noeuds finaux séparés par des virgules, utilisés pour établir une connexion avec un serveur d'amorçage. | ||
ConnectionProximity | Proximité des moteurs de messagerie pouvant accepter des demandes de connexion, en relation avec le moteur de messagerie d'amorçage. | Serveur, Cluster, Hôte, Bus | Bus |
TemporaryQueueNamePrefix | Préfixe, composé au maximum de douze caractères, utilisé dans les noms de files d'attente temporaires créées par les applications utilisant cette fabrique de connexions. | ||
ProducerDoesNotModify |
Lorsque la propriété est activée, les données des messages de type objet ou octet envoyés par une application émettrice de messages et connectée au bus à l'aide de cette fabrique de connexions ne sont pas copiées lors de leur définition et le système sérialise les données des messages qu'en cas de nécessité. Les applications qui envoient ces messages ne doivent pas modifier les données une fois que celles-ci sont définies dans le message. | true, false | false |
Nom de la propriété | Description | Valeurs admises | Valeut par défaut |
---|---|---|---|
BusName | Nom du bus d'intégration des services auquel se connecter. | ||
ClientID | Identificateur de client JMS requis pour les abonnements durables à un sujet sur toutes les connexions créées à l'aide de cette fabrique de connexions. | ||
UserName | |||
Mot de passe | |||
NonPersistentMapping | Fiabilité appliquée aux messages JMS non persistants envoyés à l'aide de cette fabrique de connexions. | BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent | ExpressNonPersistent |
PersistentMapping | Fiabilité appliquée aux messages JMS persistants envoyés à l'aide de cette fabrique de connexions. | ReliablePersistent, AssuredPersistent | ReliablePersistent |
DurableSubscriptionHome | Nom du moteur de messagerie utilisé pour stocker les messages livrés à des abonnements durables pour des objets créés à partir de cette fabrique de connexions JMS. | ||
ReadAhead | La lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Elle permet de réduire le temps nécessaire pour traiter les demandes des destinataires. | AlwaysOn, AlwaysOff, Default | Valeut par défaut |
Target | Nom d'une cible qui identifie un groupe de moteurs de messagerie. Définissez le type de cible en utilisant la propriété Type de cible. | ||
TargetType | Type de cible nommé dans la propriété Cible. | BusMember, Custom, ME | BusMember |
TargetSignificance | Signification du groupe cible. | Required, Preferred | Obligatoire |
TargetTransportChain | Nom du protocole qui se résout en groupe de moteurs de messagerie. | ||
ProviderEndpoints | Liste des noeuds finaux séparés par des virgules, utilisés pour établir une connexion avec un serveur d'amorçage. | ||
ConnectionProximity | Proximité des moteurs de messagerie pouvant accepter des demandes de connexion, en relation avec le moteur de messagerie d'amorçage. | Server, Cluster, Host, Bus | Bus |
TemporaryTopicNamePrefix | Préfixe utilisé au début des sujets temporaires créés par les applications utilisant cette fabrique de connexions. | ||
ShareDurableSubscriptions | Contrôle si les abonnements durables sont partagés par des connexions comportant des membres d'un cluster de serveurs. | InCluster, AlwaysShared, NeverShared | InCluster (Correspond toujours à AlwaysOff car le client se trouve toujours en dehors d'un serveur en cluster WebSphere Application Server) |
ProducerDoesNotModify |
Lorsque la propriété est activée, les données des messages de type objet ou octet envoyés par une application émettrice de messages et connectée au bus à l'aide de cette fabrique de connexions ne sont pas copiées lors de leur définition et le système sérialise les données des messages qu'en cas de nécessité. Les applications qui envoient ces messages ne doivent pas modifier les données une fois que celles-ci sont définies dans le message. | true, false | false |
Nom de la propriété | Description | Valeurs admises | Valeut par défaut |
---|---|---|---|
QueueName | Nom de la file d'attente associée sur le bus d'intégration de services. | ||
DeliveryMode | Mode de livraison des messages envoyés à cette destination. Permet de contrôler la persistance des messages sur cette destination. | Application, Persistent, NonPersistent | |
TimeToLive | Durée par défaut, en millisecondes, à partir du moment de la distribution d'un message envoyé à cette destination pendant laquelle il doit être conservé par le système. | ||
Priority | Priorité relative des messages envoyés à cette destination. Cette priorité est comprise dans une plage de 0 à 9, 0 étant la priorité la plus faible et 9 la priorité la plus élevée. | ||
ReadAhead | La lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Ainsi le temps nécessaire à la satisfaction des demandes des destinataires est réduit. | AlwaysOn, AlwaysOff, AsConnection, Default | AsConnection |
BusName | Nom du bus d'intégration des services auquel se connecter. | ||
ScopeToLocalQP | Indique si la destination de file d'attente du bus d'intégration de services identifiée par cette file d'attente a comme portée dynamique un unique point de file d'attente s'il en existe un sur le moteur de messagerie auquel l'application est connectée. | On, Off | Off |
ProducerPreferLocal | Indique si un producteur de messages de cette file d'attente doit préférer un point de file d'attente connecté en local de la destination de file d'attente du bus d'intégration de services à tout autre point de file d'attente. | On, Off | On |
ProducerBind | Indique si les messages envoyés par un producteur de messages à cette file d'attente parviendront au même point de file d'attente du bus d'intégration de services ou si aucune restriction de cette sorte ne sera appliquée et les divers messages seront envoyés à des points de file d'attente différents. | On, Off | Off |
GatherMessages | Indique si les messages de tous les points de file d'attente du bus d'intégration de services ou d'un seul point de file d'attente sont visibles par les consommateurs de messages et les navigateurs de files d'attente qui utilisent cette file d'attente. | On, Off | Off |
Nom de la propriété | Description | Valeurs admises | Valeut par défaut |
---|---|---|---|
TopicSpace | Nom de l'espace de sujet qui contient le sujet sur le bus d'intégration de services défini par la propriété BusName. | Default.Topic.Space | |
TopicName | Nom affecté à ce sujet JMS, dans l'espace des sujet défini par la propriété TopicSpace. | ||
DeliveryMode | Mode de livraison des messages envoyés à cette destination. Permet de contrôler la persistance des messages sur cette destination. | Application, Persistent, NonPersistent | |
TimeToLive | Durée par défaut, en millisecondes, à partir du moment de la distribution d'un message envoyé à cette destination pendant laquelle il doit être conservé par le système. | ||
Priority | Priorité relative des messages envoyés à cette destination. Cette priorité est comprise dans une plage de 0 à 9, 0 étant la priorité la plus faible et 9 la priorité la plus élevée. | ||
ReadAhead | La lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Ainsi le temps nécessaire à la satisfaction des demandes des destinataires est réduit. | AlwaysOn, AlwaysOff, AsConnection, Default | AsConnection |
BusName | Nom du bus d'intégration des services auquel se connecter. |
Nom de la propriété | Description | Valeurs admises | Valeut par défaut | Obligatoire/Facultatif |
---|---|---|---|---|
Destination | Nom de la destination sur le bus d'intégration de services. | Obligatoire | ||
ProviderEndpoints | Liste des noeuds finaux séparés par des virgules, utilisés pour établir une connexion avec un serveur d'amorçage. | Obligatoire | ||
DestinationType | Indique si le bean géré par message utilise une destination de sujet ou de file d'attente. | javax.jms.Queue, javax.jms.Topic | Obligatoire | |
BusName | Nom du bus d'intégration des services auquel se connecter. | Obligatoire | ||
MessageSelector | Sélecteur de message JMS permettant de déterminer quels sont les messages reçus par le bean géré par message. La valeur correspond à une chaîne permettant de sélectionner un sous-ensemble de messages disponibles. La syntaxe de cette chaîne est basée sur un sous-ensemble de la syntaxe d'expression conditionnelle SQL 92, comme décrit dans la spécification JMS. | Facultatif | ||
AcknowledgeMode | Mode de réception des messages par la session. | Auto-acknowledge, Dups-ok-acknowledge | Accusé de réception automatique | Facultatif |
SubscriptionDurability | Indique si un abonnement à des sujets JMS est durable ou non. | Durable, Nondurable | Non durable | Facultatif |
SubscriptionName | Nom de l'abonnement requis pour les abonnement de sujet durables. Zone requise lors de l'utilisation d'un abonnement de sujet durable. | Facultatif | ||
MaxBatchSize | Nombre maximal de messages reçus par le moteur de messagerie dans un seul lot. | 1 à 2147483647 | 1 | Facultatif |
MaxConcurrency | Nombre maximal de noeuds finaux auxquels les messages sont simultanément délivrés. | 1 à 2147483647 | 10 | Facultatif |
RetryInterval | Délai (en secondes) entre les tentatives de connexion à un moteur de messagerie. | 1 à 2147483647 | 30 | Facultatif |
UserName | Facultatif | |||
Mot de passe | Facultatif | |||
DurableSubscriptionHome | Nom du moteur de messagerie utilisé pour stocker les messages livrés à des abonnements durables pour des objets créés à partir de cette fabrique de connexions JMS. | Facultatif | ||
ShareDurableSubscriptions | Contrôle si les abonnements durables sont partagés par des connexions comportant des membres d'un cluster de serveurs. | InCluster, AlwaysShared, NeverShared | InCluster (Correspond toujours à AlwaysOff car le client se trouve toujours en dehors d'un serveur en cluster WebSphere Application Server) | Facultatif |
ClientID | Identificateur de client JMS requis pour les abonnements durables à un sujet sur toutes les connexions créées à l'aide de cette fabrique de connexions. | Facultatif | ||
TargetTransportChain | Nom du protocole qui se résout en groupe de moteurs de messagerie. | Facultatif | ||
ReadAhead | La lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Ainsi le temps nécessaire à la satisfaction des demandes des destinataires est réduit. | AlwaysOn, AlwaysOff, Default | Valeur par défaut | Facultatif |
Cible | Nom d'une cible qui identifie un groupe de moteurs de messagerie. Définissez le type de cible en utilisant la propriété Type de cible. | Facultatif | ||
TargetType | Type de cible nommé dans la propriété Cible. | BusMember, Custom, ME | BusMember | Facultatif |
TargetSignificance | Cette propriété indique l'importance du groupe cible. | Required, Preferred | Obligatoire | Facultatif |
TopicSpace | Nom de l'espace de sujet qui contient le sujet sur le bus d'intégration de services défini par la propriété BusName. | Default.Topic.Space | Facultatif | |
ForwarderDoesNotModify |
Lorsque cette propriété est activée, les données des messages de type objet/octet acheminés via cette spécification d'activation et dont la charge est modifiée ne sont pas copiées lors de leur définition dans le message et le système ne sérialise les données du message qu'en cas de nécessité. Les applications qui envoient ces messages ne doivent pas modifier les données une fois que celles-ci sont définies dans le message. | true, false | false | Facultatif |