Registro para el rastreo

Utilice el método registerApplication() para especificar la aplicación que se debe registrar con el rastreo de aplicación.

El método tiene el formato:

int registerApplication(String application_name, String[] format_template)

El argumento application_name es el nombre de la aplicación que desea rastrear. El nombre debe ser el mismo que el de la aplicación especificada al iniciar la JVM. El argumento format_template es una matriz de series de formatos como las series utilizadas por el método printf. Puede especificar plantillas de hasta 16 KB. La posición de la matriz determina el identificador de punto de rastreo (empezando por 0). Puede utilizar estos identificadores para habilitar puntos de rastreo específicos en tiempo de ejecución. El primer carácter de cada plantilla es un dígito que identifica el tipo de punto de rastreo. El tipo de punto de rastreo puede ser uno de entrada, salida, suceso, excepción o salida de excepción. Después del carácter de tipo de punto de rastreo, la plantilla tiene un carácter en blanco, seguido de la serie de formato.

Los tipos de rastreo se definen como valores estáticos dentro de la clase Trace:

public static final String EVENT= "0 ";
public static final String EXCEPTION= "1 ";
public static final String ENTRY= "2 ";
public static final String EXIT= "4 ";
public static final String EXCEPTION_EXIT= "5 ";

El método registerApplication() devuelve un valor entero. Utilice este valor en las llamadas trace() posteriores. Si la llamada al método registerApplication() falla por algún motivo, el valor devuelto es -1.