La consignation de l'API CM est contrôlée à l'aide du fichier logging.properties qui est associé au JRE qui exécute votre application. Le fichier logging.properties se trouve dans le répertoire jre\lib de votre kit Java Development Kit, par exemple : C:\Program Files\IBM\WebSphere\AST\eclipse\jre\lib, C:\jdk_5.0\jre\lib ou C:\Program Files\Java\jre1.5.0_06\lib).
La consignation est désactivée par défaut. Il est recommandé d'activer la consignation sur le niveau INFO.
############################################################ # Propriétés globales ############################################################ # # "handlers" indique une liste séparée par des virgules de classes # de gestionnaire de journal. Ces gestionnaires seront installés pendant le démarrage de la machine virtuelle. # Notez que ces classes doivent figurer dans le paramètre CLASSPATH système. # Par défaut, nous ne configurons qu'un ConsoleHandler qui affichera # uniquement les messages aux niveaux INFO et supérieurs. handlers = java.util.logging.ConsoleHandler # Si vous voulez ajouter aussi FileHandler, utilisez à la place la ligne suivante. #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # Niveau de consignation global par défaut. # Cela indique quelles catégories d'événements sont consignées dans # tous les journaux d'événements. Pour une fonction donnée, ce niveau global # peut être remplacé par un niveau spécifique à la fonction. # Notez que ConsoleHandler comporte aussi un paramètre de niveau # séparé pour limiter les messages imprimés sur la console. # La ligne suivante active la consignation (pour tous les objets de journal d'événements) pour le niveau INFO. .level=INFO ############################################################ # Propriétés spécifiques au gestionnaire. # Décrit les informations de configuration spécifiques aux gestionnaires. ############################################################ # CMLogger - doit toujours être activé au niveau INFO. # # Les applications utilisant l'API CM n'ont pas besoin d'être arrêtées et redémarrées. Les changements du # fichier logging.properties configuré sont automatiquement pris en compte et mis en oeuvre en 10 secondes. # # Les lignes suivantes configurent la consignation pour l'objet CMLogger pour le niveau INFO # et définissent que le fichier de sortie de journal sera nommé CMLogger[#].log et se trouvera dans le # répertoire personnel de l'utilisateur connecté. Le fichier de sortie de journal tournera entre 20 fichiers, chaque fichier étant # limité à 20000000 octets. Les entrées de journal seront ajoutées au fichier de sortie de journal # actuel à tour de rôle et seront écrites en format simple. # com.ibm.rational.stp.common.internal.util.CMLogger.level = INFO com.ibm.rational.stp.common.internal.util.LogHandler.pattern = %h/CMLogger%g.log com.ibm.rational.stp.common.internal.util.LogHandler.limit = 20000000 com.ibm.rational.stp.common.internal.util.LogHandler.count = 20 com.ibm.rational.stp.common.internal.util.LogHandler.append = true com.ibm.rational.stp.common.internal.util.LogHandler.formatter = java.util.logging.SimpleFormatter # CMTracer - Activez les entrées suivantes (en supprimant leur mise en commentaire) pour une utilisation uniquement temporaire, car le traçage # peut consommer beaucoup de ressources. # # Les applications utilisant l'API CM n'ont pas besoin d'être arrêtées et redémarrées. Les changements du # fichier logging.properties configuré sont automatiquement pris en compte et mis en oeuvre en 10 secondes. # # Les lignes suivantes configurent le traçage pour l'objet CMTracer au niveau FINER # et définissent que le fichier de sortie de trace sera nommé CMTracer[#].log et se trouvera dans le # répertoire personnel de l'utilisateur connecté. Le fichier de sortie de trace tournera entre 20 fichiers, chaque fichier étant # limité à 20000000 octets. Les entrées de trace seront ajoutées au fichier de sortie de trace # actuel à tour de rôle et seront écrites en format simple. # #com.ibm.rational.stp.common.internal.util.CMTracer.level = FINER #com.ibm.rational.stp.common.internal.util.TraceHandler.pattern = %h/CMTracer%g.log #com.ibm.rational.stp.common.internal.util.TraceHandler.limit = 20000000 #com.ibm.rational.stp.common.internal.util.TraceHandler.count = 20 #com.ibm.rational.stp.common.internal.util.TraceHandler.append = true #com.ibm.rational.stp.common.internal.util.TraceHandler.formatter = java.util.logging.SimpleFormatter
Ces paramètres produiront un fichier journal nommé CMLogger[#].log, où [#] désigne le numéro de rotation du fichier. Chaque fichier se trouve dans le répertoire personnel de l'utilisateur connecté. La sortie tourne d'un fichier à l'autre lorsqu'un fichier est plein.
L'utilisation des entrées logging.properties dans l'exemple précédent signifie que les enregistrements de journal sont ajoutés à la fin du fichier applicable et que chaque entrée est stockée en format simple. Les modifications du fichier logging.properties sont reconnues par l'application reposant sur l'API CM en environ 10 secondes. Vous n'avez pas besoin d'arrêter et redémarrer l'application.
Lorsqu'un fichier de sortie journal est plein, un nouveau fichier est créé et le fichier précédent est renommé pour contenir la date et l'horodatage du moment où la rotation des fichiers se produit. Chaque fichier contient 20 Mo de données et les nouvelles entrées sont ajoutées aux entrées existantes, y compris après les divers redémarrages de l'application. Lorsque le nombre de fichiers journaux atteint 20, la rotation vers un nouveau fichier entraîne la suppression du fichier le plus ancien.
Pour de plus amples informations sur la manière de configurer la consignation Java, veuillez vous reporter à la documentation Java associée à votre kit Java Development Kit pour java.util.logging.Logger et java.util.logging.FileHandler.
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties votre_programme_java_client_utilisant_l'API_CM