Fabrique de connexions JMS (jmsConnectionFactory)
Définit une configuration de fabrique de connexions JMS.
| Nom de l'attribut | Type de données | Valeur par défaut | Description |
|---|---|---|---|
| connectionManagerRef | Référence à l'élément connectionManager de niveau supérieur (string) | Gestionnaire de connexions d'une fabrique de connexions. | |
| containerAuthDataRef | Référence à l'élément authData de niveau supérieur (string) | Données d'authentification par défaut pour l'authentification gérée par conteneur qui s'appliquent lorsque les liaisons ne spécifient pas d'alias d'authentification pour une référence de ressource avec res-auth=CONTAINER. | |
| id | chaîne | ID de configuration unique. | |
| jndiName | chaîne | Nom JNDI d'une ressource. | |
| recoveryAuthDataRef | Référence à l'élément authData de niveau supérieur (string) | Données d'authentification pour la récupération des transactions. |
- connectionManager
Description : Gestionnaire de connexions d'une fabrique de connexions.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description agedTimeout Période avec une précision à la seconde -1 Délai avant qu'une connexion physique ne soit supprimée par la maintenance du pool. La valeur -1 désactive ce délai. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes. connectionTimeout Période avec une précision à la seconde 30s Délai à l'issue duquel une demande de connexion expire si elle n'est toujours pas satisfaite. La valeur -1 désactive ce délai. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes. maxConnectionsPerThread Entier Minimum : 0
Limite le nombre de connexions ouvertes sur chaque unité d'exécution. maxIdleTime Période avec une précision à la seconde 30m Durée à l'issue de laquelle une connexion inutilisée ou au repos peut être supprimée durant la maintenance du pool, à condition que cette suppression ne fasse pas tomber le pool en-deçà de sa taille minimale. La valeur -1 désactive ce délai. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes. maxPoolSize Entier Minimum : 0
50 Nombre maximal de connexions physiques pour un pool. La valeur 0 indique qu'il n'existe aucune limite. minPoolSize Entier Minimum : 0
Nombre minimal de connexions physiques à maintenir dans le pool. Le pool n'est pas prérempli. Le délai d'ancienneté est prioritaire et peut donc faire tomber le nombre de connexions en-deçà de ce minimum. numConnectionsPerThreadLocal Entier Minimum : 0
Place en cache le nombre de connexions défini pour chaque unité d'exécution. purgePolicy - ValidateAllConnections
- FailingConnectionOnly
- Totalité du pool
Totalité du pool Indique quelles connexions détruire lorsqu'une connexion périmée est détectée dans un pool. - ValidateAllConnections
- Lorsqu'une connexion périmée est détectée, les connexions sont testées et celles qui sont identifiées comme incorrectes ou périmées sont fermées.
- FailingConnectionOnly
- Lorsqu'une connexion périmée est détectée, seule la connexion identifiée comme incorrecte ou périmée est fermée.
- Totalité du pool
- Lorsqu'une connexion périmée est détectée, toutes les connexions du pool sont marquées comme périmées et sont fermées dès qu'elles ne sont plus utilisées.
reapTime Période avec une précision à la seconde 3m Intervalle entre chaque passage de l'unité d'exécution de maintenance du pool. La valeur -1 désactive la maintenance du pool. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
- containerAuthData
Description : Données d'authentification par défaut pour l'authentification gérée par conteneur qui s'appliquent lorsque les liaisons ne spécifient pas d'alias d'authentification pour une référence de ressource avec res-auth=CONTAINER.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description password Mot de passe codé réversible (chaîne) Mot de passe de l'utilisateur à employer lors de la connexion à un système EIS. La valeur peut être stockée en clair ou sous forme encodée. Il est recommandé d'encoder le mot de passe. Pour cela, utilisez l'outil securityUtility avec l'option encode. user chaîne Nom d'utilisateur à employer lors de la connexion à un système EIS.
- properties.wasJms
Description : Une fabrique de connexions JMS permet de créer des connexions au fournisseur JMS de destinations JMS associé, pour la messagerie point-à-point et la messagerie de publication/abonnement.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description busName chaîne defaultBus Nom d'un bus lors de la connexion au bus d'intégration de services sur un serveur de profil complet. clientID chaîne clientID Identificateur client JMS requis pour l'abonnement durable aux sujets (et non durable partagé) sur toutes les connexions. Cet identificateur est requis si l'application effectue des opérations de messagerie durable (et non durable partagée) de publication/abonnement. durableSubscriptionHome chaîne defaultME Cette page d'accueil définit le nom ME avec lequel la connexion doit être établie. nonPersistentMapping - BestEffortNonPersistent
- ReliableNonPersistent
- ExpressNonPersistent
ExpressNonPersistent Fiabilité appliquée aux messages JMS non persistants envoyés à l'aide de cette fabrique de connexions. - BestEffortNonPersistent
- BestEffortNonPersistent
- ReliableNonPersistent
- ReliableNonPersistent
- ExpressNonPersistent
- ExpressNonPersistent
password Mot de passe codé réversible (chaîne) Il est recommandé d'utiliser un alias d'authentification géré par conteneur plutôt que de configurer cette propriété. persistentMapping - AssuredPersistent
- ReliablePersistent
ReliablePersistent Fiabilité appliquée aux messages JMS persistants envoyés à l'aide de cette fabrique de connexions. - AssuredPersistent
- AssuredPersistent
- ReliablePersistent
- ReliablePersistent
readAhead - AlwaysOff
- Par défaut
- AlwaysOn
Par défaut La lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Elle traite les demandes des consommateurs plus rapidement. - AlwaysOff
- AlwaysOff
- Par défaut
- Par défaut
- AlwaysOn
- AlwaysOn
remoteServerAddress chaîne L'adresse du serveur distant est composée de trois noeuds finaux séparés par une virgule, avec la syntaxe nomHôte:numéroPort:nomChaîne, et est utilisée pour la connexion à un serveur d'amorce. Exemple : Merlin:7276:BootstrapBasicMessaging. Si le nom d'hôte n'est pas spécifié, la valeur par défaut est le système hôte local. Si le numéro de port n'est pas spécifié, la valeur par défaut est 7276. Si le nom de chaîne n'est pas spécifié, la valeur pas défaut est BootstrapBasicMessaging. Consultez le centre de documentation pour plus d'informations. shareDurableSubscription chaîne Détermine si les abonnements durables peuvent être partagés sur des connexions, ou non. targetTransportChain chaîne Les chaînes de transport indiquent les protocoles de communication qui peuvent être utilisés pour communiquer avec le bus d'intégration de services sur un serveur de profils complets. temporaryQueueNamePrefix chaîne temp Préfixe, composé au maximum de douze caractères, utilisé dans les files d'attente temporaires créées par les applications utilisant cette fabrique de connexions de file d'attente. temporaryTopicNamePrefix chaîne temp Préfixe, composé au maximum de douze caractères, utilisé pour les sujets temporaires créés par les applications qui utilisent cette fabrique de connexions de rubriques. userName chaîne Il est recommandé d'utiliser un alias d'authentification géré par conteneur plutôt que de configurer cette propriété.
- properties.wmqJms
Description : Fabrique de connexion JMS WebSphere MQObligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description CCSID Entier Minimum : 1
819 Identificateur de jeu de caractères codés pour une connexion. applicationName chaîne Nom sous lequel une application est enregistrée auprès du gestionnaire de files d'attente. arbitraryProperties chaîne Permet de spécifier des propriétés non définies ailleurs. brokerCCSubQueue chaîne Nom de la file d'attente à partir de laquelle un consommateur de connexion reçoit des messages d'abonnement non durable brokerControlQueue chaîne Nom de la file d'attente de contrôle du courtier brokerPubQueue chaîne Nom de la file d'attente vers laquelle les messages publiés sont envoyés (file d'attente de flux) brokerQueueManager chaîne Nom du gestionnaire de files d'attente dans lequel le courtier s'exécute brokerSubQueue chaîne Nom de la file d'attente depuis laquelle un consommateur de message non durable reçoit des messages brokerVersion - 2
- 1
Version du courtier utilisé - 2
- 2
- 1
- 1
ccdtURL chaîne Adresse URL qui identifie le nom et l'emplacement du fichier contenant la table de définition de canal du client (CCDT) et qui spécifie la façon dont le fichier est accessible. channel chaîne Nom du canal MQI à utiliser. cleanupInterval Période avec une précision à la milliseconde près Intervalle, en millisecondes, entre les exécutions en arrière-plan de l'utilitaire de nettoyage des publications/abonnements. Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie. cleanupLevel - SAFE
- FORCE
- NONDUR
- AUCUNE
- STRONG
SAFE Niveau de nettoyage pour un magasin d'abonnement reposant sur un courtier. - SAFE
- SAFE
- FORCE
- FORCE
- NONDUR
- NONDUR
- AUCUNE
- AUCUNE
- STRONG
- STRONG
clientId chaîne Identificateur client pour une connexion cloneSupport - ACTIVE
- DISABLED
DISABLED Indique si plusieurs instances du même abonné aux sujets durables peuvent être exécutées simultanément. - ACTIVE
- ACTIVE
- DISABLED
- DISABLED
connectionNameList chaîne Liste des noms de connexion TCP/IP (nomHôte(port)) utilisés pour les communications. ConnectionNameList remplace les propriétés de nom d'hôte et de port. failIfQuiesce Booléen true Indique si des appels à certaines méthodes échouent si le gestionnaire de files d'attente se trouve à l'état de repos. headerCompression - SYSTEM
- AUCUNE
AUCUNE Liste des techniques pouvant être utilisées pour la compression des données d'en-tête pour une connexion - SYSTEM
- SYSTEM
- AUCUNE
- AUCUNE
hostName chaîne Nom d'hôte ou adresse IP du système sur lequel se trouve le gestionnaire de files d'attente. Les propriétés de nom d'hôte et de port sont remplacées par la propriété ConnectionNameList lorsqu'elle est spécifiée. localAddress chaîne Pour une connexion à un gestionnaire de files d'attente, cette propriété spécifie 1) l'interface de réseau local à utiliser, 2) le port local ou une plage de ports locaux à utiliser, ou les deux messageCompression - RLE
- AUCUNE
AUCUNE Liste des techniques pouvant être utilisées pour la compression des données de message pour une connexion - RLE
- RLE
- AUCUNE
- AUCUNE
messageSelection - CLIENT
- BROKER
CLIENT Détermine si la sélection des messages est effectuée par WebSphere MQ classes for JMS ou par le courtier. - CLIENT
- CLIENT
- BROKER
- BROKER
password Mot de passe codé réversible (chaîne) Mot de passe par défaut à utiliser lors de la création d'une connexion à un gestionnaire de files d'attente. (Il est recommandé d'utiliser un alias d'authentification géré par conteneur plutôt que de configurer cette propriété.) pollingInterval Période avec une précision à la milliseconde près Lorsque la file d'attente associée aux différents écouteurs de messages au sein d'une session ne contient aucun message approprié, cette valeur est l'intervalle de temps maximal, en millisecondes, qui peut s'écouler avant que chaque écouteur tente à nouveau d'extraire un message de sa file d'attente. Si l'absence de message approprié est fréquemment observée pour l'un quelconque des écouteurs de messages au sein d'une session, il y aura lieu d'envisager l'entrée d'une valeur plus élevée pour cette propriété. Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie. port Entier Minimum : 1
1414 Port sur lequel le gestionnaire de files d'attente est à l'écoute. Les propriétés de nom d'hôte et de port sont remplacées par la propriété ConnectionNameList lorsqu'elle est spécifiée. providerVersion - 7
- 6
- unspecified
unspecified Version, édition, niveau de modification et groupe de correctifs du gestionnaire de files d'attente auquel l'application a l'intention de se connecter. - 7
- 7
- 6
- 6
- unspecified
- unspecified
pubAckInterval Entier Minimum : 0
25 Nombre de messages publiés par un éditeur avant que WebSphere MQ classes for JMS demande un accusé de réception au courtier queueManager chaîne Nom du gestionnaire de files d'attente auquel se connecter receiveExit chaîne Identifie un programme d'exit de réception de canal ou une séquence de programmes d'exit de réception de canal à exécuter à la suite receiveExitInit chaîne Données utilisateur transmises aux programmes d'exit de réception de canal lorsqu'ils sont appelés rescanInterval Période avec une précision à la milliseconde près 5s Lorsqu'un consommateur de messages du domaine point-to-point utilise un sélecteur de messages pour choisir les messages qu'il veut recevoir, WebSphere MQ classes for JMS recherche les messages appropriés dans la file d'attente WebSphere MQ selon l'ordre déterminé par l'attribut MsgDeliverySequence de la file d'attente. Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie. securityExit chaîne Identifie un programme d'exit de sécurité de canal securityExitInit chaîne Données utilisateur transmises aux programmes d'exit de sécurité de canal lorsqu'ils sont appelés sendCheckCount Entier Minimum : 0
Nombre d'appels d'émission à autoriser entre les recherches d'erreurs d'insertion asynchrone, dans une session JMS non transactionnelle unique. sendExit chaîne Identifie un programme d'exit d'émission de canal ou une séquence de programmes d'exit d'émission à exécuter à la suite. sendExitInit chaîne Données utilisateur transmises aux programmes d'exit d'émission de canal lorsqu'ils sont appelés. shareConvAllowed Booléen true Indique si un client peut partager son socket avec d'autres connexions JMS de niveau supérieur à partir du même processus dans le même gestionnaire de files d'attente, si les définitions de canal correspondent sparseSubscriptions Booléen false Contrôle les stratégies d'extraction de messages d'un objet TopicSubscriber. sslCertStores chaîne Serveurs LDAP (Lightweight Directory Access Protocol) détenant des listes de révocation de certificat à utiliser sur une connexion SSL. sslCipherSuite chaîne Algorithme de chiffrement à utiliser pour une connexion SSL. sslFipsRequired Booléen Indique si une connexion SSL doit utiliser un algorithme pris en charge par le fournisseur IBM Java JSSE FIPS (IBMJSSEFIPS). sslPeerName chaîne Pour une connexion SSL, modèle qui est utilisé pour vérifier le nom distinctif dans le certificat numérique fourni par le gestionnaire de files d'attente. sslResetCount Entier Minimum : 0
Maximum : 999999999
0 Nombre total d'octets envoyés et reçus par une connexion SSL avant que les clés confidentielles utilisées par SSL ne soient renégociées. statusRefreshInterval Période avec une précision à la milliseconde près 1m Intervalle de temps, en millisecondes, entre les réactualisations de la transaction de longue durée détectant les pertes de connexion d'un abonné au gestionnaire de files d'attente. Cette propriété n'est pertinente que si le magasin d'abonnement n'est associé à la valeur QUEUE. Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie. subscriptionStore - MIGRATE
- BROKER
- FILE
BROKER Détermine l'emplacement où WebSphere MQ classes for JMS enregistre les données persistantes relatives aux abonnements actifs. - MIGRATE
- MIGRATE
- BROKER
- BROKER
- FILE
- FILE
targetClientMatching Booléen true Indique si un message de réponse envoyé à la file d'attente identifiée par la zone d'en-têteJMSReplyTo d'un message entrant possède un en-tête MQRFH2 uniquement si le message entrant possède un en-tête MQRFH2. tempQPrefix chaîne Préfixe utilisé pour former le nom d'une file d'attente WebSphere MQ dynamique. tempTopicPrefix chaîne Lors de la création de rubriques temporaires, JMS génère une chaîne de rubrique au format TEMP/TEMPTOPICPREFIX/id_unique, ou simplement TEMP/id_unique si la valeur par défaut de la propriété est utilisée. La spécification d'un paramètre TEMPTOPICPREFIX non vide permet de définir des files d'attente modèle spécifiques en vue de la création de files d'attente gérées pour les abonnés à des rubriques temporaires créées sous cette connexion. temporaryModel chaîne Nom de la file d'attente modèle à partir de laquelle les files d'attente temporaires JMS sont créées. SYSTEM.JMS.TEMPQ.MODEL peut être utilisé par la couche JMS pour créer des files d'attente qui acceptent les messages persistants, à la place de la valeur par défaut, qui ne les accepte pas. SYSTEM.DEFAULT.MODEL.QUEUE ne peut être ouverte qu'une fois. SYSTEM.JMS.TEMPQ.MODEL peut être ouverte plusieurs fois. SYSTEM.DEFAULT.MODEL.QUEUE est dépréciée. transportType - CLIENT
- BINDINGS
CLIENT Indique si une connexion à un gestionnaire de files d'attente utilise le mode client ou le mode liaison. - CLIENT
- CLIENT
- BINDINGS
- BINDINGS
userName chaîne Nom d'utilisateur par défaut à utiliser lors de la création d'une connexion à un gestionnaire de files d'attente. (Il est recommandé d'utiliser un alias d'authentification géré par conteneur plutôt que de configurer cette propriété.) wildcardFormat - CHAR
- TOPIC
TOPIC Version de la syntaxe générique à utiliser. - CHAR
- CHAR
- TOPIC
- TOPIC
- recoveryAuthData
Description : Données d'authentification pour la récupération des transactions.Obligatoire : falseType de données Nom de l'attribut Type de données Valeur par défaut Description password Mot de passe codé réversible (chaîne) Mot de passe de l'utilisateur à employer lors de la connexion à un système EIS. La valeur peut être stockée en clair ou sous forme encodée. Il est recommandé d'encoder le mot de passe. Pour cela, utilisez l'outil securityUtility avec l'option encode. user chaîne Nom d'utilisateur à employer lors de la connexion à un système EIS.
Rubrique de référence