[Version 5.1 et versions ultérieures]Paramètres de fabrique de connexions de rubriques WebSphere MQ

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 WebSphere MQ JMS. 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 WebSphere MQ JMS. Une fabrique de connexions de rubriques du fournisseur WebSphere MQ JMS est dotée des propriétés suivantes.

Important:

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

Nom
Nom sous lequel cette fabrique de connexions topic est connue pour l'administration d'IBM WebSphere Application Server. Ce nom doit être unique dans le fournisseur JMS.
Type de données Chaîne
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
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
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.

Gestionnaire de files d'attente
Le nom du gestionnaire de files d'attente WebSphere MQ pour cette fabrique de connexions. Les connexions créées par cette rubrique se connectent à ce gestionnaire de files d'attente.
Type de données Chaîne
Valeur par défaut Null
Plage Un nom de gestionnaire de file d'attente WebSphere valide, comportant de 1 à 48 caractères ASCII
Hôte
Le nom de l'hôte sur lequel s'exécute le gestionnaire de files d'attente WebSphere MQ, uniquement pour la connexion client.
Type de données Chaîne
Valeur par défaut Null
Plage Un nom d'hôte TCP/IP valide
Port
Numéro de port TCP/IP utilisé pour la connexion au gestionnaire de files d'attente WebSphere MQ, uniquement pour la connexion client.

Ce port doit être configuré sur le gestionnaire de files d'attente WebSphere MQ.

Type de données Entier
Valeur par défaut Null
Plage Un numéro de port TCP/IP valide, configuré dans le gestionnaire de files d'attente WebSphere MQ.
Canal
Le nom du canal utilisé pour la connexion au gestionnaire de files d'attente WebSphere MQ, uniquement pour la connexion client.
Type de données Chaîne
Valeur par défaut Null
Plage 1 à 20 caractères ASCII
Type de transport
Indique si la connexion client WebSphere MQ ou les liaisons JNDI sont utilisées pour la connexion au gestionnaire de files d'attente WebSphere MQ. Le fournisseur JMS externe contrôle les protocoles de communication entre les clients et les serveurs JMS. Ajustez le type de transport lorsque vous utilisez des fonctions de messagerie non-ASF, non persistantes, non durables et non transactionnelles ou pour répondre aux exigences de sécurité lorsque le client est installé en local sur le noeud du gestionnaire de files d'attente.
Type de données Enumération
Unité Non applicable
Valeur par défaut LIAISONS
Plage
LIAISONS
Les liaisons JNI sont utilisées pour se connecter au gestionnaire de files d'attente. BINDINGS est un protocole de mémoire partagée utilisable uniquement lorsque le gestionnaire de files d'attente est sur le même noeud que le client JMS et présente quelques risques au niveau de la sécurité qu'il est possible de gérer par le biais des rôles EJB.
CLIENT
Une connexion client WebSphere MQ est utilisée pour la connexion au gestionnaire de files d'attente. Un CLIENT est un protocole TCP type.
DIRECT
Indique que WebSphere MQ Event Broker utilise le mode DIRECT. DIRECT est un protocole de socket partiel utilisé avec les fonctions de messagerie de publication/abonnement non transactionnelles, non durables et non persistantes. DIRECT fonctionne uniquement pour les clients et les beans gérés par message utilisant le protocole non-ASF.
QUEUED
QUEUED est un protocole standard TCP.
Recommandation
Type de transport de fabrique de connexions de file d'attente
BINDINGS est 30 % plus rapide mais n'offre pas un niveau de sécurité suffisant. Si la sécurité est un facteur important, il est conseillé d'utiliser le protocole BINDINGS plutôt que CLIENT.
Type de transport de fabrique de connexions de rubrique
DIRECT est le protocole le plus rapide et doit être utilisé aussi souvent que possible. Utilisez le protocole BINDINGS pour effectuer des tâches de sécurité supplémentaires et lorsque le gestionnaire de files d'attente est installé en local sur le client JMS. L'utilisation du protocole QUEUED est réservée à tous les autres cas de figure. WebSphere MQ 5.3 avant CSD2, doté du paramètre DIRECT, peut entraîner une perte des messages lorsqu'il est utilisé avec les beans gérés par message en cas de forte charge de travail. Cela se produit également pour les applications côté client à moins que la valeur 0 soit affectée au paramètre maxClientQueueSize de la fonction Broker. Pour affecter la valeur 0 à ce paramètre, lancez la commande #wempschangeproperties NomNoeud_WAS_serveur1 -e default -o MoteurAbonnementDynamique -n TailleMaxFileAttenteClient -v 0 -x UUIDGroupeExécution, la valeur de UUIDGroupeExécution pouvant être obtenue en démarrant le courtier et en recherchant l'événement 2201 dans les applications/journaux d'événements. Il s'agit généralement de la valeur ffffffff-0000-0000-000000000000.
File d'attente de contrôle du courtier
Le nom de la file d'attente de contrôle du courtier vers laquelle tous les messages de commande (sauf les publications et les demandes de suppression de publications) sont envoyés.

Nom de la file d'attente de contrôle du courtier. Les applications de publication et d'abonnement, et d'autres courtiers, envoient tous les messages de commande (sauf les publications et les demandes de suppression de publications) vers cette file d'attente.

Type de données Chaîne
Unité Caractères ASCII En_US
Valeur par défaut Null
Plage Caractères ASCII 1 à 48
Gestionnaire de files d'attente de courtier
Le nom du gestionnaire de files d'attente WebSphere MQ qui fournit le courtier de messages par publication/abonnement.
Type de données Chaîne
Unité Caractères ASCII En_US
Valeur par défaut Null
Plage Caractères ASCII 1 à 48
File d'attente de publication de courtier
Nom de la file d'attente d'entrée du courtier qui reçoit tous les messages de publication pour le flot par défaut.

Nom de la file d'attente d'entrée du courtier (file d'attente de flot) qui reçoit tous les messages de publication pour le flot par défaut. Les applications peuvent également envoyer des requêtes pour supprimer des publications sur le flot par défaut vers cette file d'attente.

Type de données Chaîne
Unité Caractères ASCII En_US
Valeur par défaut Null
Plage Caractères ASCII 1 à 48
File d'attente d'abonnement de courtier
Nom de la file d'attente de courtier de laquelle des messages d'abonnement non durables sont extraits.

Nom de la file d'attente de courtier de laquelle des messages d'abonnement non durables sont extraits. L'abonné spécifie le nom de la file d'attente lorsqu'il s'inscrit pour un abonnement.

Type de données Chaîne
Unité Caractères ASCII En_US
Valeur par défaut Null
Plage Caractères ASCII 1 à 48
File d'attente d'abonnement de courtier CC
Nom de la file d'attente du courtier de laquelle les messages d'abonnement non durables sont extraits pour un ConnectionConsumer. Cette propriété s'applique uniquement au conteneur Web.

Nom de la file d'attente du courtier de laquelle les messages d'abonnement non durables sont extraits pour un ConnectionConsumer. Cette propriété s'applique uniquement au conteneur Web.

Type de données Chaîne
Unité Caractères ASCII En_US
Valeur par défaut Null
Plage Caractères ASCII 1 à 48
Version courtier
Indique si le courtier de message est fourni par WebSphere MA0C Supportpac ou par des versions plus récentes de produits de courtage de messages WebSphere
Type de données Enumération
Unité Non applicable
Valeur par défaut Avancé
Plage
Avancé
Le courtier de message est fourni par des versions plus récentes de produits de courtage de messages WebSphere (WebsSphere MQ Integrator et EventBroker).
De base
Le courtier de message est fourni par WebSphere MQ MA0C SupportPac (MQSeries - Publication/Abonnement) ou MQSI fonctionnant en mode de compatibilité MA0C.
Définition de la file d'attente modèle
Le nom de la définition de file d'attente modèle utilisable par le courtier pour créer des files d'attente dynamiques, pour les flots qui ne sont pas des flots par défaut, s'il n'existe pas de file d'attente de flot.

Le nom de la définition de file d'attente modèle utilisable par le courtier pour créer des files d'attente dynamiques afin de recevoir des publications pour les flots autres que le flot par défaut. Cette file d'attente est uniquement utilisée s'il n'existe pas de file d'attente de flot. Si cette définition de file d'attente modèle n'existe pas, toutes les files d'attente de flot doivent être définies par l'administrateur.

Type de données Chaîne
Unité Caractères ASCII En_US
Valeur par défaut Null
Plage Caractères ASCII 1 à 48
CCSID
L'ID de jeu de caractères codés à utiliser avec le gestionnaire de files d'attente WebSphere MQ.

Cet ID de jeu de caractères codés (CCSID) doit figurer parmi les CCSID pris en charge par WebSphere MQ.

Type de données Chaîne
Unité Entier
Valeur par défaut Null
Plage 1 à 65535

Pour plus d'informations sur les CCSID pris en charge et sur la conversion des données d'un message d'un jeu de caractères codés à un autre, reportez-vous aux documents WebSphere MQ System Administration et WebSphere MQ Application Programming Reference. Ces documents sont disponibles dans les pages Web de la messagerie WebSphere MQ multiplateforme et spécifique à chaque plateforme (Par exemple, à l'adresse Vous ne pouvez accéder à la cible que si cette rubrique est liée au Web   http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html ), auprès d'Vous ne pouvez accéder à la cible que si cette rubrique est liée au Web   IBM Publications Center ou dans le kit de collection WebSphere MQ, SK2T-0730.

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
Unité Non applicable
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, sous forme de caractères ASCII
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 affectez la valeur NON_XA à cette propriété, 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 la valeur NON_XA.

Type de données Enumération
Unité Non applicable
Valeur par défaut Compatible XA
Plage
XA
La fabrique de connexions concerne la coordination XA des messages
NON_XA
La fabrique de connexions concerne la non-coordination XA des messages
Recommandation N'activez pas XA lorsque la file d'attente ou la rubrique du message reçue est la seule ressource de la transaction. Activez 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. Ceci est indépendant de tout regroupement de connexions WebSphere MQ. 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. Ceci est indépendant de tout regroupement de connexions WebSphere MQ. 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.

Propriétés personnalisées
Ensemble facultatif de paires nom et valeur pour des propriétés personnalisées et transmises à WebSphere MQ.

Vous pouvez accéder à la page Propriétés personnalisées pour définir les propriétés WebSphere MQ suivantes. Ces propriétés s'appliquent uniquement si vous définissez la propriété Transport type=CLIENT.

Pour plus d'informations sur la définition des propriétés SSL, reportez-vous à la section Propriétés SSL dans le manuel WebSphere MQ Using Java.