TIBCO BusinessWorks. Ejemplo 2: Proceso con CheckPoint

Construir el proceso “Proceso_VariableGlobal_FichProp_CkeckPoint” basándonos en el Ejemplo 2 Proceso Sin CheckPoint. El aspecto final del proceso será el siguiente:

El objetivo de este ejemplo es ver el comportamiento del proceso del ejemplo anterior una vez añadido una actividad de “CheckPoint”  después de escribir en el log. Como veremos el comportamiento del proceso ante paradas/caídas del motor de BW se modifica de tal forma que los procesos que estaban ejecutándose arrancan desde el estado del último CheckPoint. Esto queda reflejado en el log de actividad donde se ve que las cuentas de 0 a n de los procesos arrancados continúan en el punto en que se encontraban antes de parar el motor.

Pasos para la construcción del proceso:

1. Crear un nuevo proceso “Proceso_VariableGlobal_FichProp_CkeckPoint” basado en el proceso “Proceso_VariableGlobal_FichProp_SinCkeckPoint” realizando copy/paste.
2. Añadir una actividad de CheckPoint después de la actividad de “Log”.
3. Generamos el fichero .EAR para desplegar el ejemplo (es aconsejable haber probado previamente el ejemplo en el modo Test de TIBCO Designer). 

Arrancar el engine correspondiente al despliegue y examinar el fichero de log “/tibco/tra/domain/<nombre_dominio>/application/logs/FormacionAvanzadaBW_Ejemplo2_CheckPoint-Process_Archive.log”.

Observar cómo se realizan cuentas de 0 a n (valor fijado en el fichero de propiedades. Si paramos el motor y re-arrancamos las cuentas comenzaran en el punto donde se detuvieron.

Tareas Generales. Log

2.1    Log

El motor de TIBCO Business Works genera ficheros de actividad o log dónde se muestra información del motor y las excepciones no controladas que se producen en los procesos.

Mediante la actividad Log podemos escribir mensajes en este fichero de log desde los procesos de BW.

2.1.1. Casos de Uso

•    Registro de la actividad de las instancias de proceso.

2.1.2. Configuración

El directorio de los ficheros de Log se fija de diferentes formas dependiendo de dónde se ejecute el proyecto. En fase de desarrollo la configuración se fija con TIBCO Designer, y en la fase de explotación la configuración se puede fijar directamente sobre el fichero .tra correspondiente al despliegue del proyecto.


TIBCO Designer, en el menú Edit --> Preferentes --> General

Este directorio de log se corresponde con el engine que se arranca en el modo Test de TIBCO Designer.


En el fichero de propiedader .tra. 

Los ficheros de configuración de las aplicaciones desplegadas se encuentran en el directorio “/tibco/tra/domain/mvol501/application/<aplicación desplegada>.

Las propiedades referentes a los ficheros de log del engine son:

Engine.Log.Dir=/tibco/tra/domain/mvol501/application/logs

# Maximum number of log files. Rollover feature

Engine.Log.MaxNum=5

# max size of log file in bytes

Engine.Log.MaxSize=20480000

2.1.3 Actividad Write to Log

Esta actividad permite escribir mensajes en el log del engine de BW. Existe un fichero de log por cada motor de BW.

Configuración

Pestaña de configuración:

• Name: Nombre de la etiqueta de la actividad
• Description. Breve descripción de la actividad
• Role. Role definido por el usuario para esta entrada. El Role se utiliza para filtrar las entradas del fichero de role cuando se muestan. El Role también se utiliza para activar/desactivar determinada entradas en el fichero de log.
• Suppress job info. Si se selecciona no se añade información del proceso donde se encuentra la actividad. La información del proceso es: número de proceso, nombre definición de proceso, y nombre de la actividad.

Pestaña de entrada de información a la actividad (Input).

• Message. Mensaje que aparecerá en el fichero de Log.
• MsgCode. Código de error del mensaje.

Esta actividad no genera salida. Pestaña de Error Output.

Propiedades a medida

Permiten controlar que tipos de mensajes se envían al log mediante los roles definidos.

Las propiedades del engine definen los roles para los cuales está habilitada/deshabilitada la escritura en el log de motor. Estas propiedades se fijan en el fichero .tra correspondiente al engine dónde se ejecuta el proyecto.

Las variables para la gestión de los mensajes de traza son:

• Trace.<rol>.log – Con valor “false” se deshabilita la escritura de mensajes en el fichero de log para el rol especificado.
• Trace.<rol>.* - Con valor “false” deshabilita todos los mensajes para el rol especificado. El valor de <rol> puede ser uno de los roles de sistema: WARN, TRACE, DEBUG, or INFO
• Trace.rol.<rol> - Con valor “false” deshabilita la escritura de mensajes para el rol definido por el suario <role>
•  Trace.rol.* - Con valor “false” deshabilita los mensajes para todos los roles de usuario definidos