Paramètres de fabrique de connexions de rubriques WebSphere

Utilisez cet écran pour afficher ou modifier les propriétés de configuration de la fabrique de connexions de rubriques sélectionnée pour une utilisation avec le fournisseur JMS WebSphere intégré. Ces propriétés de configuration contrôlent le mode de création des connexions vers la destination de rubrique JMS associée.

Une fabrique de connexions de rubriques est utilisée pour créer des connexions JMS vers des destinations de rubriques. La fabrique de connexions de rubriques est créée par le fournisseur JMS associé. Une fabrique de connexions de rubriques pour le fournisseur JMS WebSphere intégré est dotée des propriétés suivantes :

Pour afficher cette page de la console d'administration, cliquez sur Ressources-> Fournisseur WebSphere JMS-> (Dans la sous-fenêtre de contenu, sous les propriétés additionnelles) Fabriques de connexions de rubrique WebSphere-> fabrique_connexions

Nom JNDI
Nom JNDI utilisé pour lier la fabrique de connexions de rubrique à l'espace nom du serveur d'applications.

Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource.

Ce nom est utilisé pour lier les informations relatives à la liaison des plateformes. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.

Type de données Chaîne

Onglet Configuration

Portée
Indique à quel niveau cette définition de ressource est visible : cellule, noeud ou serveur.

Des ressources telles que les fournisseurs JMS, les liaisons d'espace de noms et les bibliothèques partagées peuvent être définies à plusieurs niveaux. Dans ce cas, pour une ressource donnée, la définition figurant au niveau le plus spécifique (par exemple, le serveur) l'emporte sur l'éventuelle définition homologue figurant à un niveau plus général (par exemple, la cellule).

Notez que quelle que soit la portée d'une ressource définie, les propriétés de cette ressource s'appliquent uniquement au niveau d'un serveur individuel. Par exemple, si vous définissez la portée d'une source de données au niveau cellule, tous les utilisateurs de cette cellule peuvent rechercher et utiliser cette source de données, laquelle est unique au sein de cette cellule. Cependant, les propriétés de la ressource sont locales à chaque serveur de la cellule. Par exemple, si vous attribuez la valeur 10 à la propriété Nombre maximal de connexions, chaque serveur de cette cellule pourra avoir 10 connexions.

Cellule
Niveau de portée le plus général. Les ressources définies au niveau cellule sont visibles depuis tous les noeuds et serveurs de cette cellule, sauf si elles sont redéfinies à un niveau inférieur. Pour visualiser les ressources définies au niveau cellule, ne spécifiez pas de nom de serveur ni de nom de noeud dans le formulaire de sélection de portée.
Noeud
Portée par défaut de la plupart des types de ressources. Les ressources définies au niveau noeud l'emportent sur les éventuelles définitions homologues figurant au niveau cellule et sont visibles depuis tous les serveurs du noeud considéré, sauf si elles sont redéfinies à un niveau serveur sur ce noeud. Pour visualiser les ressources définies au niveau d'un noeud, ne spécifiez pas de serveur dans le formulaire de sélection de portée ; spécifiez simplement le nom du noeud concerné.
Serveur
Niveau de portée le plus spécifique pour la définition des ressources. Les ressources définies au niveau d'un serveur l'emportent sur les éventuelles définitions homologues apparaissant au niveau de la cellule parente ou du noeud parent ; elles sont visibles uniquement depuis ce serveur. Pour visualiser les ressources définies au niveau d'un serveur, spécifiez le nom de ce serveur ainsi que celui de son noeud parent dans le formulaire de sélection de portée.

Lorsque des ressources sont créées, elles le sont toujours dans la portée en cours, c'est-à-dire celle qui est sélectionnée dans le formulaire. Pour afficher les ressources d'autres portées, spécifiez un noeud ou un serveur différent dans le formulaire de sélection de portée.

Type de données Chaîne
Nom
Nom sous lequel cette fabrique de connexions de files d'attente est connue pour l'administration d'IBM WebSphere Application Server. Ce nom doit être unique parmi les fabriques de connexions JMS du domaine administratif WebSphere.
Type de données Chaîne
Valeur par défaut Null
Description
Description de cette fabrique de connexions de rubrique dans IBM WebSphere Application Server à des fins d'administration.
Type de données Chaîne
Valeur par défaut Null
Catégorie
Catégorie utilisée pour classer ou grouper cette fabrique de connexions de rubrique dans le cadre de l'administration d'IBM WebSphere Application Server.
Type de données Chaîne
Noeud
Nom WebSphere du noeud d'administration sur lequel fonctionne le serveur JMS pour cette fabrique de connexions. Les connexions créées par cette fabrique permettent la liaison avec ce serveur JMS.
Type de données Enumération
Valeur par défaut Null
Plage Liste déroulante des noeuds du domaine administratif WebSphere.
Port
Celui des deux ports utilisé par les connexions pour se connecter au serveur JMS. Le port QUEUED est destiné à la prise en charge complète de la messagerie par publication/abonnement JMS, le port DIRECT est destiné uniquement aux abonnements non-persistants, non-transactionnels, non-durables.

Important: Les beans gérés par messages ne peuvent pas utiliser le port d'écoute direct pour le support Publication/Abonnement. Par conséquent, toute fabrique de connexions de rubrique configurée avec la propriété Port définie sur Direct ne peut pas être utilisée avec les beans gérés par messages.

Type de données Enumération
Unité Non applicable
Valeur par défaut QUEUED
Plage
QUEUED
Le port d'écoute utilisé pour la prise en charge complète de la messagerie par publication/abonnement JMS.
DIRECT
Le port d'écoute utilisé pour la connexion TCP/IP directe (abonnements non-transactionnels, non-persistants et non-durables uniquement) pour la prise en charge Publication/Abonnement.

Les numéros de port TCP/IP pour ces ports sont définis sur le serveur JMS interne de WebSphere.

Alias d'authentification géré par composant
Cet alias spécifie un ID utilisateur et un mot de passe à utiliser pour authentifier la connexion à un fournisseur JMS pour l'authentification gérée par l'application.

Cette propriété fournit la liste des alias des entrées de données d'authentification J2C définis pour WebSphere Application Server. Vous pouvez sélectionner un alias d'entrée de données pour authentifier la création d'une connexion au fournisseur JMS.

Si vous avez activé la sécurité globale de WebSphere Application Server, sélectionnez l'alias qui spécifie l'ID utilisateur et le mot de passe utilisés pour authentifier la création d'une connexion au fournisseur JMS. L'utilisation de cet alias dépend du paramétrage de l'authentification de la ressource (res-auth) déclaré dans la référence de ressource de la fabrique de connexions des descripteurs de déploiement du composant d'application.

Important: Les ID utilisateur de plus de 12 caractères ne peuvent pas être utilisés pour l'authentification avec le fournisseur intégré JMS WebSphere. Par exemple, l'ID utilisateur par défaut de Windows NT, Administrator, n'est pas valable avec la messagerie intégrée WebSphere car il comporte 13 caractères. Par conséquent, un alias d'authentification pour une fabrique de connexion au fournisseur JMS WebSphere doit spécifier un ID utilisateur de moins de 13 caractères.

Alias d'authentification géré par conteneur
Cet alias spécifie un ID utilisateur et un mot de passe à utiliser pour authentifier la connexion à un fournisseur JMS pour l'authentification gérée par conteneur.

Cette propriété fournit la liste des alias des entrées de données d'authentification J2C définis pour WebSphere Application Server. Vous pouvez sélectionner un alias d'entrée de données pour authentifier la création d'une connexion au fournisseur JMS.

Si vous avez activé la sécurité globale de WebSphere Application Server, sélectionnez l'alias qui spécifie l'ID utilisateur et le mot de passe utilisés pour authentifier la création d'une connexion au fournisseur JMS. L'utilisation de cet alias dépend du paramétrage de l'authentification de la ressource (res-auth) déclaré dans la référence de ressource de la fabrique de connexions des descripteurs de déploiement du composant d'application.

Important: Les ID utilisateur de plus de 12 caractères ne peuvent pas être utilisés pour l'authentification avec le fournisseur intégré JMS WebSphere. Par exemple, l'ID utilisateur par défaut de Windows NT, Administrator, n'est pas valable avec la messagerie intégrée WebSphere car il comporte 13 caractères. Par conséquent, un alias d'authentification pour une fabrique de connexion au fournisseur JMS WebSphere doit spécifier un ID utilisateur de moins de 13 caractères.

Alias de configuration de mappage
Permet aux utilisateurs de sélectionner une option à partir de la liste Sécurité > Configuration JAAS > Configuration de connexion de l'application.

La configuration JAAS DefaultPrincipalMapping associe l'alias d'authentification à l'ID utilisateur et au mot de passe. Vous pouvez définir et utiliser d'autres configurations d'associations. Pour plus d'informations sur les configurations d'associations, reportez-vous à la section Paramètres d'entrée de configuration du service JAAS (Java Authentication and Authorization service).

Type de données Liste de sélection
Support de clone
Cochez cette case pour activer le support de clone afin de permettre le même abonnement durable sur tous les clones de rubriques.
Type de données Enumération
Valeur par défaut Effacé
Plage
Sélectionné
Le support du clone est activé.
Effacé
Le support du clone est désactivé.

Si vous sélectionnez cette propriété, vous devez également indiquer une valeur pour la propriété ID client.

ID client
L'ID du client JMS utilisé pour les connexions au gestionnaire de files d'attente.
Type de données Chaîne
Plage Un ID client JMS valide
Compatible XA
Indique si la fabrique de connexions concerne la coordination XA ou non-XA des messages et contrôle si le serveur d'applications utilise XA QCF/TCF. Activez XA si plusieurs ressources ne sont pas utilisées dans la même transaction.

Si vous décochez cette propriété (pour une coordination non XA), la session JMS figure encore dans une transaction, mais utilise les appels de transaction locale du gestionnaire de ressources (session.commit et session.rollback) au lieu des appels XA. Ceci peut entraîner un amélioration des performances. Cependant, cela signifie que, dans WebSphere Application Server, une seule ressource peut figurer dans une transaction. Dans WebSphere Application Server Enterprise, le support du dernier participant vous permet d'inscrire une ressource non-XA avec d'autres ressources compatibles avec XA.

Cette propriété ne s'applique pas aux fabriques de connexions de rubrique dont la propriété Port a la valeur DIRECT ; elle prend toujours une valeur NON_XA.

Type de données Case à cocher
Valeur par défaut Sélectionnée (activée pour la coordination XA)
Plage
Sélectionné
La fabrique de connexions est activée pour la coordination XA des messages
Effacé
La fabrique de connexions n'est pas activée pour la coordination XA des messages
Recommandation N'activez pas la coordination XA lorsque la file d'attente ou la rubrique du message reçue est la seule ressource de la transaction. Activez la coordination XA lorsque d'autres ressources, y compris d'autres files d'attente ou rubriques, sont concernées.
Pool de connexion
Indique un ensemble facultatif de paramètres de pool de connexion.

Les propriétés du pool de connexion sont communes à tous les connecteurs J2C.

Le serveur d'applications met en pool les connexions et les sessions avec le fournisseur JMS afin d'améliorer les performances. Vous devez configurer les propriétés du pool de connexions et de sessions de façon appropriée pour vos applications, sinon, vous risquez de ne pas obtenir le comportement de connexion et de session que vous souhaitez.

Modifiez la taille du pool de connexion si l'accès concurrent côte serveur à la ressource JMS dépasse la valeur par défaut. La taille du pool de connexion est définie sur la base d'une file d'attente ou d'une rubrique individuelle. Pour plus de détails, reportez-vous au tableau ci-après.

Pool de session
Un ensemble optionnel de paramètres de pool de session.

Ce lien fournit un écran de propriétés de pool de connexion optionnelles, communes à tous les connecteurs J2C.

Le serveur d'applications met en pool les connexions et les sessions avec le fournisseur JMS afin d'améliorer les performances. Vous devez configurer les propriétés du pool de connexions et de sessions de façon appropriée pour vos applications, sinon, vous risquez de ne pas obtenir le comportement de connexion et de session que vous souhaitez.

Informations connexes

Boutons de la console administrative
Paramètres de la portée de la console administrative
Paramètres du pool de connexions
Paramètres du pool de sessions
Paramètres d'entrée de données d'authentification du connecteur Java 2