Une spécification d'activation JMS est associée à un ou plusieurs beans gérés par message et offre la configuration permettant de recevoir des messages.
Vous devez créer une spécification d'activation JMS si vous souhaitez utiliser un bean géré par message pour communiquer avec le fournisseur de messagerie par défaut via JCA (Java EE Connector Architecture) 1.5. JCA offre une connectivité Java entre les serveurs d'applications (WebSphere Application Server, par exemple) et les systèmes d'information d'entreprise. Cela permet de standardiser les fournisseurs JMS d'intégration aux serveurs d'applications Java et de fournir une infrastructure d'échange de données avec les systèmes d'entreprise, où les données sont transférées sous forme de messages.
Toutes les propriétés de configuration des spécifications d'activation, exceptées les propriétés Nom, Nom JNDI, Nom JNDI de destination et Alias d'authentification sont remplacées par des propriétés de configuration d'activation nommées de manière appropriée dans le descripteur de déploiement d'un bean EJB 2.1, ou ultérieur, géré par message. Pour un bean géré par message EJB 2.0, les propriétés Type de destination, Durabilité de l'abonnement, Mode d'identification et Sélecteur de message sont remplacées par les éléments correspondants dans le descripteur de déploiement. Pour ces deux types de bean, la propriété Nom JNDI de destination peut être remplacée par une valeur spécifiée dans les liaisons du bean géré par message.
Les propriétés de la spécification d'activation influencent la manière dont le fournisseur de messagerie par défaut choisit le moteur de messagerie auquel l'application de bean géré par message se connecte. Par défaut, l'environnement connecte automatiquement les applications à un moteur de messagerie disponible sur le bus. Toutefois, vous pouvez indiquer des informations de configuration supplémentaires pour contrôler le processus de connexion ; par exemple, pour identifier des serveurs d'amorçage spéciaux ou pour limiter la connexion à un sous-groupe de moteurs de messagerie disponibles, ou pour améliorer la disponibilité ou les performances ou assurer le traitement séquentiel des messages reçus. Pour plus d'informations sur les raisons justifiant cette action et la manière de procéder, voir la rubrique Connexion des applications JMS à un moteur de messagerie d'un bus.
L'onglet Configuration contient les propriétés de configuration de cet objet. Ces valeurs de propriétés sont préservées même si l'environnement d'exécution est arrêté puis redémarré. Consultez les descriptions de tâches dans le centre de documentation pour savoir comment appliquer des modifications de configuration à l'environnement d'exécution.
Indique le niveau topologique le plus élevé auquel les serveurs d'applications peuvent utiliser cet objet de ressource.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Indique un fournisseur JMS qui active la messagerie asynchrone en fonction du service JMS (Java Message Service). Il fournit des fabriques de connexion J2EE afin de créer des connexions pour une file d'attente JMS ou des destinations de sujets spécifiques. Les objets d'administration du fournisseur JMS permettent de gérer les ressources JMS du fournisseur JMS associé.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Nom affiché obligatoire de la ressource.
| Informations | Valeur |
|---|---|
| Requis | Oui |
| Type de données | Chaîne |
Nom JNDI de la ressource.
| Informations | Valeur |
|---|---|
| Requis | Oui |
| Type de données | Chaîne |
Description facultative de la ressource.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Zone de texte |
La destination du bean géré par message est soit une file d'attente soit une rubrique.
| Informations | Valeur |
|---|---|
| Requis | Oui |
| Type de données | liste déroulante |
| Plage de valeurs |
|
Nom JNDI de destination
Sélectionnez le type de destination dans la propriété Type de destination.
Pour les adaptateurs de ressources acceptant JMS, vous devez associer javax.jms.Destinations à une spécification d'activation afin de permettre à l'adaptateur de prendre en charge des messages provenant de la destination JMS. Dans ce cas, l'administrateur configure un objet administré J2C qui implémente l'interface javax.jms.Destination et l'associe à JNDI.
Vous pouvez configurer un objet administré J2C afin qu'il utilise une classe ActivationSpec qui implémente une méthode setDestination(javax.jms.Destination). Dans ce cas, vous pouvez indiquer un nom JNDI de destination (autrement dit, le nom JNDI de l'objet administré J2C qui implémente la méthode javax.jms.Destination).
Lors du démarrage de l'application, pendant l'initialisation de la spécification d'activation au cours du processus d'activation de noeud final, le serveur utilise le nom JNDI cible pour rechercher l'objet administré cible puis le définit sur l'instance de spécification d'activation.
| Informations | Valeur |
|---|---|
| Requis | Oui |
| Type de données | Chaîne |
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. Reportez-vous au centre de documentation pour plus d'informations.
JMSType='car' AND color='blue' AND weight>2500
La chaîne du sélecteur peut faire référence aux zones de l'en-tête du message JMS et aux zones des propriétés du message. Les sélecteurs de messages ne peuvent pas faire référence à des valeurs liées au corps du message.
Une valeur null (chaîne vide) indique qu'il n'existe aucun sélecteur de message pour le consommateur du message.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Nom du bus auquel se connecter.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | personnalisé |
La façon dont la session accuse réception aux messages qu'elle reçoit.
L'accusé de réception est envoyé quand le message est supprimé.
Le message est supprimé au démarrage du bean si la qualité de service est définie sur Meilleur effort non persistant. Pour toutes les autres qualités de service, le message est supprimé à la fin de l'exécution du bean.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | liste déroulante |
| Plage de valeurs |
|
Nom d'une cible qui identifie un groupe de moteurs de messagerie. Spécifiez le type de cible à l'aide de la propriété de type de cible.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Type de cible nommé dans la propriété Cible.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | liste déroulante |
| Plage de valeurs |
|
Cette propriété indique l'importance du groupe cible.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | liste déroulante |
| Plage de valeurs |
|
Nom de la chaîne de transport entrante que l'application doit cibler lorsqu'elle se connecte à un moteur de messagerie dans un processus distinct de l'application. Si un moteur de messagerie d'un autre processus est sélectionné, une connexion peut être établie uniquement si le moteur de messagerie se trouve sur un serveur exécutant la chaîne de transport de communications entrantes spécifiée. Reportez-vous au centre de documentation pour plus d'informations.
Si le moteur de messagerie sélectionné se trouve sur le même serveur que l'application, une connexion directe en cours de processus est établie et cette propriété de chaîne de transport est ignorée.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Liste comportant trois noeuds finaux séparés par des virgules, avec la syntaxe Nomhôte:Numéroport:Nomchaîne, utilisée pour se connecter à un serveur d'amorçage. Par exemple Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Si le nom d'hôte n'est pas indiqué, localhost est utilisé comme valeur par défaut.
Si le numéro de port n'est pas indiqué, 7276 est utilisé comme valeur par défaut.
Si le protocole n'est pas indiqué, une chaîne prédéfinie comme BootstrapBasicMessaging est utilisée comme valeur par défaut.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Zone de texte |
Nombre maximal de messages reçus par le moteur de messagerie dans un seul lot.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Entier |
| Plage de valeurs | 1 à 2147483647 |
Nombre maximal de noeuds finaux auxquels les messages sont distribués simultanément.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Entier |
| Plage de valeurs | 1 à 2147483647 |
Ces paramètres permettent à un noeud final de s'arrêter automatiquement lorsque le nombre de messages en situation d'échec du point de vue séquentiel atteint une limite spécifiée. Cela permet de faire la distinction entre un ou deux messages qui échouent en raison d'incidents avec les messages eux-mêmes, et un incident de ressource système donnant lieu à des messages en situation d'échec du point de vue séquentiel.
Lorsqu'un noeud final est arrêté automatiquement, son état sur le panneau de la console d'administration est rouge. Il doit être redémarré manuellement en cliquant sur Reprendre.
Une fois le noeud final redémarré, les messages qui échouent provoquant l'arrêt du noeud final sont de nouveau envoyés. S'ils continuent d'échouer, ils sont déplacés vers une destination d'exception, si celle-ci a été configurée.
Activation de l'arrêt automatique d'un noeud final en fonction des paramètres ci-dessous.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Booléen |
Le noeud final sera arrêté lorsque le nombre de messages qui ont échoué de façon séquentielle aura atteint la limite configurée. En raison du traitement des dépendances dans le bean géré par message, le nombre réel de messages traités peut dépasser cette valeur.
Cette propriété n'est pas activée à moins que la propriété Arrêter automatiquement les noeuds finaux lors d'échecs répétés des messages soit activée.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Entier |
La transmission de tous les messages dont le traitement par le bean géré par message échoue mais qui n'ont pas atteint le nombre maximal d'échecs de transmission n'est retentée qu'une fois que ce délai (exprimé en millisecondes) est écoulé. La transmission d'autres messages peut être tentée pendant ce délai sauf si le seuil d'échecs séquentiels et l'accès concurrent maximum sont définis sur 1.
Définir un délai entre chaque envoi de message défaillant réduit le nombre des messages déplacés inutilement vers une destination d'exception avant l'arrêt du MDB. Pour minimiser le nombre de messages déplacés, entrez un délai supérieur à l'intervalle attendu entre chaque arrivée de message à la destination.
Cette propriété n'est pas activée à moins que la propriété Arrêter automatiquement les noeuds finaux lors d'échecs répétés des messages soit activée.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Entier |
| Plage de valeurs | La durée est en millisecondes. La valeur 0 indique qu'il n'y a pas de délai entre les tentatives. |
Indique si un abonnement de sujet JMS est durable ou non durable
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | liste déroulante |
| Plage de valeurs |
|
Nom de l'abonnement requis pour les abonnement de sujet durables. Zone requise lors de l'utilisation d'un abonnement de sujet durable.
Le nom de cet abonnement doit être unique dans un identificateur de client donné.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Identificateur client JMS requis pour les abonnements durables à un sujet sur toutes les connexions créées en utilisant la spécification d'activation.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Nom du moteur de messagerie utilisé pour stocker les messages livrés à des abonnements durables pour des objets créés à partir de la spécification d'activation JMS. Zone requise lors de l'utilisation d'un abonnement de sujet durable.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Chaîne |
Lorsqu'ils sont activés, les messages Objet reçus par cette spécification d'activation verront leurs données de message sérialisées par le système lorsque cela sera absolument nécessaire. Les données obtenues à partir de ces messages doivent être traitées en tant que readOnly par les applications.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Booléen |
Lorsqu'ils sont activés, les messages Objet/Octets transmis par cette spécification d'activation, dont la charge est modifiée, ne verront pas leurs données copiées lorsque définies dans le message et le système sérialisera uniquement les données de message lorsque cela sera absolument nécessaire. Les applications qui envoient ces messages ne doivent pas modifier les données une fois que celles-ci sont définies dans le message.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Booléen |
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.
Les messages affectés à un destinataire sont verrouillés sur le serveur et ne peuvent pas être consommés par d'autres destinataires de cette destination. Les messages affectés à un destinataire, mais qui ne sont pas consommés avant la fermeture du client, sont ensuite déverrouillés sur le serveur, puis prêts à être reçus par d'autres destinataires.
Vous pouvez redéfinir cette propriété pour des destinations JMS en définissant la propriété Lecture anticipée sur la destination JMS.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | liste déroulante |
| Plage de valeurs |
|
Cette propriété est utilisée uniquement lorsque l'application à bean géré par message s'exécute sur un serveur membre du bus que l'application cible. Elle n'a pas d'effet lorsque le bean géré par message s'exécute sur un serveur membre du bus cible.
Si l'application de bean géré par message (MDB) s'exécute sur un serveur membre du bus cible, l'activation de cette option permet à l'application de traiter les messages, que le serveur héberge ou non également un moteur de messagerie actif. Si cette option n'est pas activée, les applications à bean géré par messages des serveurs qui ne disposent pas de moteur de messagerie local ne traitent pas les messages.
Pour plus d'informations, voir la rubrique Connexion d'un bean géré par message dans un cluster.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Booléen |
Le délai (en secondes) entre deux tentatives de connexion à un moteur de messagerie, pour la connexion initiale et pour toute les tentatives ultérieures d'établir une meilleure connexion.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | Entier |
| Plage de valeurs | 1 à 2147483647 |
Nom d'un alias d'authentification utilisé pour l'authentification gérée par composant des connexions au bus d'intégration des services.
Un alias d'authentification Java Platform, Enterprise Edition (Java EE) JCA (Connector Architecture) spécifie l'ID utilisateur et le mot de passe qui permettent d'authentifier la création d'une connexion au fournisseur JMS.
Lorsque la zone d'alias d'authentification est utilisée, les zones correspondant aux propriétés personnalisées de nom d'utilisateur et de mot de passe doivent être laissées vides. Les propriétés d'alias d'authentification définies dans le déploiement de l'application sont prioritaires sur celles définies pour un objet d'administration de la spécification d'activation.
Seul l'alias d'authentification est enregistré dans un fichier sans être chiffré même pour la journalisation de reprise du service de transaction. Le service de sécurité permet de protéger le nom d'utilisateur et le mot de passe réels.
Lors du démarrage de l'application, pendant l'initialisation de la spécification d'activation au cours du processus d'activation de noeud final, le serveur utilise l'alias d'authentification pour extraire le nom d'utilisateur et le mot de passe réels de la sécurité puis définit ces derniers sur l'instance de spécification d'activation.
| Informations | Valeur |
|---|---|
| Requis | Non |
| Type de données | liste déroulante |