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.

Remarque :
  • 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.
Courtier MA0C : lors de la création d'une usine de connexion de rubrique WebSphere Application Server Version 6 pour le courtier MA0C, considérez les valeurs d'attributs suivantes :
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.

Le format de la liste est :
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
CLIENT
IBM MQ client connection is used to connect to the IBM MQ queue manager.
BINDINGS
Les liaisons JNDI sont utilisées pour la connexion au gestionnaire de files d'attente IBM MQ.

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
Avancé
Le courtier de messages est fourni par les dernières versions des produits WebSphere (IBM MQ Integrator et IBM MQ Publish and Subscribe).
De base
Le courtier de messages est fourni par IBM MQ MA0C SupportPac (IBM MQ - Publish and Subscribe).

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
ASPROP
NONE
STRONG

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
BROKER
La sélection des messages est effectuée au niveau du courtier.
CLIENT message
La sélection des messages est effectuée au niveau du client.

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

IBM MQ stocke les données relatives aux abonnements JMS actifs.

Information valeur
Type de données Enum
Valeut par défaut MIGRATE
Intervalle
MIGRATE
QUEUE
BROKER

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
NON UTILISE
Cette fabrique de connexions n'utilise pas le transport multidiffusion.
ACTIVE
Cette fabrique de connexions utilise toujours le transport multidiffusion.
ACTIVE_SI_DISPONIBLE
Cette fabrique de connexions utilise toujours le transport multidiffusion.
ACTIVE_FIABLE
Cette fabrique de connexions utilise le transport multidiffusion fiable.
ACTIVE_FIABLE_SI_DISPONIBLE
Cette fabrique de connexions utilise le transport multidiffusion fiable si ce dernier est disponible.

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
AUCUNE
L'autorisation de courtier directe n'est pas utilisée.
MOT DE PASSE
L'autorisation de courtier directe est authentifiée avec un mot de passe.
CERTIFICAT
L'autorisation de courtier directe est authentifiée avec un certificat.

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.

La valeur est une liste d'entrées séparées par un espace au format suivant :
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.

Cette propriété est une liste de paires nom d'attribut et valeur. Chaque élément de la liste est séparée par une virgule ou un point-virgule. Exemple :
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
DESACTIVE
La reconnexion du client n'a pas lieu automatiquement.
ASDEF
La valeur de l'attribut DefRecon des sections de canaux du fichier de configuration client est utilisée. Si aucune valeur n'est spécifiée pour DefRecon, ce paramètre a le même effet que la valeur DISABLED.
RECONNECT
La reconnexion a lieu pour tout gestionnaire de files d'attente cohérent avec la valeur de l'attribut de gestionnaire de files d'attente, qui peut être un gestionnaire de files d'attente autre que celui de la connexion d'origine.
QMGR
La reconnexion a lieu uniquement au gestionnaire de files d'attente de la connexion d'origine.

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.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ucli_ptcfm
Nom du fichier : ucli_ptcfm.html