IBM MQ Provider topic connection factory settings for application clients
Utilisez ce panneau pour afficher ou modifier les propriétés de configuration de l'usine de connexion de rubriques sélectionnée à utiliser avec le fournisseur IBM MQ Java™ Message Service (JMS). Ces propriétés de configuration contrôle la manière dont les connexions sont créées entre le fournisseur JMS et IBM MQ.
Pour afficher la page de l'outil de configuration des ressources du client d'application (ACRCT), cliquez sur Fichier > Ouvrir. Recherchez un fichier EAR et cliquez sur Ouvrir. Développez le fichier JAR sélectionné > Fournisseurs de messagerie > Fournisseur IBM MQ. Cliquez avec le bouton droit de la souris sur Fabriques de connexions de sujet, puis cliquez sur Nouveau.
- Les valeurs de propriétés que vous spécifiez doivent correspondre à celles spécifiées lors de la configuration des ressources JMS IBM MQ. Pour plus d'informations sur la configuration des ressources JMS IBM MQ, voir la section Using Java du centre de documentation IBM MQ.
- Dans IBM MQ, les noms peuvent avoir un maximum de 48 caractères, sauf les canaux dont les noms peuvent avoir jusqu'à 20 caractères uniquement.
- File d'attente de contrôle du courtier
- Cette valeur est réglée sur SYSTEM.BROKER.CONTROL.QUEUE pour le courtier MA0C et correspond à la file d'attente que consulte le courtier.
- Version de courtier
- Réglez cette valeur sur BASIC pour le courtier MA0C.
- ID client
- Réglez cette valeur comme vous le souhaitez pour le courtier MA0C (il s'agit d'une chaîne tenant lieu d'identificateur pour l'application client).
- Compatible XA
- Définissez cette valeur sur TRUE ou FALSE pour le courtier MA0C (le paramètre que vous utilisez est un indicateur d'amélioration de performance, vous déciderez probablement de définir cette valeur sur 'true' la plupart du temps).
- Sélection de messages de courtier
- Cette valeur est réglée sur CLIENT pour le courtier MA0C dont la sélection de messages s'effectue côté client.
- Type d'autorisation du courtier direct
- Cette valeur n'est pas obligatoire pour le courtier MA0C.
Une usine de connexion de rubrique pour le fournisseur JMS IBM MQ JMS a les propriétés suivantes.
Chaîne
Nom sous lequel cette fabrique de connexions de sujets est connue dans WebSphere Application Server. Il doit être unique dans le fournisseur JMS.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Description
Description de cette fabrique de connexions de rubriques dans WebSphere Application Server, à des fins d'administration.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Nom JNDI
Nom JNDI (Java Naming and Directory Interface) utilisé pour lier la fabrique de connexions de sujet à l'espace de 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 par le descripteur de déploiement du module aux ressources réelles (physiques) liées à JNDI par la plateforme.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Unité | Caractères ASCII En_US |
Intervalle | 1 à 45 caractères ASCII |
ID utilisateur
ID utilisateur, utilisé avec la propriété de mot de passe pour l'authentification si l'application appelante ne fournit pas explicitement d'ID utilisateur ou de mot de passe.
Si vous indiquez une valeur pour la propriété d'ID utilisateur vous devez également indiquer une valeur pour la propriété de mot de passe.
Les propriétés d'ID utilisateur et de mot de passe de la fabrique de connexions sont utilisées si l'application appelante ne fournit pas expressément d'ID utilisateur et de mot de passe, par exemple, si l'application appelante utilise la méthode createTopicConnection(). Le client JMS transmet l'ID utilisateur et le mot de passe au serveur JMS.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Mot de passe
Mot de passe utilisé avec la propriété d'ID utilisateur pour l'authentification si l'application appelante ne fournit pas explicitement un ID utilisateur et un mot de passe.
Si vous indiquez une valeur pour la propriété d'ID utilisateur vous devez également indiquer une valeur pour la propriété de mot de passe.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Confirmation du mot de passe
Confirme le mot de passe.
Gestionnaire de files d'attente
Nom du gestionnaire de files d'attente IBM MQ pour cette usine de connexion. Les connexions créées par cette fabrique de connexions se connectent à ce gestionnaire de files d'attente.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Entrez les informations sur le port et le nom d'hôte
Ce bouton radio est sélectionné par défaut et s'il est sélectionné, il active les propriétés d'hôte et de port et désactive la propriété de liste de noms de connexion.
Information | valeur |
---|---|
Type de données | Bouton radio |
Valeut par défaut | Sélectionnés |
Hôte
Nom de l'hôte sur lequel le gestionnaire de files d'attente IBM MQ est exécuté pour les connexions client uniquement.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Intervalle | 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 IBM MQ, pour les connexions client uniquement.
Ce port doit être configuré sur le gestionnaire de files d'attente IBM MQ.
Information | valeur |
---|---|
Type de données | Entierr |
Intervalle | Numéro de port TCP/IP valide, configuré sur le gestionnaire de files d'attente IBM MQ. |
Entrez les informations sur la liste de noms de connexion
La sélection de ce bouton radio 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. Sélectionnez ce bouton radio pour vous connecter à un gestionnaire de files d'attente multi-instance.
Information | valeur |
---|---|
Type de données | Bouton radio |
Valeut par défaut | Elément non sélectionné |
Liste de noms de connexion
Liste séparée par des virgules d'informations d'hôte et de port pouvant être utilisée pour se connecter à un gestionnaire de files d'attente multi-instance.
host[(port)],[host[(port)]]
où port est facultatif et prend la valeur par défaut 1414 s'il n'est pas défini. Par
exemple :hostname1,hostname2(1415)
Pour plus d'informations sur les gestionnaires de files d'attente multi-instances, voir le centre de documentation IBM MQ.
Cette propriété ne doit être utilisée que pour la connexion à un gestionnaire de files d'attente multi-instance. Elle ne doit pas être employée pour la connexion à une liste de gestionnaires de files d'attente distincts car cela peut entraîner des problèmes d'intégrité des transactions.
Canal
Nom du canal utilisé pour les connexions client au gestionnaire de files d'attente IBM MQ, pour les connexions client uniquement.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Intervalle | 1 à 20 caractères ASCII |
Type de transport
Indique si la connexion client IBM MQ ou les liaisons JNDI sont utilisées pour le gestionnaire de files d'attente IBM MQ.
Information | valeur |
---|---|
Type de données | Enum |
Valeut par défaut | BINDINGS |
Intervalle |
|
ID client
Identificateur de client JMS utilisé pour les connexions au gestionnaire de files d'attente IBM MQ.
Information | valeur |
---|---|
Type de données | String (chaîne) |
CCSID
ID de jeu de caractères codés à utiliser avec le gestionnaire de files d'attente IBM MQ.
L'ID de jeu de caractères codés doit correspondre à l'une des valeurs prises en charge par IBM MQ. Pour plus de détails, voir les propriétés de la destination de rubrique.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Unité | Entierr |
Intervalle | 1 à 65535 |
File de contrôle du courtier
Nom de la file de contrôle du courtier dans laquelle tous les messages de commande (sauf les publications et demandes de suppression des publications) sont envoyés.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Unité | Caractères ASCII En_US |
Intervalle | 1 à 48 caractères ASCII |
Gestionnaire de files d'attente du courtier
Nom du gestionnaire de files d'attente IBM MQ fournissant le courtier de messages Publisher et Subscriber.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Unité | Caractères ASCII En_US |
Intervalle | 1 à 48 caractères ASCII |
File d'attente de publication du courtier
Nom de la file d'attente d'entrée du courtier qui reçoit tous les messages de publication pour le flux par défaut.
Nom de la file d'attente en entrée du courtier (file d'attente du flux), qui reçoit tous les messages de publication pour le flux par défaut. Les applications peuvent également envoyer des demandes de suppression de publications du flux par défaut dans cette file d'attente.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Unité | Caractères ASCII En_US |
Intervalle | 1 à 48 caractères ASCII |
File d'abonnement du courtier
Nom de la file d'attente du courtier d'où sont extraits les messages d'abonnement non durable.
Nom de la file d'attente du courtier d'où sont extraits les messages d'abonnement non durable. L'abonné spécifie le nom de la file d'attente lorsqu'il s'inscrit pour un abonnement.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Unité | Caractères ASCII En_US |
Intervalle | 1 à 48 caractères ASCII |
CCSubQ du courtier
Nom de la file d'attente du courtier d'où sont extraits les messages d'abonnement non durable pour une demande ConnectionConsumer. Cette propriété s'applique uniquement au conteneur Web.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Unité | Caractères ASCII En_US |
Intervalle | 1 à 48 caractères ASCII |
Version du courtier
Indique si le courtier de messages est fourni par IBM MQ MA0C SupportPac ou les dernières versions de produits de courtier de messages WebSphere.
Information | valeur |
---|---|
Type de données | Enum |
Valeut par défaut | Avancé |
Intervalle |
|
Niveau de nettoyage
Niveau de nettoyage fourni par l'utilitaire de nettoyage de publication et de souscription.
Information | valeur |
---|---|
Type de données | Enum |
Valeut par défaut | SAFE |
Intervalle |
|
Intervalle entre les nettoyages
Exprimé en millisecondes, intervalle entre des exécutions en arrière-plan de l'utilitaire de nettoyage de publication/abonnement.
Information | valeur |
---|---|
Type de données | Entierr |
Unité | Millisecondes |
Valeut par défaut | 6000 |
Sélection des messages
Indique l'emplacement de sélection des messages du courtier.
Information | valeur |
---|---|
Type de données | Enum |
Valeut par défaut | BROKER |
Intervalle |
|
Intervalle de publication et de reconnaissance
L'intervalle, en nombre de messages, entre les requêtes de publication nécessitant un accusé de réception du courtier.
Information | valeur |
---|---|
Type de données | Entierr |
Valeut par défaut | 25 |
Abonnements fractionnés
Active les abonnements fractionnés.
Information | valeur |
---|---|
Type de données | Case à cocher |
Valeut par défaut | Elément non sélectionné |
Intervalle de régénération des états
Intervalle, en millisecondes, entre les transactions pour actualiser le statut de publication et de souscription.
Information | valeur |
---|---|
Type de données | Entierr |
Valeut par défaut | 6000 |
Stockage des abonnements
Où IBM MQ stocke les données relatives aux abonnements JMS actifs.
Information | valeur |
---|---|
Type de données | Enum |
Valeut par défaut | MIGRATE |
Intervalle |
|
Multidiffusion (MULTICAST)
Indique si cette fabrique de connexions utilise le transport de multidiffusion.
Information | valeur |
---|---|
Type de données | Enum |
Valeut par défaut | NON UTILISE |
Intervalle |
|
Authentification directe
Indique s'il est nécessaire d'utiliser l'autorisation du courtier directe.
Information | valeur |
---|---|
Type de données | Enum |
Valeut par défaut | NONE |
Intervalle |
|
Nom d'hôte du proxy
Nom d'hôte d'un proxy à utiliser pour la communication avec IBM MQ.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Port du proxy
Numéro de port d'un proxy à utiliser pour la communication avec IBM MQ.
Information | valeur |
---|---|
Type de données | Entierr |
Valeut par défaut | 0 |
Echec en cas de mise au repos
Indique si des applications sont renvoyées à partir d'un appel de méthode lorsque le gestionnaire de files d'attente a entré un échec contrôlé.
Information | valeur |
---|---|
Type de données | Case à cocher |
Valeut par défaut | Sélectionnés |
Adresse du serveur local
Adresse du serveur local.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Intervalle d'interrogation
Indique l'intervalle, en millisecondes, entre les analyses de tous les destinataires lors de la distribution de messages asynchrones.
Information | valeur |
---|---|
Type de données | Entierr |
Unité | Millisecondes |
Valeut par défaut | 5000 |
Intervalle de rescannage
Exprimé en millisecondes, intervalle lors duquel un sujet est analysé pour rechercher des messages ajoutés à un sujet exclu.
L'intervalle de rescannage contrôle l'analyse des messages ajoutés à une rubrique dans un ordre incorrect en respectant le curseur IBM MQ.
Information | valeur |
---|---|
Type de données | Entierr |
Unité | Millisecondes |
Valeut par défaut | 5000 |
Algorithme de chiffrement SSL
Algorithme de cryptographie à utiliser pour une connexion SSL à IBM MQ.
Attribuez un algorithme de chiffrement valide proposé par votre fournisseur JSSE à cette propriété. La valeur doit correspondre à l'élément CipherSpec indiqué sur le canal SVRCONN en tant que propriété Channel.
Vous devez définir cette propriété si vous définissez la propriété Nom de l'homologue SSL.
Magasin de certificats SSL
Indique une liste contenant de zéro à plusieurs serveurs CRL (Certificate Revocation List) utilisés pour vérifier le retrait de certificats SSL. If you specify a value for this property, you must use IBM MQ JVM at Java 2 version 1.4.
ldap://hostname:[port]
Une barre oblique (/) apparaît après cette valeur. Si port n'est pas spécifié, le port LDAP par défaut (le port 389) est utilisé. Au moment de la connexion, le certificat SSL présenté par le serveur est comparé à ceux stockés sur les serveurs CRL spécifiés. Pour plus d'informations sur la sécurité CRL, voir les informations concernant "Working with Certificate Revocation Lists" dans la section sur la Sécurité du centre de documentation IBM MQ.
Nom de l'homologue SSL
Pour SSL, un squelette de nom distinctif devant correspondre au nom fourni par le gestionnaire de files d'attente IBM MQ. Le nom distinctif permet de vérifier le certificat d'identification présenté par le serveur lors de la connexion.
Lorsque cette propriété n'est pas définie, une telle vérification de certificat est effectuée.
La propriété de nom d'homologue SSL est ignorée si la propriété Algorithme de chiffrement SSL n'est pas spécifiée.
CN=QMGR.*, OU=IBM, OU=WEBSPHERE
L'exemple indiqué vérifie le certificat d'identification présenté par le serveur lors de la connexion. Pour que la connexion aboutisse, le Nom commun du certificat doit commencer par QMGR. et être associé à au moins deux noms d'unité d'organisation (le premier étant IBM® et le second WEBSPHERE). La vérification ne fait pas de distinction entre les majuscules et les minuscules.
Pour plus de détails sur les noms distinctifs et leur utilisation avec IBM MQ, voir les informations sur les "noms distinctifs" dans la section de sécurité du centre de documentation IBM MQ.
Pool de connexions
Ensemble facultatif de paramètres de pool de connexions.
Les propriétés du pool de connexions sont communes à tous les connecteurs J2C.
Le serveur d'applications regroupe les connexions et les sessions dans un pool avec le fournisseur JMS pour optimiser les performances. Ce regroupement de connexion est indépendant de tout regroupement de connexion IBM 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 connexions si l'accès concurrent côté serveur à la ressource JMS dépasse la valeur par défaut. La taille du pool de connexions est définie sur la base d'une file d'attente ou d'u sujet individuel.
Information | valeur |
---|---|
Type de données | Case à cocher |
Valeut par défaut | Sélectionnés |
Options de reconnexion client
Indique si une connexion en mode client se reconnecte automatiquement ou non en cas d'échec d'un gestionnaire de files d'attente ou de communications. Cette propriété est ignorée, sauf si la fabrique de connexions est utilisée dans un environnement client léger ou géré.
Information | valeur |
---|---|
Type de données | Liste déroulante |
Valeut par défaut | DESACTIVE |
Intervalle |
|
Pour plus d'informations sur la reconnexion client automatique, voir le centre de documentation IBM MQ.
Délai de reconnexion du client
Durée maximale, exprimée en nombre de secondes, pendant laquelle une connexion en mode client tente de se reconnecter automatiquement à un gestionnaire de files d'attente après l'échec de ce dernier ou une défaillance des communications. Ce paramètre est ignoré sauf si la fabrique de connexions est utilisée dans un environnement client géré ou léger. L'utilisation de ce paramètre est déterminée par la valeur du paramètre des options de reconnexion du client.
Information | valeur |
---|---|
Type de données | Entierr |
Unité | Valeur par défaut |
Valeut par défaut | 1800 |
Intervalle | Valeur supérieure à zéro égale à 2147483647 au maximum |
Pour plus d'informations sur la reconnexion client automatique, voir le centre de documentation IBM MQ.