Propriétés personnalisées du service d'écoute de messages

Utilisez cet écran pour afficher ou modifier les propriétés personnalisées du service d'écoute de messages.

Pour afficher cette page de la console d'administration, cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur > [Communications] Messagerie > Service d'écoute de messages > Propriétés personnalisées.

Vous pouvez accéder à la page Propriétés personnalisées pour définir les propriétés suivantes du service d'écoute de messages :
DYNAMIC.CONFIGURATION.ENABLED

Cette propriété vérifie si le serveur d'application sur lequel le port d'écoute est créé nécessite d'être redémarré. définissez cette propriété sur true pour activer la configuration dynamique.

Type de données Booléen
Valeur par défaut False (non sélectionné)
MAX.RECOVERY.RETRIES

Nombre maximal de fois qu'un port d'écoute géré par ce service tente d'effectuer une reprise après un incident avant d'abandonner et de s'arrêter. Une fois arrêté, le port d'écoute associé passe à l'état Arrêt. La fréquence des tentatives est définie par la propriété RECOVERY.RETRY.INTERVAL.

L'une ou l'autre des conditions suivantes peut générer un incident :
  • Une erreur imprévue est arrivée alors qu'un port d'écoute essayait d'obtenir un message depuis le fournisseur JMS.
  • La connexion entre le serveur d'applications et le fournisseur JMS a été perdue, normalement à cause d'une erreur réseau.
Type de données Entier
Unité Nouvelles tentatives
Valeur par défaut 5
Intervalle 0 (pas de nouvelle tentative) à 2147483647
MQJMS.POOLING.THRESHOLD

Nombre maximum de connexions inutilisées dans le pool.

Un MQSimpleConnectionManager alloue des connexions utilisées le plus récemment et détruit les connexions les moins utilisées récemment. Par défaut, une connexion est détruite si le pool contient plus de dix connexions inutilisées.

Type de données Entier
Unité Nombre de connexions
Valeur par défaut 10
MQJMS.POOLING.TIMEOUT

Délai, en millisecondes, au bout duquel une connexion du pool est détruite si elle n'est pas utilisée.

Un MQSimpleConnectionManager alloue des connexions utilisées le plus récemment et détruit les connexions les moins utilisées récemment. Par défaut, une connexion est détruite si elle n'a pas été utilisée pendant cinq minutes.

Type de données Entier
Unité Millisecondes
Valeur par défaut 5 minutes
NON.ASF.RECEIVE.TIMEOUT

Expiration en millisecondes des réceptions de messages synchrones effectuées par des sessions de module d'écoute de bean géré par message en mode non-ASF.

Remarque : Le service d'écoute de messages fonctionne selon deux modes, ASF (Application Server Facilities) et non-ASF :
  • Le mode ASF offre une prise en charge transactionnelle et un accès concurrent pour les applications. Dans le cas des beans gérés par messages de publication/d'abonnement, le mode ASF offre un meilleur débit et une concurrence optimale car en mode non-ASF, le module d'écoute dispose d'une seule unité d'exécution.
  • Le mode non-ASF est principalement utilisé avec les fournisseurs de messagerie tiers ne prenant pas en charge le mode ASF JMS, qui est une extension facultative de la spécification JMS. Le mode non-ASF est également transactionnel, mais, puisque son chemin est moins long que celui du mode ASF, il offre de meilleures performances.

Pour activer le mode non-ASF pour tous les modules d'écoute de bean géré par messages sur le serveur d'applications, affectez à cette propriété une valeur différente de zéro.

[z/OS] Le mode non-ASF ne peut pas être sélectionné sur les systèmes z/OS systems ; par conséquent, n'affectez pas une valeur différente de séro à cette propriété.

Type de données Entier
Unité Millisecondes
Valeur par défaut Mode ASF (propriété personnalisée non créée)
Intervalle 0 ou plus (millisecondes)
0
Le mode Non-ASF est désactivé.
1 ou plus
Expiration en millisecondes pour les réceptions de sessions synchrones du module d'écoute de bean géré par message non-ASF.
Recommandé En cas de dépassement de délai d'une transaction, il est nécessaire d'effectuer un recyclage du message, ce qui entraîne un travail supplémentaire. Si vous souhaitez utiliser le mode non-ASF, attribuez à cette propriété une valeur inférieure à celle du délai d'attente de la transaction, mais supérieure ou égale à la durée maximale de la méthode onMessage() du bean géré par messages. Par exemple, si la méthode onMessage() du bean géré par messages dure au maximum of 10 secondes et que le délai d'attente de la transaction est de 120 secondes, vous pouvez affecter à la propriété NON.ASF.RECEIVE.TIMEOUT une valeur inférieure ou égale à 110 000(soit 110 secondes).
NON.ASF.BMT.ROLLBACK.ENABLED

Si le mode de fonctionnement non ASF (non-Application Server Facilities) est utilisé (parce que vous avez affecté à la propriété NON.ASF.RECEIVE.TIMEOUT une valeur différente de zéro) et qu'un bean géré par messages utilisant des transactions gérées par message génère une exception d'exécution, la propriété NON.ASF.BMT.ROLLBACK.ENABLED détermine si les messages sont renvoyés à la destination.

Remarque : Le service d'écoute de messages fonctionne selon deux modes, ASF (Application Server Facilities) et non-ASF :
  • Le mode ASF offre une prise en charge transactionnelle et un accès concurrent pour les applications. Dans le cas des beans gérés par messages de publication/d'abonnement, le mode ASF offre un meilleur débit et une concurrence optimale car en mode non-ASF, le module d'écoute dispose d'une seule unité d'exécution.
  • Le mode non-ASF est principalement utilisé avec les fournisseurs de messagerie tiers ne prenant pas en charge le mode ASF JMS, qui est une extension facultative de la spécification JMS. Le mode non-ASF est également transactionnel, mais, puisque son chemin est moins long que celui du mode ASF, il offre de meilleures performances.

[z/OS] Le mode non-ASF ne peut pas être sélectionné sur les systèmes z/OS.

Si cette propriété a la valeur false (valeur par défaut), le message est automatiquement validé avant d'être transmis au bean géré par message.

Si cette propriété a la valeur true, le service d'écoute de messages envoie un accusé de réception du message au client une fois que le message a été correctement traité par le bean géré par message et le service d'écoute des messages demande la récupération de tout message pour lequel le bean génère une exception.

Type de données Booléen
Valeur par défaut False
RECOVERY.RETRY.INTERVAL

Intervalle en secondes séparant les nouvelles tentatives effectuées par un port d'écoute pour exécuter une reprise sur incident. Le nombre maximal de nouvelles tentatives est défini par la propriété MAX.RECOVERY.RETRIES.

L'une ou l'autre des conditions suivantes peut générer un incident :
  • Une erreur imprévue est arrivée alors qu'un port d'écoute essayait d'obtenir un message depuis le fournisseur JMS.
  • La connexion entre le serveur d'applications et le fournisseur JMS a été perdue, normalement à cause d'une erreur réseau.
Type de données Entier
Unité Secondes
Valeur par défaut 60
Intervalle 1 à 2147483647
SERVER.SESSION.POOL.REAP.TIME

Durée en secondes entre les vérifications sur les pools de sessions serveur. Pour activer la surveillance des pools de sessions serveur, affectez à cette propriété une valeur non négative.

Type de données Entier
Unité Secondes
Valeur par défaut -1 (désactivé)
Intervalle -2147483648 à 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT

Délai par défaut des pools de sessions serveur en secondes.

Si cette propriété est affectée d'une valeur non négative, elle est comparée au délai écoulé depuis l'utilisation d'une session serveur. Si le délai d'expiration est inférieur à la durée écoulée, la session serveur est supprimée du pool de sessions serveur et sa session JMS est renvoyée au pool de sessions JMS. Par exemple, si le délai d'expiration est d'une seconde et que la durée écoulée depuis l'utilisation d'une session serveur particulière est de deux secondes, cette session serveur est supprimée du pool de sessions serveur et sa session JMS est renvoyée au pool de sessions JMS.

Type de données Entier
Unité Secondes
Valeur par défaut -1 (désactivé)
Intervalle -2147483648 à 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname

Cette propriété remplace la valeur SERVER.SESSION.POOL.UNUSED.TIMEOUT par défaut du port d'écoute par le nom défini pour lpname. Cette valeur s'applique à tous les beans gérés par messages qui utilisent le port d'écoute spécifié.

Si la valeur de remplacement n'est pas négative, elle remplace la propriété SERVER.SESSION.POOL.UNUSED.TIMEOUT, même si la propriété SERVER.SESSION.POOL.UNUSED.TIMEOUT a une valeur négative.

Si la valeur de remplacement est négative, elle désactive la surveillance des pools de sessions serveur pour le port d'écoute spécifié.

Type de données Entier
Unité Secondes
Valeur par défaut Non défini
Intervalle -2147483648 à 2147483647



Les liens marqués (en ligne) requièrent un accès à Internet.

Tâches associées
Référence associée


Nom du fichier : umb_prolscp.html