La consignation de l'API CM ClearQuest est contrôlée à l'aide du fichier logging.properties qui est associé à l'environnement d'exécution Java qui exécute votre application. Le fichier logging.properties est situé dans le répertoire jre\lib de votre kit Java Development Kit.
La consignation est désactivée par défaut. Vous devriez activer la consignation au niveau INFO.
############################################################ # Propriétés globales ############################################################ # # "handlers" indique une liste de classes log Handler séparées # par des virgules. Ces gestionnaires seront installés au démarrage de la MV. # Notez que ces classes doivent se trouver sur le chemin d'accès aux classes du système. # Par défaut, seul un ConsoleHandler est configuré, ce qui n'affichera que les # messages aux niveaux INFO et supérieurs. handlers = java.util.logging.ConsoleHandler # Pour ajouter également le FileHandler, utilisez plutôt la ligne suivante. #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # Niveau de consignation global par défaut. # Indique les types d'événement consignés dans tous # les consignateurs. Pour toute fonction donnée, ce niveau global # peut être remplacé par un niveau de fonction spécifique # Notez que le ConsoleHandler possède également un paramètre de niveau # différent pour limiter les messages imprimés sur la console. # La ligne suivante active la consignation (pour tous les objets de consignateur) au niveau INFO .level=INFO ############################################################ # Propriétés spécifiques au gestionnaire. # Décrit les informations de configuration spécifiques pour les gestionnaires. ############################################################ # CMLogger - Doit toujours être activé au niveau INFO. # # Les lignes suivantes activent la consignation pour l'objet CMLogger au niveau INFO # et indiquent que le fichier de sortie du journal sera nommé CMLogger[#].log, dans le répertoire # HOME de l'utilisateur connecté ; le fichier de sortie du journal alternera sur 20 fichiers, # chacun limité à 20000000 octets. Les entrées de journal seront ajoutées au fichier de sortie # du journal en cours dans la rotation et seront écrites dans un 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 - Active (supprime la mise en commentaire) les entrées ci-dessous pour une utilisation temporaire uniquement, # car le traçage peut utiliser beaucoup de ressources. # # Les lignes suivantes activent le traçage pour l'objet CMTracer au niveau FINER # et indiquent que le fichier de sortie de trace sera nommé CMTracer[#].log, situé dans # le répertoire HOME de l'utilisateur connecté ; le fichier de sortie de trace alternera sur 20 fichiers, # chacun limité à 20000000 octets. Les entrées de trace seront ajoutées au fichier de sortie # de trace en cours dans la rotation et seront écrites dans un 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 génèrent un fichier journal nommé CMLogger[#].log, où [#] désigne le numéro de rotation du fichier. Chaque fichier est situé dans le répertoire HOME de l'utilisateur connecté ; la sortie passe d'un fichier à un autre lorsque chaque fichier est plein.
L'utilisation des entrées logging.properties dans l'exemple précédent indique que les enregistrements de journal sont ajoutés à la fin du fichier applicable et chaque entrée est stockée dans un format simple. Vous devez arrêter et redémarrer l'application pour que les changements apportés au fichier soient reconnus.
Lorsqu'un fichier de sortie du journal est plein, un nouveau fichier est créé et le fichier précédent est renommé de sorte à contenir la date et l'horodatage lorsque la rotation du fichier intervient. Chaque fichier contient 20 Mo de données et les nouvelles entrées sont ajoutées aux entrées existantes, y compris au cours des redémarrages de l'application. Lorsque le nombre de fichiers journaux atteint 20, le basculement vers un nouveau fichier entraîne la suppression du fichier le plus ancien.
Pour plus d'informations sur la configuration de la consignation Java, voir la documentation Javadoc associée à votre kit Java Development Kit pour java.util.logging.Logger et java.util.logging.FileHandler.
Si vous créez un fichier de propriétés de journal personnalisé, vous devez spécifier l'emplacement du fichier à l'aide de l'argument -D. Par exemple :
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties votre_programme_java_client_qui_utilise_API-CM