[Version 5.1 et versions ultérieures]Paramètres de fabrique de connexions de files d'attente WebSphere MQ

Utilisez cet écran pour afficher ou modifier les propriétés de configuration de la fabrique de connexions de files d'attente 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 file d'attente JMS associée.

Une fabrique de connexions de files d'attente est utilisée pour créer des connexions JMS vers des destinations de file d'attente. La fabrique de connexions de file d'attente est créée par le fournisseur WebSphere MQ JMS. Une fabrique de connexions de file d'attente 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 file d'attente WebSphere MQ-> fabrique_connexions

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
Nom JNDI
Nom JNDI utilisé pour lier la fabrique de connexions à 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 dans IBM WebSphere Application Server à des fins d'administration.
Type de données Chaîne
Valeur par défaut Null
Catégorie
Une catégorie utilisée pour classer ou grouper cette fabrique de connexions 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:

  1. 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.
  2. Si vous voulez utiliser une connexion d'un fournisseur JMS WebSphere MQ alors que le mode de transport Liaisons est actif, vous devez définir la propriété Type de transport=LIAISONS sur la fabrique de connexion de file d'attente WebSphere MQ. Vous devez également choisir l'une des options suivantes :
    • Pour utiliser des justificatifs de sécurité, vérifiez que l'utilisateur spécifié est l'utilisateur connecté pour le processus WebSphere Application Server. Si l'utilisateur spécifié n'est pas l'utilisateur en cours de connexion pour le processus WebSphere Application Server, l'authentification par liaisons JMS WebSphere MQ émet l'erreur "MQJMS2013" qui indique une authentification de sécurité non valide pour MQQueueManager.
    • Ne spécifiez aucun justificatif de sécurité. Sur la fabrique de connexions de file d'attente WebSphere MQ, vérifiez que les propriétés Alias d'authentification géré par composant et Alias d'authentification géré par conteneur ne sont pas définies.

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:

  1. 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.
  2. Si vous voulez utiliser une connexion d'un fournisseur JMS WebSphere MQ alors que le mode de transport Liaisons est actif, vous devez définir la propriété Type de transport=LIAISONS sur la fabrique de connexion de file d'attente WebSphere MQ. Vous devez également choisir l'une des options suivantes :
    • Pour utiliser des justificatifs de sécurité, vérifiez que l'utilisateur spécifié est l'utilisateur connecté pour le processus WebSphere Application Server. Si l'utilisateur spécifié n'est pas l'utilisateur en cours de connexion pour le processus WebSphere Application Server, l'authentification par liaisons JMS WebSphere MQ émet l'erreur "MQJMS2013" qui indique une authentification de sécurité non valide pour MQQueueManager.
    • Ne spécifiez aucun justificatif de sécurité. Sur la fabrique de connexions de file d'attente WebSphere MQ, vérifiez que les propriétés Alias d'authentification géré par composant et Alias d'authentification géré par conteneur ne sont pas définies.

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
Le 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.

Si vous voulez utiliser une connexion d'un fournisseur JMS WebSphere MQ alors que le mode de transport Liaisons est actif, vous devez définir la propriété Type de transport=LIAISONS sur la fabrique de connexion de file d'attente WebSphere MQ. Vous devez également choisir l'une des options suivantes :

  • Pour utiliser des justificatifs de sécurité, vérifiez que l'utilisateur spécifié est l'utilisateur connecté pour le processus WebSphere Application Server. Si l'utilisateur spécifié n'est pas l'utilisateur en cours de connexion pour le processus WebSphere Application Server, l'authentification par liaisons JMS WebSphere MQ émet l'erreur "MQJMS2013" qui indique une authentification de sécurité non valide pour MQQueueManager.
  • Ne spécifiez aucun justificatif de sécurité. Sur la fabrique de connexions de file d'attente WebSphere MQ, vérifiez que les propriétés Alias d'authentification géré par composant et Alias d'authentification géré par conteneur ne sont pas définies.

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.
Définition de la file d'attente modèle
Le nom de la définition de file d'attente modèle utilisable par le gestionnaire de files d'attente pour créer des files d'attente temporaires si une file d'attente demandée n'existe pas encore.
Type de données Chaîne
Valeur par défaut Null
Plage Caractères ASCII 1 à 48
ID client
ID du client JMS utilisé pour les connexions au gestionnaire de files d'attente WebSphere MQ.
Type de données Chaîne
Valeur par défaut Null
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.

Conservation des messages
Sélectionnez cette case pour spécifier que les messages non désirés doivent être laissés dans la file d'attente. Sinon, les messages non désirés sont traités en fonction de leurs options de destination.
Type de données Enumération
Unité Non applicable
Valeur par défaut Effacé
Plage
Sélectionné
Les messages non désirés restent dans la file d'attente.
Effacé
Les messages non désirés sont traités en fonction de leurs options de destination.
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
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 Secure Sockets Layer (SSL) 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 de ces propriétés, reportez-vous à la section Propriétés SSL dans le manuel WebSphere MQ Using Java.