Paramètres de fabrique de connexions du fournisseur de messagerie IBM MQ
Ce panneau vous permet d'afficher ou de modifier les propriétés de configuration de la fabrique de connexions sélectionnée qui sera utilisée 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 sujets et files d'attente JMS.
Le fournisseur de messagerie IBM MQ prend en charge les interfaces JMS 1.1 indépendantes du domaine, telles que la fabrique de connexions JMS unifiée. Les applications indépendantes du domaine peuvent utiliser les mêmes interfaces pour la messagerie point-à-point et pour la messagerie de publication/abonnement, et prendre en charge les messageries point-à-point et de publication/abonnement dans une même transaction. Avec JMS 1.1, il est recommandé d'utiliser des fabriques de connexions JMS unifiées indépendantes du domaine pour les nouvelles applications. Une interface de domaine étend l'équivalent indépendant de domaine. Par conséquent, une application qui utilise une file d'attente de domaine et des fabriques de connexions de rubriques peut utiliser l'une ou l'autre des interfaces.
- Dans le panneau de navigation, cliquez sur pour afficher les fabriques de connexions existantes.
- Si nécessaire, attribuez au paramètre Portée le niveau auquel les fabriques de connexions sont définies dans le panneau de contenu. Ceci limite les fabriques de connexions affichées.
- Sélectionnez le nom de la fabrique de connexions à utiliser.
- Propriétés avancées, pour afficher ou modifier les propriétés avancées de votre fabrique de connexions IBM MQ.
- Propriétés du courtier, pour afficher ou modifier les propriétés du courtier de votre fabrique de connexions IBM MQ.
- Propriétés personnalisées, pour afficher ou modifier les propriétés personnalisées de votre fabrique de connexions IBM MQ.
- Propriétés de transport du client, pour afficher ou modifier les propriétés de transport du client de votre fabrique de connexions 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 pour la connexion à IBM MQ. Si la fabrique de connexions 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.
- Pool de connexions, pour afficher ou modifier les détails des pools de connexions de la fabrique de connexions IBM MQ.
- Pools de sessions, pour afficher ou modifier les détails des pools de sessions de la fabrique de connexions 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.
- -localAddress
- -clonedSubs
- -componentAuthAlias
- 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és que vous spécifiez doivent correspondre à celles spécifié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 IBM MQ System Administration du Knowledge Center IBM MQ.
Si la fonctionnalité IBM MQ a été désactivée dans une portée qui affecte cette ressource du fournisseur de messagerie IBM MQ, un message d'information indiquant que IBM MQ a été désactivé s'affiche. En environnement monoserveur, ce message d'information ne s'affiche qu'au redémarrage du serveur après la désactivation de la fonctionnalité IBM MQ. Dans un environnement de déploiement réseau, le message d'information s'affiche immédiatement.
Une fabrique de connexions unifiée IBM MQ possède les propriétés suivantes :
Administration
Portée
Niveau cette définition de fabrique de connexions 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 cette ressource (et d'autres) ou en modifier la portée, modifiez la portée dans le panneau de collection de fabriques de connexions puis cliquez sur Appliquer avant de sélectionner le lien du type de ressource.
Information | Value |
---|---|
Type de données | String |
Fournisseur
Fournisseur JMS affecté lors de la création de la fabrique de connexions de file d'attente.
Pour toutes les fabriques de connexions qui utilisent ce panneau, le fournisseur est le fournisseur de messagerie IBM MQ.
Le fournisseur s'affiche à titre d'information uniquement.
Information | Value |
---|---|
Type de données | String |
Nom
Nom sous lequel la fabrique de connexions est connue dans WebSphere Application Server à des fins d'administration.
Information | Value |
---|---|
Type de données | String |
Intervalle | Le nom doit être unique dans l'ensemble des fabriques de connexions définies pour la cellule. |
Nom JNDI
Le nom JNDI employé pour lier la fabrique de connexions à l'espace de nom JNDI.
Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource.
Information | Value |
---|---|
Type de données | String |
Description
Description de cette fabrique de connexions dans WebSphere Application Server à des fins d'administration.
Information | Value |
---|---|
Type de données | String |
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).
- URL de la table de définition de canal du client
- Gestionnaire de files d'attente
- Configuration SSL
- 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
- Canal de connexion serveur
- Si vous avez désélectionné la case à cocher Utiliser SSL pour sécuriser des communications avec IBM 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.
Information | Value |
---|---|
Type de données | String |
Gestionnaire de files d'attente
Si la fabrique de connexions 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 à la ressource IBM MQ définie pour l'envoi et la réception des messages.
Information | Value |
---|---|
Type de données | String |
Intervalle | Si cette fabrique de connexions ne se base pas sur CCDT, la valeur doit être un nom de gestionnaire de files d'attente valide. Si cette fabrique de connexions se base sur
CCDT, la valeur doit être l'une des valeurs suivantes :
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 :
|
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.
Information | Value |
---|---|
Type de données | Liste déroulante |
Valeur par défaut | Liaisons, puis client |
Intervalle |
|
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.
Information | Value |
---|---|
Type de données | Bouton radio |
Nom d'hôte
Nom d'hôte, adresse IPv4 ou IPv6 du gestionnaire de files d'attente IBM MQ auquel la connexion doit être établie.
Information | Value |
---|---|
Type de données | String |
port
Numéro du port qu'écoute IBM MQ.
Information | Value |
---|---|
Type de données | Entierr |
Valeur par défaut | 1414 |
Intervalle | 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.
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.
Information | Value |
---|---|
Type de données | Bouton radio |
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.
Information | Value |
---|---|
Type de données | String |
Valeur par défaut | Non définie |
Intervalle | Cette zone doit se présenter sous la forme d'une chaîne au format
suivant : hôte[(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 de canal de connexion serveur IBM MQ utilisé pour se connecter à IBM MQ.
Information | Value |
---|---|
Type de données | String |
Valeur par défaut | SYSTEM.DEF.SVRCONN |
Intervalle | Cette valeur doit correspondre à un canal de connexion serveur défini dans le gestionnaire de files d'attente IBM MQ auquel la connexion doit être établi. |
Utiliser 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 fournisseur de messagerie IBM MQ dans l'environnement du serveur d'applications, le serveur d'applications 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 .
Lorsque vous utilisez la fabrique de connexions du fournisseur de messagerie IBM MQ dans l'environnement du client, le client récupère la configuration SSL à partir 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 une suite de chiffrement pour une fabrique de connexions de fournisseur de messagerie IBM MQ. Si vous indiquez plus d'une suite de chiffrement, seule la première est utilisée.
Information | 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
Lorsque le protocole SSL est utilisé pour communiquer avec IBM MQ, sélectionnez ce bouton d'option pour indiquer que la configuration SSL provient de la configuration SSL WebSphere Application Server gérée de façon centralisée.
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.
Information | Value |
---|---|
Type de données | Bouton radio |
Configuration spécifique
Sélectionnez ce bouton d'option lorsque vous souhaitez spécifier une configuration SSL particulière à utiliser lorsque le protocole SSL sert à sécuriser les communications de réseau avec le gestionnaire de files d'attente ou le groupe de partage de file d'attente IBM MQ.
Information | Value |
---|---|
Type de données | Bouton radio |
Configuration SSL
Configuration SSL à utiliser lorsque SSL est utilisé pour sécuriser les communications réseau avec le gestionnaire de files d'attente ou le groupe de partage de file d'attente IBM MQ.
Cette propriété est désactivée si le bouton d'option Géré de façon centrale est sélectionné et la ressource du fournisseur de messagerie IBM MQa été définie de manière explicite.
Cette propriété est toujours activée si la ressource du fournisseur de messagerie IBM MQ est basée sur une table CCDT.
Si cette ressource du fournisseur de messagerie IBM MQ repose 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.
Information | Value |
---|---|
Type de données | Liste déroulante |
Avancé
ID client
Identificateur client à indiquer lors de la connexion au fournisseur de messagerie IBM MQ.
L'identité du client n'est pas un ID utilisateur dans le sens conventionnel et n'est pas liée à la sécurité. Elle est utilisée par les abonnements durables dans la messagerie publication-abonnement. Un abonnement durable continue de collecter les messages pendant que l'abonnée est "absent" (par exemple, il n'est pas actif ou il est défaillant) et distribue les messages lorsque l'abonné de reconnecte. L'identité du client est le jeton qui indique votre type d'abonné lorsque vous vous reconnectez pour obtenir les messages enregistrés automatiquement en vote absence.
Information | Value |
---|---|
Type de données | String |
Autoriser des abonnements durables clonés
Option déterminant si plusieurs serveurs peuvent accéder simultanément à plusieurs instances d'un abonnement durable.
Information | Value |
---|---|
Type de données | Case à cocher |
Valeur par défaut | Elément non sélectionné |
Intervalle |
|
Version du fournisseur
Version du fournisseur de messagerie IBM MQ. Cette valeur est utilisée pour déterminer si la connexion doit être établie à une version données d'un gestionnaire de files d'attente. Elle permet également de déterminer le type de fonctionnalité requis par le client.
Information | Value |
---|---|
Type de données | String |
Intervalle | La valeur entrée doit être soit la chaîne vide, soit avoir l'un des formats suivants :
Par exemple, 6.0.0.0. |
Protocole de validation en deux phases sur support réparti
Option indiquant si la fabrique de connexions prend en charge la coordination XA des transactions de messagerie. Activez cette option si plusieurs ressources, dont cette fabrique de connexions, doivent être utilisées dans la même 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, une seule ressource peut être listée dans une transaction dans WebSphere Application Server.
Le support du dernier participant vous permet d'inscrire une ressource non-XA avec d'autres ressources compatibles avec XA.
Information | Value |
---|---|
Type de données | Case à cocher |
Valeur par défaut | Sélectionnée |
Intervalle |
|
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 pour se connecter à IBM MQ lors d'une récupération XA.
Information | Value |
---|---|
Type de données | Liste déroulante |
Valeur par défaut | (Aucune) |
Intervalle | Tous les alias d'authentification définis dans la cellule et la valeur "(none)", qui spécifient qu'aucun justificatif n'est envoyé à IBM MQ lors de 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 est un alias d'entrée de données d'authentification JAAS - J2C. Pour configurer des informations d'authentification à utiliser avec la fabrique de connexions, sous Articles liés, cliquez sur JAAS - Données d'authentification J2C .
Information | Value |
---|---|
Type de données | Liste déroulante |
Valeur par défaut | (Aucune) |
Intervalle | Les options
suivantes sont disponibles :
|
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.
Information | Value |
---|---|
Type de données | Liste déroulante |
Valeur par défaut | (Aucune) |
Intervalle | Tous les alias d'authentification définis dans la cellule et la valeur "(none)" qui spécifie qu'aucun justificatif n'est envoyé à IBM MQ. |