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.
-
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.
-
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.
-
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.
-
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.
- 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:
- 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.
- 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
http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html
),
auprès d'
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.