Activation de la fonction de trace sur des applications client autonomes

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.

[z/OS]Vous pouvez également configurer la fonction de trace à partir de la console MVS en utilisant la commande modify.

Procédure

  1. 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][z/OS]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.

    [IBM i]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é.

  2. [AIX Solaris HP-UX Linux Windows][IBM i]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.
  3. 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.

Icône indiquant le type de rubrique Rubrique de tâche



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=ttrb_entrstandal
Nom du fichier : ttrb_entrstandal.html