Lorsque des applications client autonomes (telles que des applications Java™
qui accèdent à des beans enterprise hébergés dans WebSphere Application Server) ont des problèmes d'interaction avec WebSphere Application Server, il peut s'avérer utile d'activer la fonction de trace de l'application. Lorsque la fonction de trace est activée pour les programmes client, les classes WebSphere Application Server utilisées par ces applications (par exemple, les classes client du service d'affectation des noms) génèrent des
informations de trace.
Pourquoi et quand exécuter cette tâche
Une technique standard de résolution des problèmes consiste à
activer la fonction de trace sur les applications serveur et client et de
comparer les enregistrements par rapport à l'horodatage pour essayer de comprendre à
quel moment l'incident survient.
Vous pouvez également configurer la fonction de trace à partir de la console MVS en utilisant la commande modify.
Procédure
- Pour activer la fonction de trace pour les classes WebSphere Application Server d'une application client, ajoutez les propriétés système indiquées dans l'exemple suivant à la commande ou au script de démarrage de l'application client. L'emplacement de la sortie et les classes et détails inclus dans la trace suivent les mêmes règles que pour l'ajout de la trace aux serveurs WebSphere Application Server. Par exemple, pour activer la fonction de trace du
programme de l'application client autonome appelé
com.ibm.sample.MyClientProgram, saisissez la commande
suivante :
java -DtraceSettingsFile=MyTraceSettings.properties
-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager
-Djava.util.logging.configureByServer=true com.ibm.samples.MyClientProgram
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Le fichier identifié par
nom_fichier doit être un fichier de propriétés placé
dans le chemin d'accès aux classes du client d'application ou du processus
autonome. Vous devez créer un fichier de propriétés de trace
en copiant le fichier
%install_root\properties\TraceSettings.properties
dans le même répertoire que celui du fichier JAR (Java archive) de l'application client.
Le fichier identifié par
nom_fichier doit être un fichier de propriétés placé
dans le chemin d'accès aux classes du client d'application ou du processus
autonome. Vous devez créer un fichier de propriétés de trace en copiant le fichier racine_serveur_app/properties/TraceSettings.properties dans le même répertoire que le fichier JAR (Java archive) de l'application client.
Vous ne pouvez pas utiliser la propriété -DtraceSettingsFile=TraceSettings.properties pour activer la trace de l'ORB des clients fins. Pour diriger la sortie de trace de l'ORB des clients fins vers un fichier, définissez le paramètre com.ibm.CORBA.Debug.Output
= debugOutputFilename dans la ligne de commande.
Les propriétés système
java.util.logging.manager et java.util.logging.configureByServer
configurent la consignation Java pour utiliser une classe LogManager spécifique à WebSphere Application Server
et pour utiliser la configuration à partir du fichier spécifié par la propriété traceSettingsFile. Le fichier des propriétés de consignation Java par défaut, situé dans l'environnement JRE6
(Java SE
Runtime Environment 6), ne sera pas appliqué.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Vous pouvez configurer le fichier
MyTraceSettings.properties de telle sorte qu'il envoie la
sortie de trace vers un fichier à l'aide de la propriété
traceFileName.
Spécifiez l'une des deux options suivantes : - Le chemin d'accès complet d'un fichier de sortie. Par exemple,
traceFileName=c:\\MyTraceFile.log.
Vous devez spécifier cette propriété pour générer une sortie
visible.
- stdout. Lorsque cette option est indiquée, la sortie est dirigée
vers System.out.
- Vous pouvez également spécifier une chaîne de trace pour enregistrer des messages avec la propriété Trace String, qui définit une spécification de trace de démarrage similaire à celle disponible sur le serveur. Pour plus de commodité, vous pouvez entrer plusieurs chaînes de trace distinctes
dans ce fichier, une par ligne.
Résultats
L'utilisation des propriétés facultatives a pour résultat :
- Spécifiez un paramètre valide pour la propriété traceFileName, mais pas de chaîne de trace, pour enregistrer les messages dans le fichier indiqué ou dans System.out uniquement.
- Spécifiez une chaîne de trace sans propriété traceFileName pour ne générer aucune sortie.
- Spécifiez une propriété traceFileName valide et une chaîne de trace pour enregistrer les entrées de message et de trace à l'emplacement défini dans la propriété traceFileName.