A criação de log do ClearQuest CM API é controlada usando o arquivo logging.properties associado ao JRE que é executado no seu aplicativo. O arquivo logging.properties é localizado no diretório jre\lib do seu JDK.
A criação de log é desativada, por padrão. Você deve ativar a criação de log no nível INFO.
############################################################ # Propriedades globais ############################################################ # # "manipuladores" especificam uma lista separada por vírgula de classes de Manipulador de # logs. Esses manipuladores serão instalados durante a inicialização da VM. # Observe que essas classes devem estar no caminho de classe do sistema. # Por padrão, configuramos apenas um ConsoleHandler, que apenas # mostrará mensagens nos níveis INFO e acima. manipuladores = java.util.logging.ConsoleHandler # Para incluir também o FileHandler, use a linha a seguir. #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # Nível de criação de log global padrão. # Isso especifica quais tipos de eventos são registrados entre # todos os criadores de log. Para qualquer recurso dado, esse nível global # pode ser substituído por um nível específico de recurso # Observe que o ConsoleHandler também possui uma configuração de nível separado # para limitar as mensagens impressas para o console. # A próxima linha ativa a criação de log (para todos os objetos do criador de logs) para ocorrer no nível INFO .level=INFO ############################################################ # Propriedades específicas do manipulador. # Descreve informações de configuração específicas para os Manipuladores. ############################################################ # CMLogger - Sempre deve estar ativado no nível INFO. # # As linhas a seguir designam a criação de log do objeto CMLogger para que ocorra no nível INFO, # e que o arquivo de saída do log seja denominado CMLogger[#].log, localizado no diretório HOME do # usuário conectado; o arquivo de saída do log rodará por 20 arquivos, cada arquivo sendo # limitado a 20000000 bytes. As entradas de log serão anexadas ao arquivo de saída de log atual # na rotação e serão gravadas usando um formato simples. # 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 - Ativar (remover comentário) as entradas abaixo para uso temporário apenas, pois o rastreio # pode ser intenso para o recurso. # # As linhas a seguir designam o rastreio para o objeto CMTracer para que ocorra no nível FINER, # e que o testamento de saída de rastreio seja denominado CMTracer[#].log, localizado no diretório HOME do # do usuário conectado; o arquivo de saída de rastreio rodará por 20 arquivos, cada arquivo sendo # limitado a 20000000 bytes. As entradas de rastreio serão anexadas ao arquivo de saída de rastreio atual # na rotação e serão gravadas usando um formato simples. # #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
Essas configurações resultam em um arquivo de log denominado CMLogger[#].log, em que [#] designa o número de rotação do arquivo. Cada arquivo é localizado no diretório HOME do usuário conectado. A saída rola de arquivo para arquivo conforme cada um fica completo.
O uso das entradas logging.properties no exemplo anterior designa que os registros de log sejam anexados ao final do arquivo aplicável e cada entrada seja armazenada em um formato simples. Você deve parar e reiniciar o aplicativo para que as mudanças no arquivo sejam reconhecidas.
Quando um arquivo de saída de log estiver completo, um novo arquivo será criado e o arquivo anterior será renomeado para conter o registro de data e hora de quando ocorreu a rotação do arquivo. Cada arquivo retém 20 MB de dados e novas entradas são anexadas às entradas existentes, incluindo nas reinicializações do aplicativo. Quando a contagem do arquivo de log atinge 20, a rotação para um novo arquivo faz com que o arquivo mais antigo seja excluído.
Para obter mais informações sobre como configurar a criação de log Java, consulte a documentação de Javadoc associada ao seu JDK para java.util.logging.Logger e java.util.logging.FileHandler.
Se você criar um arquivo de propriedade de criação de log customizado, você deverá especificar o local do arquivo usando o argumento -D. Por exemplo:
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties your_client_java_program_that_uses_CM-API