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

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.

Cette propriété contrôle le comportement du port d'écoute lorsqu'un serveur d'applications se connecte à IBM MQ for z/OS.

Redémarrez le serveur après avoir ajouté la propriété.

Si vous vous connectez à IBM MQ for z/OS à l'aide de connexions de de liaisons IBM MQ vous devez également appliquer l'APAR PK53912 qui est fourni dans IBM MQ Version 6.0.2.4.

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.

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.

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.

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.

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).

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 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.

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.

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.

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.

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.