Propriétés personnalisées du service de transactions

WebSphere Application Server vous permet de configurer un certain nombre de propriétés personnalisées pour les services de transaction.

Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.

Les propriétés personnalisées du service de transaction peuvent être spécifiées dans la console d'administration. Pour utiliser l'une de ces propriétés personnalisées, cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur > [Paramètres du conteneur] Services du conteneur > Service de transaction > [Propriétés supplémentaires] Propriétés personnalisées.

Eviter les incidents Eviter les incidents: Dans z/OS, vérifiez que tous les flux de journaux associés sont paramétrés sur AUTODELETE(NO).gotcha

DELAY_CANCELLING_ALARMS

Si la phase de pré-achèvement d'un processus de transaction est susceptible de contenir des processus pouvant durer longtemps ou pouvant échouer, vous pouvez souhaiter la fin de la transaction.

Par défaut, les alarmes d'exécution de la transaction sont annulées avant le début de la phase de pré-achèvement de la transaction. La propriété personnalisée DELAY_CANCELLING_ALARMS permet d'intégrer la phase de pré-achèvement de la transaction dans la période d'exécution de la transaction. Pour ce faire, paramétrez la propriété suivante sur le serveur d'applications.

Tableau 1. Propriété personnalisée DELAY_CANCELLING_ALARMS. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut FALSE
[z/OS]

DISABLE_DEFERRED_CTX_REGISTRATION

Par défaut, l'enregistrement d'une transaction globale WebSphere avec le contexte de transaction natif de z/OS est différé jusqu'à l'inscription des ressources avec la transaction globale. Cet enregistrement différé représente une amélioration permettant d'accroître les performances dans les scénarios où les ressources RRS ne sont PAS impliquées dans la transaction en cours (par exemple, si seules des ressources XA sont inscrites) ; il permet d'éviter le traitement supplémentaire lié à l'enregistrement avec le contexte natif lorsque cette opération n'est pas requise par la suite. Si des ressources RRS sont inscrites avec la transaction, l'enregistrement différé a toujours lieu, mais il n'améliore pas les performances.

La propriété personnalisée DISABLE_DEFERRED_CTX_REGISTRATION désactive le report de l'enregistrement d'une transaction globale WebSphere avec le contexte de transaction natif de z/OS. Si l'enregistrement différé est désactivé, l'enregistrement avec le contexte de transaction natif est automatiquement effectué lors de la création de la transaction globale WebSphere.

Dans certains cas, il n'est pas souhaitable de différer l'enregistrement du contexte natif pour les ressources RRS. Dans les cas suivants, spécifiez DISABLE_DEFERRED_CTX_REGISTRATION=true :
  • Une application active la mise en suspens du curseur, ce qui dans certains cas permet de garder un ensemble de résultats ouvert entre les limites de transactions.
Table 2. Propriété personnalisée DISABLE_DEFERRED_CTX_REGISTRATION
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut FALSE
[z/OS]

DISABLE_OUTBOUND_CASCADED_SUPPORT

Indique si le gestionnaire de transactions doit ou non désactiver la prise en charge des transactions en cascade et autoriser les autres serveurs WebSphere Application Server sur z/OS (qui prennent aussi en charge le traitement des transactions RRS en cascade) à prendre part à cet ensemble en cascade.

Affectez à cette propriété la valeur "true" si vous ne voulez pas d'une prise en charge sans limite. Si vous indiquez "true", le serveur utilisera par défaut la propagation des transactions JTS standard.

Tableau 3. Propriété personnalisée DISABLE_OUTBOUND_CASCADED_SUPPORT. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut FALSE

DISABLE_RECOVERY_AUDIT_LOGGING

Vous pouvez contrôler si les messages d'informations s'affichent sur la console d'administration et sont écrits sur le fichier SystemOut.log au cours de la récupération du service de transaction. Pour ce faire, paramétrez la propriété personnalisée DISABLE_RECOVERY_AUDIT_LOGGING pour le service de transaction du serveur.

[AIX Solaris HP-UX Linux Windows][IBM i]Sur les plateformes réparties, la valeur par défaut indique que les messages d'informations s'affichent à la fois sur la console d'administration et dans le fichier SystemOut.log au cours de la récupération des services de transaction. Si vous ne souhaitez pas que ces messages s'affichent, vous pouvez utiliser la propriété personnalisée DISABLE_RECOVERY_AUDIT_LOGGING.

[z/OS]Dans z/OS®, les messages d'informations ne s'affichent pas par défaut, ni sur la console d'administration, ni dans le fichier SystemOut.log au cours de la récupération des services de transaction. Si vous souhaitez que ces messages s'affichent, vous pouvez utiliser la propriété personnalisée DISABLE_RECOVERY_AUDIT_LOGGING.

[z/OS]Remarque : Dans z/OS, si vous choisissez d'activer les messages d'audit de récupération de la transaction, les autres messages d'audit (comme ceux associés à la récupération du serviteur et à la récupération de la ressource XA) s'affichent également sur la console et dans le fichier SystemOut.log.
Tableau 4. Propriété personnalisée DISABLE_RECOVERY_AUDIT_LOGGING. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut

[AIX Solaris HP-UX Linux Windows][IBM i]FALSE

[z/OS]TRUE

[z/OS]

DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD

Spécifie s'il existe un délai entre l'expiration de la transaction et l'arrêt anormal de la région serviteur qui exécutait la transaction.

Si la valeur est "false", une transaction globale qui arrive à expiration est marquée pour annulation seulement. Le serveur de transactions donne environ quatre minutes supplémentaires à l'application associée pour aboutir. Si l'application aboutit dans ce délai, la transaction est annulée. Sinon, l'application et la région serviteur associée sont arrêtés de façon anormale, générant une erreur ABENDEC3 ou ABENDSEC3.

Pour supprimer ce délai supplémentaire et que l'application et la région serviteur subissent immédiatement un arrêt anormal, définissez cette valeur sur "true".

Tableau 5. Propriété personnalisée DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut FALSE
[z/OS]

DISABLE_WSTX_RMFAIL_LOGGING

Indique si un message RMFAIL est envoyé au fichier journal des erreurs lorsqu'un participant WS-AT ne parvient pas à envoyer une réponse dans le délai accordé pour les réponses asynchrones, ce qui entraîne l'émission d'une exception de transaction XAER_RMFAIL.

Si vous indiquez la valeur false, un message RMFAIL est envoyé au fichier journal des erreurs lorsqu'un participant WS-AT ne parvient pas à envoyer une réponse dans le délai accordé pour les réponses asynchrones.

Indiquez la valeur true si vous ne souhaitez pas qu'un message RMFAIL soit envoyé au fichier journal des erreurs lorsqu'un participant WS-AT ne parvient pas à envoyer de réponse dans le délai imparti pour les réponses asynchrones.

Tableau 6. Propriété personnalisée DISABLE_WSTX_RMFAIL_LOGGING. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut FALSE

ENABLE_XARESOURCE_TIMEOUT

Si la valeur est true, le service de transaction fournit une valeur de délai d'attente pour les ressources XA lorsqu'elles sont impliquées dans des transactions globales. Le délai d'attente indiqué correspond au nombre restant de secondes avant que la transaction n'expire.

Table 7. Propriété personnalisée ENABLE_XARESOURCE_TIMEOUT. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut FALSE

REMOVE_PARTNER_LOG_ENTRY

Vous pouvez supprimer des entrées du fichier journal du partenaire de transaction. Pour ce faire, paramétrez la propriété personnalisée REMOVE_PARTNER_LOG_ENTRY pour le service de transaction du serveur possédant le journal du partenaire.

Au cours du processus de récupération de la transaction, le journal du partenaire est contrôlé pour définir les ressources nécessaires. Si vous souhaitez supprimer certaines entrées du journal du partenaire, par exemple une ressource qui n'existe plus, paramétrez cette propriété personnalisée sur le serveur d'applications qui possède le journal du partenaire de transaction contenant les entrées à supprimer.

La propriété personnalisée REMOVE_PARTNER_LOG_ENTRY est uniquement active lorsque les deux situations suivantes se présentent.

  • Le serveur d'applications est démarré en mode récupération.
  • Le serveur d'applications ne possède aucune transaction nécessitant actuellement une récupération. Vous pouvez le vérifier en consultant le fichier SystemOut.log.
Tableau 8. Propriété personnalisée REMOVE_PARTNER_LOG_ENTRY. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Entierr
Valeurs acceptables (un ou plusieurs ID de récupération d'entier séparés par une virgule)
Valeur par défaut (null)
[z/OS]

RLS_LOGSTREAM_COMPRESS_INTERVAL

Définit, en secondes, l'intervalle auquel le service du journal de récupération tente de compresser les flux de consignation utilisés par les composants d'application. Le service de transaction (journal du partenaire XA) et les composants de service de compensation peuvent être configurés pour utiliser le service de journal de récupération.

La compression du flux de consignation est vérifiée une fois par intervalle. Cette opération peut causer une utilisation inutile de l'unité centrale si le flux de consignation n'est pas en cours d'utilisation.

Remarque :
  • Si vous n'utilisez pas de flux de consignation pour le service de compensation, attribuez à cette propriété une valeur supérieure à la valeur par défaut.
  • Si votre service de journal de récupération utilise des flux de consignation, n'attribuez pas de valeur trop élevée à cette propriété. Si les flux de consignation du service de journal de récupération saturent avant la fin de l'intervalle de compression, les transactions peuvent commencer à échouer avant que les flux de consignation ne soient compressés.
  • Si aucun de vos composants n'est configuré pour utiliser un flux de consignation, définissez cette propriété sur 0 (zéro) pour désactiver cette fonction.
Tableau 9. Propriété personnalisée RLS_LOGSTREAM_COMPRESS_INTERVAL. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Entierr
Valeurs acceptables 0 - 2,147,483,647 (0 désactive cette fonction)
Valeur par défaut 30 secondes

ZOS_RECOVER_BEFORE_COMMIT

Cette propriété empêche la génération d'un interblocage à la suite d'un appel xa_recover sur une ressource MQ Server lors de la récupération. Le serveur MQ utilise des interfaces de flux entrant de transaction JCA 1.5 en standard. Ces interfaces permettent au membre de bus MQ Server de coordonner les ressources WMQ et du bus d'intégration de services en utilisant des transactions WebSphere Application Server. Lors de la validation d'une transaction lors de la récupération, xa_recover est appelé pour éviter que les anciens pilotes DB2 ne retournent XAER_NOTA, même si la transaction existe lors de l'appel xa_commit ou xa_rollback.

Cet interblocage se produit, car la ressource MQ Server rappelle le contrôleur et tente de verrouiller toutes les transactions connues pour que la ressource MQ server qu'elle puisse générer une liste de transactions qui doit répondre à l'appel xa_recover. Cependant, comme la transaction IN-COMMIT en cours de validation est verrouillée, l'appel xa_recover attend indéfiniment pour verrouiller la transaction IN-COMMIT, car cette dernière n'est pas déverrouillée tant que la transaction n'est pas validée.

Affectez à la propriété la valeur FALSE pour que, lors du traitement des transactions lors de la récupération, l'appel xa_recover ne soit pas émis avant un appel xa_commit ou xa_rollback.

Eviter les incidents Eviter les incidents: Tous les pilotes DB2 pris en charge disposent d'une fonction qui évite d'émettre un appel xa_recover avant un appel xa_commit ou xa_rollback. Si après avoir lu la documentation de votre pilote DB2 vous ne savez pas si le pilote contient une fonction de récupération automatique, contactez le support IBM DB2 pour savoir si vous pouvez définir cette propriété pour l'utiliser pour les serveurs qui hébergent des applications qui accèdent à DB2.gotcha
Table 10. Propriété personnalisée ZOS_RECOVER_BEFORE_COMMIT. La table contient le type de données, les valeurs acceptables et la valeur par défaut de la propriété.
Information Value
Type de données Booléen
Valeurs acceptables TRUE, FALSE
Valeur par défaut TRUE

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjta_transerv_custproperties
Nom du fichier : rjta_transerv_custproperties.html