jmsActivationSpec - Spécification d'activation JMS (jmsActivationSpec)

Définit une configuration de spécification d'activation JMS.

NameTypeDefaultDescription
idstringID de configuration unique.
authDataRefRéférence à lélément {0} de niveau supérieur (chaîne).Données d'authentification par défaut pour une spécification d'activation.
maxEndpointsint
Min: 0
500Nombre maximal de noeuds finaux auxquels les messages sont distribués.
autoStartbooleantruePermet de configurer le démarrage automatique des noeuds finaux de message associés à cette spécification d'activation ou leur démarrage manuel à l'aide de la commande de reprise.

authData

Données d'authentification par défaut pour une spécification d'activation.

NameTypeDefaultDescription
userstringNom d'utilisateur à employer lors de la connexion à un système d'information d'entreprise.
passwordMot de passe codé réversible (chaîne)Mot de passe de l'utilisateur à employer lors de la connexion à un système d'information d'entreprise. La valeur peut être enregistrée en texte clair ou sous forme codée. Il est recommandé d'encoder le mot de passe. Pour cela, utilisez l'outil securityUtility avec l'option encode.

properties.wasJms

Une spécification d'activation JMS est associée à un ou plusieurs beans gérés par message et offre la configuration permettant de recevoir des messages.

NameTypeDefaultDescription
acknowledgeMode
  • Auto-acknowledge
  • Dups-ok-acknowledge
Auto-acknowledgeLe mode d'identification indique comment l'accusé de réception d'un message reçu par un bean géré par message doit être effectué.
Auto-acknowledge
Auto-acknowledge
Dups-ok-acknowledge
Dups-ok-acknowledge
busNamestringdefaultBusNom d'un bus pour la connexion à un bus d'intégration de services dans un serveur de profils complets
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.QueueType de destination, javax.jms.Queue ou javax.jms.Topic.
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
maxConcurrencyint
Min: 1

Max: 2147483647
5Nombre maximal de noeuds finaux auxquels les messages sont distribués simultanément. L'augmentation du nombre peut améliorer les performances, mais elle accroît aussi le nombre d'unités d'exécution qui sont utilisées à l'heure spécifiée. Si l'ordre des messages doit être conservé pour toutes les livraisons ayant échoué, définissez la valeur maximale des noeuds finaux simultanés sur 1.
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
DefaultLa lecture anticipée est une optimisation qui attribue par avance des messages aux destinataires. Ceci permet de traiter les demandes des consommateurs plus rapidement.
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
retryIntervalPériode avec une précision à la seconde près30sLe délai (en secondes) entre deux tentatives de connexion à un moteur de messagerie, pour la connexion initiale et pour toute les tentatives ultérieures d'établir une meilleure connexion. 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.
subscriptionDurability
  • NonDurableShared
  • Durable
  • DurableShared
  • NonDurable
NonDurableType d'abonnement au sujet MS. Sa valeur peut être l'une des suivantes : : Durable DurableShared NonDurable NonDurableShared
NonDurableShared
NonDurableShared
Durable
Durable
DurableShared
DurableShared
NonDurable
NonDurable
targetTransportChain
  • InboundBasicMessaging
  • InboundSecureMessaging
InboundBasicMessagingLes chaînes de transport indiquent les protocoles de communication qui peuvent être utilisés pour communiquer avec le bus d'intégration de services dans un serveur de profils complets.
InboundBasicMessaging
InboundBasicMessaging
InboundSecureMessaging
InboundSecureMessaging
clientIdstringIdentificateur 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.
connectionFactoryLookupstringCette propriété peut être utilisée pour indiquer le nom de recherche d'un objet javax.jms.ConnectionFactory, javax.jms.QueueConnectionFactory ou javax.jms.TopicConnectionFactory défini administrativement et utilisé pour la connexion au fournisseur JMS à partir duquel le noeud final (bean géré par message) peut recevoir des messages.
destinationstringRéférence à une file d'attente JMS
destinationLookupstringCette propriété peut être utilisée pour indiquer le nom de recherche des objets javax.jms.Queue ou javax.jms.Topic qui définissent la file d'attente ou le sujet JMS à partir duquel le noeud final (bean géré par message) peut recevoir des messages.
destinationRefRéférence à lélément {0} de niveau supérieur (chaîne).Référence à une file d'attente JMS
maxBatchSizeint
Min: 1

Max: 2147483647
Nombre maximal de messages reçus par le moteur de messagerie dans un seul lot.
messageSelectorstringSélecteur de message JMS permettant de déterminer quels sont les messages reçus par le bean géré par message. La valeur correspond à une chaîne permettant de sélectionner un sous-ensemble de messages disponibles.
remoteServerAddressstringAdresse 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, utilisée pour la connexion à un serveur d'amorçage. Par 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 par défaut est BootstrapBasicMessaging. Reportez-vous au centre de documentation pour plus d'informations.
shareDurableSubscriptionstringPermet de définir si un abonnement durable ou non peut être partagé entre des connexions.
subscriptionNamestringNom d'abonnement requis pour abonnement durable (et non durable partagé). Zone requise lors de l'utilisation d'un abonnement durable à un sujet (et non durable partagé). Ce nom d'abonnement doit être unique dans l'identificateur client concerné.

properties.wmqJms

Spécification d'activation de JMS dans WebSphere MQ

NameTypeDefaultDescription
destinationRefRéférence à lélément {0} de niveau supérieur (chaîne).Destination
CCSIDint
Min: 1
819Identificateur de jeu de caractères codés pour une connexion.
channelstringSYSTEM.DEF.SVRCONNNom du canal MQI à utiliser.
cloneSupport
  • DISABLED
  • ENABLED
DISABLEDIndique si deux instances ou plus d'un même abonné durable au sujet peuvent s'exécuter simultanément
DISABLED
DISABLED
ENABLED
ENABLED
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.QueueType de destination - javax.jms.Queue ou javax.jms.Topic
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
headerCompression
  • SYSTEM
  • NONE
NONEListe des techniques qui peuvent être utilisées pour compresser les données d'en-tête sur une connexion
SYSTEM
SYSTEM
NONE
NONE
hostNamestringlocalhostNom d'hôte ou adresse IP du système sur lequel réside le gestionnaire de files d'attente. Les propriétés de nom d'hôte et de port sont supplantées par la propriété de liste de nom de connexion lorsque cette dernière est indiquée.
messageCompression
  • RLE
  • NONE
NONEListe des techniques qui peuvent être utilisées pour la compression des données de message sur une connexion
RLE
RLE
NONE
NONE
pollingIntervalPériode avec une précision à la milliseconde près5sSi chaque programme d'écoute de message dans une session ne comporte pas de message approprié dans sa file d'attente, cette valeur est l'intervalle de temps maximal, en millisecondes, qui s'écoule avant que chaque programme d'écoute de message essaie à nouveau d'obtenir un message à partir 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é. Cette propriété est appropriée uniquement si TRANSPORT a la valeur BIND ou CLIENT. 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.
poolTimeoutPériode avec une précision à la milliseconde près5mPériode de temps, en millisecondes, pendant laquelle une session inutilisée est maintenue ouverte dans le pool de sessions de serveur avant d'être fermée pour cause d'inactivité. 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.
portint
Min: 1
1414Port d'écoute du gestionnaire de files d'attente. Les propriétés de nom d'hôte et de port sont supplantées par la propriété de liste de nom de connexion lorsque cette dernière est indiquée.
providerVersion
  • unspecified
  • 6
  • 7
unspecifiedVersion, édition, niveau de modification et groupe de correctifs du gestionnaire de files d'attente auquel l'application veut se connecter.
unspecified
unspecified
6
6
7
7
rescanIntervalPériode avec une précision à la milliseconde près5sLorsqu'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. Dès lors qu'il a trouvé un message approprié et l'a distribué au consommateur, il reprend la recherche à partir de sa position en cours dans la file d'attente jusqu'à détection d'un nouveau message répondant aux conditions. WebSphere MQ classes for JMS poursuit la recherche de la même manière jusqu'à ce qu'il atteigne la fin de la file, ou jusqu'à l'expiration de l'intervalle de temps, en millisecondes, déterminé par la valeur de cette propriété. Dans chaque cas, WebSphere MQ classes for JMS reprend la recherche au début de la file d'attente avec initialisation d'un nouvel intervalle de temps. 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.
shareConvAllowedbooleantrueIndique si une connexion client peut partager son socket avec d'autres connexions JMS de niveau supérieur, d'un même processus vers un même gestionnaire de files d'attente, si les définitions de canal correspondent.
startTimeoutPériode avec une précision à la milliseconde près10sConfigure le délai (en millisecondes) dans lequel l'exécution doit démarrer. 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.
transportType
  • BINDINGS
  • CLIENT
CLIENTIndique si une connexion à un gestionnaire de files d'attente utilise un mode client ou un mode liaisons.
BINDINGS
BINDINGS
CLIENT
CLIENT
failIfQuiescebooleantrueIndique si les appels à certaines méthodes échouent si un gestionnaire de files d'attente est à l'état de mise en repos.
maxMessagesint
Min: 0
1Nombre maximal de messages qui peuvent être affectés à une session de serveur à la fois. Si la spécification d'activation distribue des messages à un bean géré par message dans une transaction XA, la valeur 1 est utilisée quel que soit le paramétrage de cette propriété.
maxPoolDepthint
Min: 0
10La propriété maxPoolDepth sur la spécification d'activation définit le nombre d'instances MDB (Message Driven Bean) disponibles. La diminution de la valeur de cette propriété diminue le nombre de messages qui peuvent être livrés simultanément.
messageSelection
  • BROKER
  • CLIENT
CLIENTDétermine si la sélection des messages est effectuée par WebSphere MQ classes for JMS ou par le courtier.
BROKER
BROKER
CLIENT
CLIENT
receiveCCSIDint
Min: 0
0Propriété de destination qui définit l'identificateur du jeu de caractères codés cible pour la conversion des messages du gestionnaire de files d'attente. La valeur est ignorée sauf si RECEIVECONVERSION est défini sur WMQ_RECEIVE_CONVERSION_QMG
receiveConversion
  • QMGR
  • CLIENT_MSG
CLIENT_MSGPropriété de destination qui détermine si la conversion des données sera effectuée par le gestionnaire de files d'attente.
QMGR
QMGR
CLIENT_MSG
CLIENT_MSG
sslResetCountint
Min: 0

Max: 999999999
0Nombre total d'octets envoyés et reçus par une connexion SSL avant que les clés secrètes utilisées par SSL soient renégociées.
cleanupLevel
  • NONDUR
  • FORCE
  • SAFE
  • NONE
  • STRONG
SAFENiveau de nettoyage pour un magasin d'abonnement basé sur un courtier.
NONDUR
NONDUR
FORCE
FORCE
SAFE
SAFE
NONE
NONE
STRONG
STRONG
sparseSubscriptionsbooleanfalseContrôle les stratégies d'extraction de messages pour un objet TopicSubscriber
statusRefreshIntervalPériode avec une précision à la milliseconde près1mIntervalle, en millisecondes, entre les réactualisation de la transaction de longue durée qui détecte quand un abonné perd sa connexion au gestionnaire de files d'attente. Cette propriété est pertinente uniquement si subscriptionStore a 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
  • BROKER
  • MIGRATE
  • QUEUE
BROKERDétermine l'emplacement où WebSphere MQ classes for JMS enregistre les données persistantes relatives aux abonnements actifs.
BROKER
BROKER
MIGRATE
MIGRATE
QUEUE
QUEUE
wildcardFormat
  • CHAR
  • TOPIC
TOPICIndique la version de la syntaxe de caractère générique à utiliser.
CHAR
CHAR
TOPIC
TOPIC
applicationNamestringNom sous lequel une application est enregistrée auprès du gestionnaire de files d'attente.
ccdtURLstringURL identifiant le nom et l'emplacement du fichier contenant la table de définition du canal client (CCDT) et indiquant le mode d'accès au fichier.
clientIdstringIdentificateur client pour une connexion
connectionNameListstringListe des noms de connexion TCP/IP (nomHôte(port)) utilisés pour les communications. La liste des noms de connexion est prioritaire sur les propriétés de nom d'hôte et de port.
localAddressstringPour une connexion à un gestionnaire de files d'attente cette propriété indique l'un ou l'autre des éléments suivants ou les deux, (1) L'interface réseau locale à utiliser, (2) Le port local ou la gamme de ports locaux, à utiliser.
messageBatchSizeint
Min: 0
Nombre maximum de messages à traiter dans un lot particulier
queueManagerstringNom du gestionnaire de files d'attente auquel se connecter
subscriptionDurability
  • Durable
  • NonDurable
Indique si un abonnement durable ou non durable est utilisé pour distribuer les messages vers un bean géré par message qui est abonné au sujet
Durable
Durable
NonDurable
NonDurable
subscriptionNamestringNom de l'abonnement durable
messageRetentionbooleanIndique si le consommateur de connexions conserve ou non les messages indésirables dans la file d'attente en entrée.
messageSelectorstringDétermine si la sélection des messages est effectuée par WebSphere MQ classes for JMS ou par le courtier. La sélection des messages par le courtier n'est pas prise en charge lorsque brokerVersion a la valeur 1.
sslCertStoresstringServeurs Lightweight Directory Access Protocol (LDAP) qui gèrent les listes de révocation des certificats (CRL) à utiliser sur une connexion SSL
sslCipherSuitestringAlgorithme à utiliser pour une connexion SSL
sslFipsRequiredbooleanIndique si une connexion SSL doit utiliser un algorithme pris en charge par le fournisseur IBM Java JSSE FIPS (IBMJSSEFIPS).
sslPeerNamestringPour une connexion SSL, modèle utilisé pour vérifier le nom distinctif dans le certificat numérique fourni par le gestionnaire de files d'attente.
brokerCCDurSubQueuestringNom de la file d'attente à partir de laquelle les messages d'abonnement non durable sont extraits pour un consommateur de connexions
brokerCCSubQueuestringNom de la file d'attente sur laquelle un consommateur reçoit des messages d'abonnement non durable
brokerControlQueuestringNom de la file d'attente de contrôle du courtier
brokerPubQueuestringNom de la file d'attente dans laquelle les messages publiés sont envoyés (file d'attente de flux)
brokerQueueManagerstringNom du gestionnaire de files d'attente sur lequel s'exécute le courtier
brokerSubQueuestringNom de la file d'attente à partir de laquelle un consommateur de messages non durables reçoit des messages
brokerVersion
  • 1
  • 2
Version du courtier en cours d'utilisation
1
1
2
2
cleanupIntervalPériode avec une précision à la milliseconde prèsIntervalle, en millisecondes, entre les exécutions d'arrière-plan de l'utilitaire de nettoyage de publication et d'abonnement. 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.
receiveExitstringIdentifie un programme d'exit de réception de canal, ou une séquence de programmes d'exit de réception à exécuter successivement.
receiveExitInitstringDonnées utilisateur transmises aux programmes d'exit de réception de canal lorsqu'ils sont appelés
securityExitstringIdentifie un programme d'exit de sécurité de canal
securityExitInitstringDonnées utilisateur transmises à un programme d'exit de sécurité de canal lorsqu'il est appelé
sendExitstringIdentifie un programme d'exit d'émission de canal, ou une séquence de programmes d'exit d'émission à exécuter successivement.
sendExitInitstringDonnées utilisateur transmises aux programmes d'exit d'émission de canal lorsqu'ils sont appelés