El registro de la API de ClearQuest CM se controla mediante el archivo logging.properties, asociado con el JRE que se ejecuta en la aplicación. El archivo logging.properties se encuentra en el directorio jre\lib del JDK.
El registro está inhabilitado de forma predeterminada. Debe habilitar el registro en el nivel INFO.
############################################################ # Propiedades globales ############################################################ # # "handlers" especifica una lista separada por comas de clases # de manejadores de registro. Estos manejadores se instalarán # durante el inicio de la VM. Tenga en cuenta que estas clases # deben estar en la vía de acceso de clases del sistema. # De forma predeterminada, solo configuramos un ConsoleHandler, # que solo mostrará los mensajes de los niveles INFO y superiores. handlers = java.util.logging.ConsoleHandler # Para añadir también el FileHandler, utilice en su lugar la # línea siguiente. #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # Nivel de registro global predeterminado. # Especifica qué clases de sucesos se registran en todos # los registradores. Para cualquier recurso determinado, # este nivel global se puede sustituir por un nivel específico # del registro. # Tenga en cuenta que el ConsoleHandler también tiene un valor # de nivel distinto para limitar los mensajes que se visualizan # en la consola. # La línea siguiente habilita el registro (para todos los objetos # de registrador) para que tenga lugar en el nivel INFO .level=INFO ############################################################ # Propiedades específicas del manejador. # Describe información de configuración específica de los manejadores. ############################################################ # CMLogger - Siempre debe estar habilitado en el nivel INFO. # # Las líneas siguientes indican que registro del objeto CMLogger tendrá lugar # en el nivel INFO y que el archivo de salida de registro se denominará # CMLogger[#].log, ubicado en el directorio HOME del usuario que ha iniciado la # sesión; el archivo de salida de registro se asignará de forma rotatoria entre 20 # archivos, cada uno de ellos limitado a 20000000 bytes. Las entradas de registro # se añadirán al archivo de salida de registro actual en la rotación y se # grabarán utilizando un formato 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 - Habilite (Elimine el comentario) de las entradas siguientes solo # para uso temporal, ya que el rastreo puede consumir muchos recursos. # # Las líneas siguientes indican que el rastreo del objeto CMTracer se producirá # en el nivel FINER y que el archivo de salida de rastreo se denominará # CMTracer[#].log, ubicado en el directorio HOME del usuario que ha iniciado la # sesión; el archivo de salida de rastreo se asignará de forma rotatoria entre 20 # archivos, cada uno de ellos limitado a 20000000 bytes. Las entradas de rastreo # se añadirán al archivo de salida de rastreo actual en la rotación y se grabarán # utilizando un formato 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
Estos valores generan un archivo de registro denominado CMLogger[#].log, donde [#] indica el número de rotación de archivo. Cada archivo se encuentra en el directorio HOME del usuario que ha iniciado la sesión; la salida rota de un archivo a otro a medida que cada uno de ellos pasa a estar lleno.
La utilización de las entradas logging.properties en el ejemplo anterior indica que los registros de anotaciones se añaden al final del archivo aplicable, y que cada entrada se almacena en formato simple. Debe detener y reiniciar la aplicación para que se reconozcan los cambios en el archivo.
Cuando un archivo de salida de registro está lleno, se crea un archivo nuevo y el archivo anterior se renombra para que contenga la indicación de fecha y hora a la que se ha producido la rotación de archivo. Cada archivo contiene 20 MB de datos y se añaden nuevas entradas a las entradas existentes, también entre reinicios de la aplicación. Cuando el recuento de archivos de registro llega a 20, la rotación a un archivo nuevo hace que el archivo con mayor antigüedad se suprima.
Para obtener más información sobre cómo configurar el registro de Java, consulte la documentación del Javadoc asociada con el JDK para java.util.logging.Logger y java.util.logging.FileHandler.
Si crea un archivo de propiedades de registro personalizado, debe especificar la ubicación del archivo utilizando el argumento -D. Por ejemplo:
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties el_programa_java_cliente_que_utiliza_API-CM