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 .
- DYNAMIC.CONFIGURATION.ENABLED
ENABLE.ZOS.LP.RECOVERY
- MAX.RECOVERY.RETRIES
- MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
- MQJMS.POOLING.THRESHOLD
- MQJMS.POOLING.TIMEOUT
- NON.ASF.RECEIVE.TIMEOUT
- NON.ASF.BMT.ROLLBACK.ENABLED
- RECOVERY.RETRY.INTERVAL
- SERVER.SESSION.POOL.REAP.TIME
- SERVER.SESSION.POOL.UNUSED.TIMEOUT
- SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
DYNAMIC.CONFIGURATION.ENABLED
Cette propriété vérifie si le serveur d'applications 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.
Information | Valeur |
---|---|
Type de données | Booléenne |
Valeut par défaut | False (non sélectionné) |
![[z/OS]](../images/ngzos.gif)
ENABLE.ZOS.LP.RECOVERY
Cette propriété contrôle le comportement du port d'écoute lorsqu'un serveur d'applications se connecte à WebSphere MQ for z/OS.
- Un port d'écoute pour tenter une reprise si une connexion entre le serveur d'applications et WebSphere MQ est interrompue (par exemple, si le gestionnaire de files d'attente a été arrêté). Si vous n'activez pas cette propriété, le port d'écoute n'essaie pas de reprendre son exécution une fois qu'un gestionnaire de files d'attente a été arrêté.
- Plusieurs classifications de gestion de la charge de travail à configurer pour un port d'écoute. Si vous n'activez pas cette propriété, les messages restent dans la file d'attente WebSphere MQ lorsque plusieurs classifications de gestion de la charge de travail sont configurées pour un port d'écoute.
Redémarrez le serveur après avoir ajouté la propriété.
Si vous vous connectez à WebSphere MQ for z/OS à l'aide de connexions de liaisons WebSphere MQ vous devez également appliquer l'APAR PK53912 qui est fourni dans WebSphere MQ Version 6.0.2.4.
Information | Valeur |
---|---|
Type de données | Booléenne |
Valeut par défaut | True (activé) |
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.
- 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.
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Nouvelles tentatives |
Valeut par défaut | 5 |
Intervalle | 0 (pas de nouvelle tentative) à 2147483647 |
MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
Indicateur de régulation qui permet la poursuite du traitement des messages par le contrôleur lorsque le seuil inférieur des messages est atteint. Lorsque le service d'écoute de messages a été configuré avec la propriété personnalisée MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH et que la valeur "true" a été affectée à cette dernière, la valeur du seuil inférieur est définie en interne à l'identique de la valeur du seuil supérieur (propriété Maximum de sessions du port d'écoute définie en externe).
Information | Valeur |
---|---|
Type de données | String (chaîne) |
Valeut par défaut | True |
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.
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Nombre de connexions |
Valeut 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.
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Millisecondes |
Valeut 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.
- Le mode ASF offre une prise en charge transactionnelle et un accès simultané pour les applications. Dans le cas des beans gérés par message de publication/abonnement, le mode ASF offre un meilleur débit et une concurrence optimale car en mode non-ASF, le programme 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.
Le mode non-ASF ne peut pas être sélectionné sur les systèmes z/OS. Dans ce cas précis, vous ne devez pas affecter une valeur différente de zéro à cette propriété.
Si votre système de messagerie s'exécute en mode non ASF, pour éviter des délais d'expiration de transaction non souhaités, vous devez autoriser une durée de traitement suffisante avant d'atteindre le délai total du cycle de vie des transactions. Par conséquent, vous devez vous assurer que la valeur que vous spécifiez pour la propriété personnalisée du service d'écoute de message NON.ASF.RECEIVE.TIMEOUT est inférieure à la valeur que vous spécifiez pour la propriété de service de transaction Dépassement du délai autorisé pour la durée de vie des transactions, et que la différence entre les valeurs des deux propriété est supérieure à la durée du traitement du message par la méthode onMessage() du bean géré par message (MDB).
Par exemple, si la méthode onMessage() du bean géré par messages dure au maximum 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).
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Millisecondes |
Valeut par défaut | Mode ASF (propriété personnalisée non créée) |
Intervalle | 0 ou plus (millisecondes)
|
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.
- Le mode ASF offre une prise en charge transactionnelle et un accès simultané pour les applications. Dans le cas des beans gérés par message de publication/abonnement, le mode ASF offre un meilleur débit et une concurrence optimale car en mode non-ASF, le programme 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.
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.
Information | Valeur |
---|---|
Type de données | Booléenne |
Valeut 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.
- 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.
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Valeur par défaut |
Valeut 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.
La propriété personnalisée SERVER.SESSION.POOL.REAP.TIME ne s'applique pas si votre système de messagerie est en cours d'exécution en mode non ASF.
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Valeur par défaut |
Valeut 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.
La propriété personnalisée SERVER.SESSION.POOL.UNUSED.TIMEOUT ne s'applique pas si votre système de messagerie est en cours d'exécution en mode non ASF.
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Valeur par défaut |
Valeut 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é.
La propriété personnalisée SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname ne s'applique pas si votre système de messagerie est en cours d'exécution en mode non ASF.
Information | Valeur |
---|---|
Type de données | Entierr |
Unité | Valeur par défaut |
Valeut par défaut | Non défini |
Intervalle | -2147483648 à 2147483647 |