IBM MQ Provider queue 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 files d'attentes 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 Ouvrir. Développez le fichier JAR sélectionné, puis cliquez sur . Cliquez avec le bouton droit de la souris sur Fabriques de connexions de file d'attente puis cliquez sur Nouveau. Les zones ci-dessous sont affichées dans la page Général.
. Recherchez un fichier EAR et cliquez sur- 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 de IBM MQ pour les ressources JMS, voir la section relative à l'utilisation de 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.
La fabrique de connexions de file d'attente du fournisseur JMS possède les propriétés suivantes :
Chaîne
Nom sous lequel la fabrique de connexions de file d'attente est connue pour l'administration dans WebSphere Application Server. Ce nom doit être unique dans les fabriques de connexions JMS au sein du domaine d'administration WebSphere.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Description
Description de cette fabrique de connexions dans WebSphere Application Server à des fins d'administration.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Valeut par défaut | Null |
Nom JNDI
L'environnement d'exécution du client d'application utilise cette zone pour extraire les informations de configuration.
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 createQueueConnection(). 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) |
Valeut par défaut | Null |
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 permettent la liaison avec 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 la connexion client uniquement.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Valeut par défaut | Null |
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 |
Valeut par défaut | Null |
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 la connexion au gestionnaire de files d'attente IBM MQ, pour les connexions client uniquement.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Valeut par défaut | Null |
Intervalle | 1 à 20 caractères ASCII |
Type de transport
Indique si la connexion client IBM MQ ou les liaisons JNDI sont utilisées pour la connexion au gestionnaire de files d'attente IBM MQ. Le fournisseur JMS externe contrôle les protocoles de communication entre les clients JMS et les serveurs JMS. Adaptez le type de transport lorsque vous utilisez une messagerie non ASF, non persistante, non durable et non transactionnelle ou lorsque vous souhaitez résoudre les problèmes de sécurité et que le client est configuré en local par rapport du gestionnaire de files d'attente.
Information | valeur |
---|---|
Type de données | Enum |
Unité | Non applicable |
Valeut par défaut | BINDINGS |
Intervalle |
|
Recommandé |
Remarque : IBM MQ 5.3
JMS ne peut pas être utilisé dans WebSphere
Application Server Version 6.1 car WebSphere
Application Server Version 6.1 a une exécution
Java 5. Par conséquent, les connexions intermémoire ne peuvent pas être établies avec des gestionnaires de file d'attente IBM MQ 5.3. Ceci peut entraîner une baisse des performances si vous utilisiez
précédemment IBM MQ 5.3
et le protocole BINDINGS pour vos connexions et que vous passez à des connexions réseau CLIENT en migrant vers WebSphere
Application Server Version
6.1.
![]() |
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.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Pour plus d'informations sur les CCSID pris en charge et sur la conversion des données de messages d'un jeu de caractères codés vers un autre, voir les sections System Administration et Application Programming Reference du centre de documentation IBM MQ.
Conservation des messages
Select this check box to specify that unwanted messages are to remain on the queue. Sinon, les messages non voulus sont gérés selon les options définies pour leur suppression.
Information | valeur |
---|---|
Type de données | Enum |
Unité | Non applicable |
Valeut par défaut | Elément non sélectionné |
Intervalle |
|
Modèle temporaire
Nom de la définition de modèle permettant de créer des fabriques de connexions temporaires s'il n'existe aucune fabrique de connexions.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Intervalle | 1 à 48 caractères ASCII |
Préfixe de file d'attente temporaire
Préfixe utilisé lors de l'attribution d'un nom à la file d'attente dynamique.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Echec en cas de mise au repos
Indique si des applications sont renvoyées à partir d'un appel de méthode si 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
Indique l'adresse du serveur local.
Information | valeur |
---|---|
Type de données | String (chaîne) |
Intervalle d'interrogation
Indique l'intervalle, en millisecondes, entre l'analyse 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
Indique l'intervalle en millisecondes pendant lequel le système analyse un sujet pour rechercher les messages ajoutés dans un ordre incorrect.
Cet intervalle 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
Spécifie l'algorithme de cryptographie à utiliser pour une connexion SSL à IBM MQ.
Attribuez un algorithme de chiffrement valide proposé par votre fournisseur JSSE à cette propriété. The value must match the CipherSpec specified on the SVRCONN channel as the Channel property.
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" du centre de documentation IBM MQ.
Pool de connexions
Indique un 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.