Fabrique de connexions de la file d'attente du fournisseur de messagerie par défaut [Paramètres]
Pour afficher cette page dans la console, cliquez sur l'un des chemins suivants :
Par défaut, les connexions créées en utilisant cette fabrique de connexions JMS dans les conteneurs de serveur (par exemple, d'un bean enterprise) sont regroupés en utilisant le regroupement de connexions Java™ Platform, Enterprise Edition (Java EE) Connector Architecture (JCA). Vous pouvez modifier les paramètres de pool de connexions de cette fabrique de connexions en sélectionnant le lien Propriétés du pool de connexions dans la section des propriétés supplémentaires du panneau de la console d'administration.
Onglet Configuration
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.
Propriétés générales
Portée
Indique le niveau topologique le plus élevé auquel les serveurs d'applications peuvent utiliser cet objet de ressource.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Fournisseur
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é.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Chaîne
Nom affiché obligatoire de la ressource.
Information | Valeur |
---|---|
Obligatoire | Yes |
Type de données | String (chaîne) |
Nom JNDI
Nom JNDI de la ressource.
Par convention, utilisez un nom JNDI de la forme jms/Nom, Nom correspondant au nom logique de la ressource). Pour plus d'informations sur l'utilisation de JNDI et sa syntaxe, voir la rubrique sur la prise en charge JNDI dans WebSphere Application Server.
Information | Valeur |
---|---|
Obligatoire | Yes |
Type de données | String (chaîne) |
Description
Description facultative de la ressource.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | Zone de texte |
Catégorie
Chaîne de catégories facultative à utiliser lors de la classification ou du regroupement de la ressource.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Nom du bus
Information | Valeur |
---|---|
Obligatoire | Yes |
Type de données | Personnalisé |
Cible
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Type de cible
Ceci désigne le nom d'une cible devant servir à déterminer un ou plusieurs moteurs de messagerie pour gérer le travail. Le type de cible est signalé par la propriété Type de cible.
L'équilibrage de charge des connexions est effectué entre les moteurs de messagerie disponibles qui satisfont les critères de sélection.
Si vous voulez que les applications puissent se connecter à tout moteur de messagerie du bus, ne définissez pas cette propriété.
Pour plus d'informations sur l'utilisation de cette propriété avec d'autres propriétés de fabrique de connexions pour la gestion de la charge de travail des connexions, voir la rubrique Propriétés d'administration des connexions JMS à un bus.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Importance de la cible
Pour plus d'informations sur l'utilisation de cette propriété avec d'autres propriétés de fabrique de connexions pour la gestion de la charge de travail des connexions, voir la rubrique concernant les propriétés d'administration pour les connexions JMS vers un bus.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Chaîne de transport entrant cible
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.
- InboundBasicMessaging
- Il s'agit d'un protocole orienté connexion qui utilise une connexion standard TCP/IP (JFAP-TCP/IP). Il prend en charge deux flux transactionnels biphasé (XA distant). Un émetteur ou un destinataire de messages qui fonctionne sur un système client ou serveur peut participer à une transaction globale gérée sur ce système client ou serveur. Les flux XA permettent à une application exécutée sur un serveur d'accéder à un moteur de messagerie sur un deuxième serveur dans la mesure où le premier serveur n'héberge pas de moteur le messagerie approprié. Si les flux XA distants sont utilisés, l'application doit pouvoir accéder à un coordinateur de transactions en local.
- InboundSecureMessaging
- Il s'agit du protocole InboundBasicMessaging encapsulé dans SSL.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Noeuds finaux du fournisseur
Il vous faut uniquement modifier cette propriété si des applications client s'exécutant en dehors d'un serveur d'applications ou si des applications s'exécutant sur un serveur dans une autre cellule visent à employer cette fabrique de connexions pour cibler le bus d'intégration de services indiqué dans cette dernière.
Pour utiliser des destinations JMS du fournisseur de messagerie par défaut, une application se connecte au moteur de messagerie du bus d'intégration de services cible auquel les destinations sont affectées. Par exemple, une file d'attente JMS est affectée à une destination de file d'attente sur un bus d'intégration de services.
Les applications client s'exécutant en dehors d'un serveur d'applications (par exemple, dans un conteneur client ou hors de l'environnement de WebSphere Application Server) ne peuvent pas localiser directement un moteur de messagerie approprié auquel se connecter dans le bus cible. De la même façon, une application exécutée sur un serveur, dans une cellule, qui se connecte à un bus cible d'une autre cellule ne peut pas localiser directement, dans ce bus cible, un moteur de messagerie approprié auquel se connecter.
Dans ces cas de figure, les clients (ou serveurs dans un autre bus) doivent mener à bien un processus d'amorçage via un serveur d'amorçage membre du bus cible. Un serveur d'amorçage est un serveur d'applications qui exécute le service SIB, mais qui n'a pas besoin d'exécuter de moteur de messagerie. Il sélectionne un moteur de messagerie s'exécutant dans un serveur d'applications qui prend en charge la chaîne de transport cible requise. Pour que le processus d'amorçage aboutisse, vous devez configurer un ou plusieurs noeuds finaux de fournisseur dans la fabrique de connexions utilisée par le client.
Un serveur d'amorçage utilise un port et une chaîne de transport d'amorçage spécifiques. Le port est la valeur SIB_ENDPOINT_ADDRESS (ou SIB_ENDPOINT_SECURE_ADDRESS si la sécurité est activée) du moteur de messagerie qui héberge l'extrémité distante du lien. Avec le nom d'hôte, l'ensemble forme l'adresse du noeud final du serveur d'amorçage.
- Si aucun justificatif de sécurité n'est fourni, valeur par défaut.
- localhost est utilisé, si host n'est pas spécifié.
- le port 7276 est utilisé, si port n'est pas spécifié.
- La chaîne de transport d'amorçage appelée BootstrapBasicMessaging est utilisée, si la chaîne de canaux d'amorçage n'est pas spécifiée.
- Si des justificatifs de sécurité sont fournis, valeur par défaut.
- localhost est utilisé, si host n'est pas spécifié.
- le port 7286 est utilisé, si port n'est pas spécifié.
- La chaîne de transport d'amorçage appelée BootstrapSecureMessaging est utilisée, si la chaîne de canaux d'amorçage n'est pas spécifiée et que le numéro de port est supérieur ou égal à 7286.
- La chaîne de transport d'amorçage appelée BootstrapBasicMessaging est utilisée, si la chaîne de canaux d'amorçage n'est pas spécifiée et que le numéro de port est compris entre 7276 et 7285.
![[IBM i]](../images/iseries.gif)
Pour qu'une application utilise un serveur d'amorçage avec une autre adresse de noeud final, vous devez indiquer cette adresse dans la propriété Noeuds finaux de fournisseur des fabriques de connexions JMS que l'application client emploie. Vous pouvez indiquer une ou plusieurs adresses de noeud final de serveurs d'amorçage.
Les adresses de noeud final pour les serveurs d'amorçage doivent être indiquées dans chaque fabrique de connexions JMS utilisée par des applications en dehors d'un serveur d'applications. Pour ne pas avoir à indiquer une longue liste de serveurs d'amorçage, vous pouvez préciser quelques serveurs à haute disponibilité comme serveurs d'amorçage dédiés. Il suffit ensuite d'entrer une courte liste de serveurs d'amorçage dans chaque fabrique de connexions.
boothost1:7278:BootstrapBasicMessaging
or
boothost1:7278
et pour le port sécurisé 7289 de serveur sur un hôte boothost2 qui utilise la chaîne de transport prédéfinie BootstrapTunneledSecureMessaging :boothost2:7289:BootstrapTunneledSecureMessaging
[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]
où :- nom_hôte
- est le nom de l'hôte sur lequel le serveur s'exécute. Il peut s'agir d'une adresse IP. Pour une adresse IPv6, placez le nom d'hôte entre crochets ([]), comme indiqué dans l'exemple ci-dessous :
. Si aucune valeur n'est précisée, la valeur par défaut est localhost.[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Remarque : Pour la plateforme IBM i, vous devez (au moins) changer le nom d'hôte par défaut et remplacer localhost par nomvotreserveur.
- numéro_port
- Si vous définissez ce paramètre, il correspond à l'une des adresses suivantes du moteur de messagerie qui héberge l'extrémité distante du lien.
- SIB_ENDPOINT_ADDRESS si la sécurité n'est pas activée,
- Pour les connexions sécurisées, SIB_ENDPOINT_SECURE_ADDRESS si la sécurité est activée.
Si vous n'entrez pas numéro_port, la valeur par défaut est 7276.
Pour rechercher l'une de ces valeurs à l'aide de la console d'administration, cliquez sur .
- nom_chaîne
- est le nom de la chaîne de transport d'amorçage prédéfinie et
servant à se connecter au serveur d'amorçage. S'il n'est pas spécifié, la valeur par défaut est
BootstrapBasicMessaging.
Les chaînes de transport d'amorçage prédéfinies qui suivent sont fournies :
- BootstrapBasicMessaging
- Correspond à la chaîne de transport InboundBasicMessaging du serveur (JFAP-TCP/IP)
- BootstrapSecureMessaging
- Correspond à la chaîne de transport InboundSecureMessaging du serveur (JFAP-SSL-TCP/IP)
- BootstrapTunneledMessaging
- Avant d'utiliser cette chaîne de transport d'amorçage, vous devez définir une chaîne de transport serveur correspondante sur le serveur d'amorçage. (Voir .) Cette chaîne de transport tunnelise JFAP et utilise des encapsuleurs HTTP.
- BootstrapTunneledSecureMessaging
- Avant d'utiliser cette chaîne de transport d'amorçage, vous devez définir une chaîne de transport serveur correspondante sur le serveur d'amorçage. (Voir .) Cette chaîne de transport tunnelise JFAP et utilise des encapsuleurs HTTP.
Le fait d'entrer nom_hôte : nom_chaîne au lieu de nom_hôte : : nom_chaîne (avec deux signes deux-points) est incorrect. Vous pouvez ne rien entrer ou indiquer l'une des formules suivantes : "a", "a:", ":7276", "::chaîne", etc. La valeur par défaut s'applique si vous n'indiquez aucune autre valeur, mais vous devez séparer les zones par des signes ":".
boothost1:7278:BootstrapBasicMessaging,
boothost2:7289:BootstrapTunneledSecureMessaging,
[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | Zone de texte |
Proximité des connexions
- Si un groupe cible est spécifié, connectez-vous au premier moteur de messagerie qui
satisfait les conditions suivantes pour le type cible :
- Serveur Recherchez un moteur de messagerie sur le même serveur.
- Cluster Recherchez un moteur de messagerie sur le même serveur, puis sur les autres serveurs du même cluster.
- Hôte Recherchez un moteur de messagerie sur le même serveur, puis sur les autres serveurs du même cluster, puis sur les autres serveurs du même hôte.
- Bus Recherchez un moteur de messagerie sur le même serveur, puis sur les autres serveurs du même cluster, puis sur les autres serveurs du même hôte et enfin tout autre moteur de messagerie du même bus.
- Si aucun groupe cible n'est spécifié ou qu'un groupe cible est spécifié mais qu'aucun
moteur de messagerie approprié n'est trouvé et que la signification cible est Préférée, connectez-vous au premier moteur
de messagerie respectant les conditions suivantes pour le type cible :
- Serveur Recherchez un moteur de messagerie sur le même serveur.
- Cluster Echec de la connexion.
- Hôte Recherchez un moteur de messagerie sur le même serveur, puis sur les autres serveurs du même hôte.
- Bus Recherchez un moteur de messagerie dans le groupe cible sur le même serveur, puis sur les autres serveurs du même hôte et enfin tout autre moteur de messagerie du même bus.
Pour plus d'informations sur l'utilisation de cette propriété avec d'autres propriétés de fabrique de connexions pour la gestion de la charge de travail des connexions, voir la rubrique Propriétés d'administration des connexions JMS à un bus.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Fiabilité des messages non persistants
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Fiabilité des messages persistants
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Lecture anticipée
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.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Préfixe de nom de file d'attente temporaire
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Transmission de la charge de messages par référence
Lorsque des messages volumineux de type objet ou octet sont envoyés, la quantité de mémoire et le traitement processeur nécessaires pour sérialiser, désérialiser et copier les messages peuvent être importants. Si vous activez les propriétés de transmission de la charge de messages par référence sur une fabrique de connexions ou une spécification d'activation, vous pouvez demander au fournisseur de messagerie par défaut d'ignorer la spécification JMS 1.1 et de limiter fortement ou d'ignorer la copie de ces données.
Les applications qui utilisent cette fabrique de connexions pour envoyer les messages doivent respecter les règles suivantes :
- L'application ne modifie pas l'objet de données stocké dans un message d'objet JMS.
- L'application remplit un message d'octets JMS en utilisant un appel à writeBytes(byte[]) et ne modifie pas le tableau d'octets une fois qu'il est défini dans le message.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Les applications qui utilisent cette fabrique de connexions pour recevoir les messages doivent respecter la règle suivante :
- L'application ne modifie pas l'objet de données obtenu à partir du message d'objet JMS. L'objet des données sont traitées en mode lecture seule.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Journaliser les contextes de transaction manquants
Sélectionnez cette propriété pour enregistrer des connexions créées sans contexte de transaction.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Gérer les descripteurs placés en cache
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Alias d'authentification de reprise XA
Cette propriété fournit la liste des alias des entrées de données d'authentification JCA définis pour WebSphere Application Server. Vous pouvez sélectionner un alias d'entrée de données à utiliser pour l'authentification lors du processus de reprise XA.
Si vous avez activé la sécurité pour le bus d'intégration de services associé, sélectionnez l'alias désignant l'ID utilisateur et le mot de passe défini pour la reprise XA, qui est valide dans le registre d'utilisateurs de WebSphere Application Server. Cette propriété doit être définie si la sécurité du bus est activée et que des transactions XA doivent être utilisées.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Alias de configuration de mappage
Définit l'alias de configuration de mappage JAAS (Java Authentication and Authorization Service) utilisé par la fabrique de connexions.
Cette zone sera utilisée uniquement en cas d'absence de configuration de connexion dans la référence de ressource du composant. La spécification d'une configuration de connexion et des propriétés associées sur la référence de ressource de composant détermine la stratégie d'authentification gérée par conteneur lorsque la valeur d'autorisation de ressource est Conteneur.Si la configuration de connexion DefaultPrincipalMapping est définie, la propriété associée est un alias d'entrée d'authentification JAAS - J2C. Voir l'entrée de données d'authentification JAAS - J2C associée pour définir le nouvel alias.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Alias d'authentification géré par conteneur
Cet alias spécifie un ID utilisateur et un mot de passe permettant d'authentifier les connexions au fournisseur JMS pour l'authentification gérée par conteneur. Cette option est utilisée uniquement lorsque la valeur res-auth est un conteneur et que l'alias d'authentification n'est pas défini lors du déploiement de l'application.
Information | Valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Propriétés supplémentaires
- Propriétés du pool de connexions
- Ensemble facultatif de paramètres de pool de connexions.