Paramètres de la fabrique de connexions de file d'attente du fournisseur de messagerie IBM MQ

Ce panneau permet d'afficher ou de modifier les propriétés de configuration de la fabrique de connexions de file d'attente sélectionnée à utiliser avec le fournisseur de messagerie IBM MQ. Ces propriétés de configuration déterminent comment les connexions sont créées et associées à des files d'attente JMS.

Une fabrique de connexions de file d'attente IBM MQ sert à créer des connexions JMS à des files d'attente fournies par IBM MQ pour la messagerie point à point.

Pour afficher les paramètres de la fabrique de connexions de file d'attente IBM MQ, appliquez la procédure suivante à partir de la console d'administration :

Dans la sous-fenêtre de navigation, cliquez sur Ressources > JMS->Fabriques de connexions de file d'attente pour afficher les fabriques de connexions de file d'attente existantes.
Le cas échéant, dans le panneau de contenu, modifiez la valeur du paramètre Portée en lui attribuant le niveau auquel les fabriques de connexions de file d'attente sont définies. Ceci restreint l'ensemble de fabriques de connexions de file d'attente affiché.
Sélectionnez le nom de la fabrique de connexions de file d'attente à utiliser.

Il existe quatre groupes de propriétés sous Propriétés générales :

Administration
Connexion
Avancé
Paramètres de sécurité

Effectuez les modifications nécessaires aux propriétés des groupes Administration, Connexion, Avancées et Paramètres de sécurité, puis cliquez sur Appliquer pour enregistrer la configuration avant de sélectionner les liens suivants dans le panneau de contenu sous Propriétés supplémentaires :

Propriétés avancées pour afficher les propriétés avancées de votre fabrique de connexions de file d'attente IBM MQ.
Propriétés avancées pour afficher les propriétés personnalisées de la fabrique de connexions de file d'attente IBM MQ.
Propriétés de transport du client pour afficher ou modifier les propriétés de transport du client de la fabrique de connexions de file d'attente IBM MQ. Si la fabrique de connexions sélectionnée n'a pas été créée à l'aide d'une table de définition de canal du client (CCDT), suivez ce lien pour entrer toutes les informations nécessaires à la connexion à IBM MQ. Si la fabrique de connexions de file d'attente sélectionnée a été créée à l'aide d'une CCDT, vous n'avez pas besoin de fournir les propriétés de transport du client et le lien est donc absent.
Pools de connexions pour afficher les détails du pool de connexions de la fabrique de connexions de file d'attente IBM MQ.
Pools de sessions pour afficher les détails du pool de sessions de votre fabrique de connexions de file d'attente IBM MQ.

Sous Articles liés, vous pouvez cliquer sur JAAS - Données d'authentification J2C pour configurer les informations d'authentification à utiliser avec la fabrique de connexions de file d'attente.

Vous pouvez spécifier les propriétés supplémentaires suivantes à l'aide des commandes d'administration IBM MQ :

-localAddress
-componentAuthAlias

Pour plus d'informations sur ces propriétés, voir le document Commande createWMQConnectionFactory.

Remarque : Lorsque vous spécifiez des propriétés IBM MQ, vous devez respecter les restrictions suivantes :

Les noms peuvent comporter jusqu'à 48 caractères, à l'exception des canaux, qui ne peuvent pas en comporter plus de 20.
Les valeurs de propriété que vous indiquez doivent correspondre aux valeurs que vous avez indiquées lors de la configuration de IBM MQ pour les ressources JMS. Pour plus d'informations sur la configuration des ressources JMS IBM MQ, voir les sections Using Java et System Administration dans le centre de documentation IBM MQ.

Une fabrique de connexions de file d'attente IBM MQ a les propriétés suivantes.

Administration

Portée

Niveau auquel cette définition de ressource est visible des applications.

Des ressources telles que les fournisseurs de messagerie, 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).

La portée affichée est à des fins d'information uniquement et n'est pas modifiable dans cet écran. Pour parcourir ou modifier cette ressource (ou d'autres ressources) par une portée différente, modifiez la portée sur le panneau de collection de la fabrique de connexions de file d'attente IBM MQ, puis cliquez sur Appliquer avant de cliquer sur le lien correspondant au type de ressource.

Informations	Value
Type de données	Chaîne

Fournisseur

Fournisseur JMS affecté lors de la création de la fabrique de connexions de file d'attente.

Pour toutes les fabriques de connexions de file d'attente créées à l'aide de ce panneau, le fournisseur est le fournisseur de messagerie IBM MQ.

Le fournisseur s'affiche à titre d'information uniquement.

Informations	Value
Type de données	Chaîne

Nom

Nom sous lequel la fabrique de connexions de file d'attente est connue pour l'administration dans WebSphere Application Server.

Informations	Value
Type de données	Chaîne
Plage de valeurs	Le nom doit être unique dans l'ensemble des fabriques de connexions de file d'attente défini dans la cellule.

Nom JNDI

Nom JNDI utilisé pour lier la fabrique de connexions de file d'attente à l'espace de nom.

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

Informations	Value
Type de données	Chaîne

Description

Description de la fabrique de connexions de file d'attente pour l'administration dans WebSphere Application Server.

Informations	Value
Type de données	Chaîne
Valeur par défaut	Null

Connexion

Les informations requises pour configurer une connexion varient selon que la fabrique de connexions de file d'attente sélectionnée a été créée ou non à l'aide d'une table de définition de canal du client (CCDT).

Si la fabrique de connexions de file d'attente sélectionnée a été créée à l'aide d'une CCDT, seules les propriétés suivantes sont affichées :

URL de la table de définition de canal du client
Gestionnaire de files d'attente
Configuration SSL

Si la fabrique de connexions de file d'attente sélectionnée n'a pas été créée à l'aide d'une CCDT, les propriétés suivantes sont affichées :

Gestionnaire de files d'attente
Transport
Si l'option Entrez les informations sur l'hôte et sur le port sous forme de valeurs de nom d'hôte et de port distinctes est sélectionnée, la propriété de la liste de noms de connexion ne peut pas être utilisée contrairement aux propriétés suivantes :
- Nom d'hôte
- Port
Si l'option Entrez les informations sur l'hôte et sur le port sous forme de liste de noms de connexion est sélectionnée, la propriété de la liste de noms de connexion peut être utilisée contrairement aux propriétés suivantes :
- Nom d'hôte
- Port
Nom d'hôte
Port
Canal de connexion serveur
Si vous avez désélectionné la case à cocher de la propriété Utiliser SSL pour sécuriser des communications avec WebSphere MQ, les propriétés suivantes ne peuvent pas être utilisées :
- Géré de façon centrale
- Configuration spécifique
- Configuration SSL

Pour plus d'informations sur la définition des propriétés SSL pour IBM MQ, voir SSL properties dans la section Using Java du centre de documentation IBM MQ.

URL de la table de définition de canal du client

URL qui définit l'emplacement d'une table CCDT IBM MQ.

Informations	Value
Type de données	Chaîne

Gestionnaire de files d'attente

Si la fabrique de connexions de file d'attente se base sur CCDT, cette propriété est utilisée pour sélectionner une entrée dans CCDT. Sinon, il s'agit du nom du gestionnaire de files d'attente ou du groupe de partage de files d'attente auquel vous vous connectez. Une connexion est établie à cette ressource IBM MQ pour envoyer ou recevoir des messages.

Informations

Value

Type de données

Chaîne

Plage de valeurs

Si cette fabrique de connexions de file d'attente ne se base pas sur CCDT, la valeur doit être un nom de gestionnaire de files d'attente valide.

Si cette fabrique de connexions de file d'attente se base sur CCDT, la valeur doit être l'une des valeurs suivantes :

un nom de gestionnaire de files d'attente valide,
Astérisque (*) suivi du groupe de gestionnaires de files d'attente¹
Astérisque (*),
Vide ¹

¹Lorsque vous définissez la valeur de la propriété Gestionnaire de files d'attente de cette manière en combinaison avec une table CCDT, les connexions individuelles en utilisant la spécification d'activation peuvent être établies à des gestionnaires de files d'attente différents. Plusieurs gestionnaires de files d'attente sont sélectionnés lorsque la table CCDT contient plusieurs définitions de canaux de connexion client avec un paramètre de nom de gestionnaire de files d'attente (QMNAME) correspondant et que ces définitions définissent les informations de connexion réseau de différents gestionnaires de files d'attente.

Si la fabrique de connexions repose sur une table CCDTI et que la table peut choisir entre plusieurs gestionnaires de files d'attente, vous ne pouvez pas récupérer les transactions globales. Par conséquent, pour les fabriques de connexions qui spécifient une table CCDT, vous avez deux possibilités :

Evitez toute ambiguïté sur le gestionnaire de files d'attente cibles lorsque vous spécifiez la propriété de gestionnaire de files d'attente ; la valeur spécifiée pour cette propriété ne doit pas inclure d'astérisque (*).
Evitez d'utiliser les ressources avec des applications engagées dans des transactions globales.

Transport

Type de transport IBM MQ de la connexion. Le type de transport permet d'indiquer le mécanisme précis utilisé pour se connecter à IBM MQ.

Informations	Value
Type de données	Liste déroulante
Valeur par défaut	Liaisons, puis client
Plage de valeurs	Client Utilisez une connexion réseau TCP/IP pour communiquer avec le gestionnaire de files d'attente IBM MQ. Liaisons, puis client Tentez d'établir une connexion en mode liaisons au gestionnaire de files d'attente. Si ce n'est pas possible, repassez en mode de transport du client. Liaisons Etablit une connexion transmémoire à un gestionnaire de files d'attente en cours d'exécution sur le même noeud. Les propriétés suivantes du mode de transport du client sont désactivées : Nom d'hôte Port Liste de noms de connexion Canal de connexion serveur Pour plus d'informations sur la configuration d'un type de transport `Liaisons, puis client` ou `Liaisons`, voir Configuration du fournisseur de messagerie IBM MQ avec des informations de bibliothèques natives.

Entrez les informations d'hôte et de port sous forme de valeurs de nom d'hôte et de port distinctes.

Si vous sélectionnez ce bouton d'option, vous indiquez que la connexion au gestionnaire de files d'attente IBM MQ est établie en utilisant les informations fournies par les propriétés de nom d'hôte et de port.

La sélection de cette option active les propriétés de nom d'hôte et de port et désactive la propriété de liste de noms de connexion. Pour entrer les informations d'une liste de nom de connexion, cliquez sur Entrez les informations sur l'hôte et sur le port sous forme de liste de noms de connexion.

Ce bouton radio est disponible uniquement si la propriété de portée définit une cellule ou un cluster ou bien un noeud ou un serveur exécutant WebSphere Application Server Version 8.0 ou ultérieure.

Informations	Value
Type de données	Bouton d'option

Nom d'hôte

Nom d'hôte, adresse IPv4 ou adresse IPv6 du gestionnaire de files d'attente IBM MQ auquel vous vous connectez.

Informations	Value
Type de données	Chaîne

Port

Numéro du port qu'écoute IBM MQ.

Informations	Value
Type de données	Entier
Valeur par défaut	1414
Plage de valeurs	La valeur doit être comprise entre 1 et 65536 (inclus).

Entrez les informations sur l'hôte et sur le port sous forme de liste de noms de connexion

Si vous sélectionnez ce bouton d'option, vous indiquez que la connexion au gestionnaire de files d'attente IBM MQ est établie en utilisant les informations fournies par la propriété de liste de noms de connexion.

Vous pouvez utiliser des listes de noms de connexion pour établir une connexion à un seul gestionnaire de files d'attente ou à un gestionnaire de files d'attente multi-instance. Pour plus d'informations sur l'utilisation d'un gestionnaire de files d'attente multi-instance, voir le centre de documentation de IBM MQ. La sélection de cette option active la propriété de liste de noms de connexion et désactive les propriétés de nom d'hôte et de port. Pour entrer des informations de nom d'hôte et de port distinctes, cliquez sur Entrez les informations sur l'hôte et sur le port sous forme de valeurs de nom d'hôte et de port distinctes.

Informations	Value
Type de données	Bouton d'option

Liste de noms de connexion

Liste de noms de connexion qui définit les informations de nom d'hôte et de port à utiliser lorsque vous voulez que la spécification d'activation se connecte à un gestionnaire de files d'attente multi-instance.

Utilisez cette propriété uniquement pour autoriser la connexion à un gestionnaire de files d'attente multi-instance. Ne l'utilisez pas pour autoriser des connexions à des gestionnaires de files d'attente à instance unique afin de ne pas générer des problèmes d'intégrité des transactions.

Informations

Value

Type de données

Chaîne

Valeur par défaut

Non définie

Plage de valeurs

Cette zone doit se présenter sous la forme d'une chaîne au format suivant :

host[(port)][,hôte(port)]

Les informations de port sont facultatives. Si vous n'en définissez pas, la valeur par défaut est 1414.

La variable hôte doit correspondre à un nom d'hôte TCP/IP ou à une adresse IPv4 ou IPv6 valide.

port doit être un entier compris entre 1 et 65536 (inclus).

Par exemple : localhost(1234),remotehost1(1234),remotehost2

Si vous définissez la propriété de liste de noms de connexion, les propriétés de nom d'hôte et de port sont définies automatiquement dans le nom d'hôte ou le numéro de port de la première entrée de la liste de noms de connexion. Par conséquent, si vous définissez localhost(1234),remotehost1(1234),remotehost2, le nom d'hôte doit correspondre à localhost et le port à 1234.

Cette propriété est disponible uniquement si la propriété de portée définit une cellule ou un cluster ou bien un noeud ou un serveur exécutant WebSphere Application Server Version 8.0 ou ultérieure.

Lorsque vous les utilisez dans un environnement de cellule mixte, les informations se trouvant dans la propriété de liste de noms de connexion ne sont pas disponibles pour les versions de WebSphere Application Server antérieures à la version 2. Dans ce cas, les informations se trouvant dans les zones de nom d'hôte et de nom de port sont utilisées à la place en fonction du premier élément dans la liste de noms de connexion.

Canal de connexion serveur

Nom du canal de connexion serveur IBM MQ utilisé lors de la connexion à IBM MQ.

Informations	Value
Type de données	Chaîne
Valeur par défaut	SYSTEM.DEF.SVRCONN
Plage de valeurs	Cette valeur doit correspondre à un canal de connexion serveur défini dans le gestionnaire de connexions IBM MQ sur lequel une connexion est en cours d'établissement.

Utilisation du protocole SSL pour sécuriser les communications avec IBM MQ

Cette option détermine si le protocole SSL (Secure Sockets Layer) est utilisé pour sécuriser les communications réseau avec le gestionnaire de files d'attente ou le groupe de partage de files d'attente IBM MQ.

Lorsque vous utilisez une fabrique de connexions de file d'attente de fournisseur de messagerie IBM MQ dans l'environnement du serveur d'applications, cette dernière gère la configuration SSL. Pour modifier les paramètres de configuration de la couche Secure Sockets Layer, utilisez la console d'administration pour accéder à l'écran Sécurité > Certificat SSL et gestion des clés.

Lorsque vous utilisez une fabrique de connexions de file d'attente du fournisseur de messagerie IBM MQ dans l'environnement du client, ce dernier utilise les informations de configuration SSL du fichier ssl.client.props. L'utilisation de ce fichier est détaillée dans les informations de référence associées à cette rubrique.

Dans la configuration SSL, vous pouvez uniquement utiliser un algorithme de cryptographie pour une fabrique de connexions de file d'attente du fournisseur de messagerie IBM MQ. Si vous indiquez plus d'un algorithme de cryptographie, seul le premier est utilisé.

Informations	Value
Type de données	Case à cocher. Si cette case n'est pas cochée, les propriétés SSL suivantes sont désactivées : Géré de façon centrale Configuration spécifique Configuration SSL

Géré de façon centrale

Lorsque le protocole SSL est utilisé pour communiquer avec IBM MQ, sélectionnez ce bouton radio pour indiquer que la configuration SSL provient de la configuration SSL de WebSphere Application Server, gérée de façon centrale.

Lorsque vous sélectionnez ce bouton d'option, les attributs de nom d'hôte et de port de la fabrique de connexions du fournisseur de messagerie IBM MQ sont utilisés afin de sélectionner une configuration SSL adéquate. Si les informations sur l'hôte et le port ont été fournies par une liste de noms de connexion, cela signifie que les informations sur le nom d'hôte et le port du premier élément de la liste sont utilisées pour sélectionner une configuration SSL appropriée. Pour fournir la configuration SSL qui sera mise en correspondance avec la fabrique de connexions, reportez-vous à la rubrique relative aux paramètres de configuration SSL des noeuds finaux sortants dynamiques répertoriée sous la référence associée.

Informations	Value
Type de données	Bouton radio

Configuration spécifique

Sélectionnez ce bouton radio lorsque vous souhaitez spécifier une configuration SSL à utiliser lorsque le protocole SSL sert à sécuriser les communications réseau avec le gestionnaire de files d'attente ou le groupe de partage de files d'attente IBM MQ.

Informations	Value
Type de données	Bouton radio

Configuration SSL

Configuration SSL à utiliser lorsque SSL doit être utilisé pour sécuriser les communications réseau avec le gestionnaire de files d'attente ou le groupe de partage de files d'attente WebSphere.

Cette propriété est désactivée si le bouton radio Géré de façon centrale est sélectionné et que la ressource du fournisseur de messagerie WebSphere MQ a été définie de manière explicite.

Cette propriété est toujours activée si la ressource du fournisseur de messagerie WebSphere MQ est basée sur une table CCDT.

Si cette ressource du fournisseur de messagerie WebSphere MQ est basée sur une table CCDT, ce paramètre est uniquement utilisé si les entrées correspondantes de la table CCDT ont été configurées pour utiliser SSL.

De plus, si une configuration SSL none est sélectionnée, la configuration SSL WebSphere Application Server gérée de manière centralisée par défaut pour le fournisseur de messagerie IBM MQ est utilisée.

Informations	Value
Type de données	Liste déroulante

Avancé

ID client

Identificateur client à indiquer lors de la connexion au fournisseur de messagerie IBM MQ.

Informations	Value
Type de données	Chaîne

Version du fournisseur

Version du fournisseur de messagerie IBM MQ . Cette option est utilisée pour déterminer s'il faut se connecter à une version particulière du gestionnaire de connexions. Elle permet également de déterminer le type de fonctionnalité requis par le client.

Informations

Value

Type de données

Chaîne

Plage de valeurs

La valeur entrée doit être soit la chaîne vide, soit avoir l'un des formats suivants :

n.n.n.n
n.n.n
n.n
n

où n est une valeur numérique supérieure ou égale à 0.

Par exemple, 6.0.0.0.

Protocole de validation en deux phases sur support réparti

Option indiquant si la fabrique de connexions de file d'attente prend en charge la coordination XA des transactions de messagerie. Activez cette option si plusieurs ressources, dont cette fabrique de connexions de file d'attente, vont être utilisées dans cette transaction.

Si vous supprimez cette propriété, vous désactivez le protocole de validation en deux phases sur support réparti. La session JMS peut encore figurer dans une transaction, mais utilise les appels de transaction locale du gestionnaire de ressources session.commit et session.rollback, au lieu des appels XA. Cette configuration peut entraîner une amélioration des performances. Toutefois, dans WebSphere Application Server, une seule ressource peut figurer dans une transaction.

Le support du dernier participant vous permet d'inscrire une ressource non-XA avec d'autres ressources compatibles avec XA.

Informations	Value
Type de données	Case à cocher
Valeur par défaut	Elément sélectionné
Plage de valeurs	Elément sélectionné La fabrique de connexions de file d'attente prend en charge le protocole de validation en deux phases pour la coordination de travaux transactionnels. Non sélectionné La fabrique de connexions de file d'attente ne prend pas en charge les protocoles de validation en deux phases pour la coordination des travaux transactionnels.

Activez cette option si les transactions impliquent d'autres ressources, telles que d'autres files d'attente ou rubriques. Désélectionnez cette option seulement lorsque vous êtes certain que le gestionnaire de files d'attente, qui est la cible de la connexion de file d'attente, est la seule ressource dans la transaction.

Paramètres de sécurité

Alias d'authentification de la reprise XA

Nom d'utilisateur et mot de passe à utiliser lors d'une connexion à IBM MQ au cours d'une récupération XA.

Informations	Value
Type de données	Liste déroulante
Valeur par défaut	(Aucune)
Plage de valeurs	Tous les alias d'authentification définis sur la cellule et la valeur "(aucun)" qui spécifie qu'aucun justificatif n'est passé à IBM MQ pendant la récupération XA.

Alias de configuration de mappage

Cette zone est uniquement utilisée en l'absence d'une configuration de connexion dans la référence de ressource du composant.

Lorsque la valeur des droits de ressource est "container", la méthode de définition de la stratégie d'authentification privilégiée consiste à spécifier une configuration de connexion et des propriétés associées sur la référence de ressource du composant.

Si la configuration de connexion DefaultPrincipalMapping est spécifiée, la propriété associée sera un alias d'entrée de données d'authentification JAAS - J2C. Pour configurer des informations d'authentification à utiliser avec la fabrique de connexions de file d'attente, sous Articles liés, cliquez sur JAAS - Données d'authentification J2C .

Informations	Value
Type de données	Liste déroulante
Valeur par défaut	(Aucune)
Plage de valeurs	Les options suivantes sont disponibles : ClientContainer WSLogin WSKRB5Login DefaultPrincipalMapping TrustedConnectionMapping KerberosMapping

Alias d'authentification géré par conteneur

Alias d'authentification qui indique le nom d'utilisateur et le mot de passe à utiliser lors de la connexion au fournisseur de messagerie IBM MQ.

Informations	Value
Type de données	Liste déroulante
Valeur par défaut	(Aucune)
Plage de valeurs	Tous les alias d'authentification définis sur la cellule et la valeur "(aucun)" qui spécifie qu'aucun justificatif n'est passé à IBM MQ.

Nom du fichier : umj_pqcfm.html