La registrazione di CM API è controllata tramite il file logging.properties che è associato al JRE su cui viene eseguita l'applicazione. Il file logging.properties si trova nella jre\lib di JDK; ad esempio, C:\Program Files\IBM\WebSphere\AST\eclipse\jre\lib, C:\jdk_5.0\jre\lib o C:\Program Files\Java\jre1.5.0_06\lib).
La registrazione è disabilitata per impostazione predefinita. La registrazione dovrebbe essere abilitata al livello INFO.
############################################################ # Proprietà globali ############################################################ # # "handlers" specifica un elenco separato da virgole di classi di gestori # di log. Questi gestori saranno installati durante l'avvio della VM. # Si noti che è necessario che queste classi si trovino sullo stesso percorso classe di sistema. # Per impostazione predefinita viene configurata solo una ConsoleHandler, che # visualizzerà solo messaggi a livelli di INFO o superiori. handlers = java.util.logging.ConsoleHandler # Per aggiungere anche FileHandler, invece, utilizzare la seguente riga. #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # Livello di registrazione globale predefinito. # Specifica i tipi di eventi registrati su # tutti i logger. Per qualsiasi funzione data, questo livello globale # può essere sovrascritto da un livello specifico di funzione # Si noti che ConsoleHandler dispone inoltre di un'impostazione # di livello separato per limitare i messaggi stampati alla console. # La riga successiva consente la registrazione (di tutti gli oggetti logger) a livello di INFO .level=INFO ############################################################ # Proprietà specifiche del gestore. # Descrive informazioni di configurazione specifiche per i gestori. ############################################################ # CMLogger - Deve essere sempre abilitato a livello di INFO. # # Non è necessario arrestare e riavviare le applicazioni che utilizzano CM API; eventuali modifiche al file # logging.properties configurato vengono automaticamente rilevate e applicate, entro 10 secondi. # # Le seguenti righe indicano che la registrazione dell'oggetto CMLogger avviene a livello di INFO # e che il file di output di log sarà denominato CMLogger[#].log e ubicato nella directory HOME # dell'utente che ha effettuato l'accesso; il file di output di log sarà fatto ruotare su 20 file, ognuno dei quali # è limitato a 20000000 byte. Le voci di log saranno accodate al file di output del log corrente # nella rotazione e saranno scritte utilizzando un formato semplice. # 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 - Abilitare (Eliminare il simbolo di commento) le voci che seguono solo all'utilizzo temporaneo perché la traccia # può utilizzare molte risorse. # # Non è necessario arrestare e riavviare le applicazioni che utilizzano CM API; eventuali modifiche al file # logging.properties configurato vengono automaticamente rilevate e applicate, entro 10 secondi. # # Le seguenti righe indicano che la traccia dell'oggetto CMTracer avviene a livello di FINER, # e che il file di output di traccia sarà denominato CMTracer[#].log e ubicato nella directory HOME # dell'utente che ha effettuato l'accesso; il file di output di trace sarà fatto ruotare su 20 file, ognuno dei quali # è limitato a 20000000 byte. Le voci di traccia saranno accodate al file di output di traccia corrente # nella rotazione e saranno scritte utilizzando un formato semplice. # #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
Queste impostazioni risultano in un file di log denominato CMLogger[#].log, dove [#] indica il numero di rotazione del file. Ogni file è ubicato nella directory HOME dell'utente che ha effettuato l'accesso; l'output passa da un file all'altro mano a mano che ciascuno raggiunge la dimensione massima.
L'utilizzo delle voci logging.properties nell'esempio precedente indica che i record di log sono accodati all'estremità del file applicabile e che ciascuna voce viene memorizzata in formato semplice. Le modifiche apportate al file logging.properties sono riconosciute dall'applicazione basata su CM API all'incirca entro 10 secondi. Non è necessario arrestare e riavviare l'applicazione.
Quando un file di output di log ha raggiunto la dimensione massima, viene creato un nuovo file e quello precedente viene rinominato per contenere l'indicazione di data e ora in cui è stata eseguita la rotazione. Ogni file contiene 20 MB di dati e le voci nuove vengono accodate a quelle esistenti, compresi i riavvii delle applicazioni. Quando il conteggio dei file di log raggiunge il valore 20, la rotazione a un nuovo file determina l'eliminazione del file meno recente.
Per ulteriori informazioni su come configurare la registrazione Java, consultare la documentazione Javadoc associata a JDK per java.util.logging.Logger e java.util.logging.FileHandler.
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties your_client_java_program_that_uses_CM-API