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. Elle permet d'intégrer les fournisseurs JMS à des serveurs d'applicationsJava EE selon une procédure normalisée et offre une structure d'échange avec des systèmes d'entreprise par le transfert des donné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 Connexion des applications JMS à un moteur de messagerie d'un bus (online).
Les liens marquées (online) requièrent un accès à Internet. Chaque lien permet de lancer une recherche dans la rubrique du centre de documentation en ligne. Dans les résultats de la recherche qui s'affichent, sélectionnez la rubrique qui correspond le mieux à votre configuration.
Vérifiez la présence de mises à jour dans cette rubrique (online)
L'onglet Configuration affiche les propriétés de configuration de cet objet. Les valeurs des propriétés sont conservées même si l'environnement d'exploitation est arrêté, puis redémarré. Pour plus d'informations sur l'application des modifications de configuration dans l'environnement d'exécution, voir les descriptions de tâches correspondantes dans le centre d'informations.
Indique le niveau topologique le plus élevé auquel les serveurs d'applications peuvent utiliser cet objet de ressource.
Obligatoire | Non |
Type de données | Texte |
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é.
Obligatoire | Non |
Type de données | Texte |
Nom JNDI de la ressource.
Obligatoire | Oui |
Type de données | Texte |
Indique si le bean géré par message utilise une destination de sujet ou de file d'attente.
Obligatoire | 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.
Obligatoire | Oui |
Type de données | Texte |
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.
Obligatoire | Non |
Type de données | Texte |
Nom du bus auquel se connecter.
Obligatoire | Non |
Type de données | Personnalisation |
Mode de réception des messages par la session.
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.
Obligatoire | 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.
Obligatoire | Non |
Type de données | Texte |
Type de cible nommé dans la propriété Cible.
Obligatoire | Non |
Type de données | liste déroulante |
Plage de valeurs |
|
Cette propriété indique l'importance du groupe cible.
Obligatoire | 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. Pour plus d'informations, reportez-vous au centre de documentation.
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.
Obligatoire | Non |
Type de données | Texte |
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.
Obligatoire | Non |
Type de données | Zone de texte |
Nombre maximal de messages reçus par le moteur de messagerie dans un seul lot.
Obligatoire | Non |
Type de données | Entier |
Plage de valeurs | 1 à 2147483647 |
Nombre maximal de noeuds finaux auxquels les messages sont distribués simultanément.
Obligatoire | 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.
Dès qu'un noeud final est redémarré, tous les messages défaillants ayant entraîné l'arrêt du noeud final sont retenté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.
Obligatoire | Non |
Type de données | Case à cocher |
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. De part l'accès concurrent 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êt automatique des noeuds finaux sur l'échec répété des messages soit activée.
Obligatoire | Non |
Type de données | Entier |
La transmission de tous les messages qui ne parviennent pas à être traités par le bean géré par message, mais qui n'ont pas atteint le nombre maximum d'échecs de transmission, sera uniquement retentée une fois que ce délai sera passé. 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êt automatique des noeuds finaux sur l'échec répété des messages soit activée.
Obligatoire | 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
Obligatoire | 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é.
Obligatoire | Non |
Type de données | Texte |
Identificateur client JMS requis pour les abonnements durables à un sujet sur toutes les connexions créées en utilisant la spécification d'activation.
Obligatoire | Non |
Type de données | Texte |
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.
Obligatoire | Non |
Type de données | Texte |
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.
Obligatoire | Non |
Type de données | Case à cocher |
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 envoyant ces messages ne doivent pas modifier les données une fois qu'elles ont été définies dans le message.
Obligatoire | Non |
Type de données | Case à cocher |
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 consommateur sont verrouillés sur le serveur et ne peuvent pas être consommés par d'autres consommateurs 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.
Obligatoire | 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 Connexion d'un bean géré par message dans un cluster (online).
Obligatoire | Non |
Type de données | Case à cocher |
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.
Obligatoire | 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.
Obligatoire | Non |
Type de données | liste déroulante |