Vous êtes sur la page 1sur 7

HotWatch

Fecha Actualizacin: 23 Septiembre 2009

Captulo 1 Introduccin

HotWatch es un ejecutable que est constantemente sensando (de acuerdo al tiempo indicado) la adicin de un nuevo archivo a la carpeta indicada. Los archivos encontrados sern procesados de acuerdo a la entrada de configuracin. Si se desea obtener el return estatus de los procesos ejecutados, NO deber colocarse el parmetro a, ya que este indica que el proceso sea asncrono, no permitiendo obtener la respuesta de los procesos asociados.

Sintaxis:
HotWatch [<-d>] [<-e>] [<-v>] [<-l>] [<-t>] <-p> [<-a>] [<-w> ruta1 ruta2 rutan] [<-b> NombreHW.log] [<-g>] [<-y>] [<-proc> Nmero Procesos]

Donde:
[<-d>] Parmetro opcional que en caso de existir, borrara los archivos que
se reciban en la bandeja indicada para su procesamiento.

[<-e>] Parmetro opcional que indica la lista de extensiones de archivos


que sern procesados. Las extensiones estarn divididas por espacios en blanco, siendo el nmero ilimitado de las mismas.

[<-v>] Parmetro opcional referido a la ruta donde se encuentran los


archivos que sern procesados. Por default toma la ruta corriente donde se encuentre el ejecutable del componente.

[<-l>] Parmetro opcional que indica el tiempo de poleo en milisegundo.


Por default es de 2000 milisegundos.

[<-t>] Parmetro opcional que indica la lista de horarios en que se iniciar


el procesamiento. Las horas debern estar divididas por espacios en blanco, siendo el nmero ilimitado de las mismas. As mismo, los horarios debern ser

establecidos en formato de 24 horas.

<-p> Parmetro requerido que indica el nombre del ejecutable al que se


le entregarn los archivos. En caso de que el ejecutable se encuentre en una ruta diferente a la corriente, se deber poner su nombre con todo y su ruta.

[<-a>] Parmetro opcional que indica que el proceso ser asncrono,


siendo por default sncrono.

[<-w> ruta1 ruta2 rutan] Parmetro opcional que indica la(s) ruta(s) de
trabajo que usar el ejecutable especificado en la opcin p. Si no se especifica usa el mismo directorio corriente de HotWatch. Si se indica ms de una ruta, los procesos sern repartidos a las diferentes rutas de trabajo.

[<-b>] Parmetro opcional que indica que el nombre del archivo log ser
indicado, en caso de no existir, se crear el nombre del log como HotWatch.log.

[<-g>] Parmetro opcional que indica que el rastreo de cada archivo que
se procesa, ser escrito en el log.

[<-y>] Parmetro opcional que indica el tiempo en milisegundos entre


cada procesamiento.

[<-proc> Nmero Procesos] Parmetro opcional usado cuando el


proceso es asncrono, el cual permite indicar el nmero mximo de procesos que podrn estarse ejecutando a la vez.

Ejemplo:
HotWatch -d -e prn txt -v c:\\itc -l 3000 -t 10:30 22:30 -p Ejecutor.exe -a w \ITC\Ejecutor \ITC1\Ejecutor b NombreLog. log g y 3000 proc 10 El parmetro -d indica que los archivos sern eliminados de su carpeta origen. El parmetro -e prn txt indica que los archivos con extensin 'txt' y 'prn' son los nicos que sern tomados en cuenta para su procesamiento. El parmetro -v c:\\itc indica la ruta origen donde se encuentra el ejecutable HotWatch.exe. El parmetro -l 3000 indica que el tiempo de poleo ser de 3000 milisegundos. El parmetro -t 10:30 22:30 indica que a las 10:30 de la maana y a las 22:30 de la noche se procesarn los archivos que existan en ese momento en la carpeta origen. El parmetro -p Ejecutor.exe indica que cada archivo ser entregado al Ejecutor.exe (ejecutable).

El parmetro -a indica que el proceso ser asncrono, esto es, que no se esperar hasta que cada archivo termine su ejecucin. El parmetro w indica que el proceso Ejecutor.exe se encuentra en la ruta de trabajo \ITC\Ejecutor\ y en la ruta \ITC1\Ejecutor\ en las cuales sern repartidos los procesos. El parmetro b indica que el log se llamar NombreLog.log. El parmetro g indica que se escribir al log el rastreo de los archivos. El parmetro y indica que cada 3000 se procesar un archivo. Si es sncrono, cada 1 archivo esperar 3000 milisegundos, si es asncrono cada 3000 milisegundos ejecutar un paquete de archivos. El parmetro proc 10 indica que 10 es el nmero mximo de procesos en el stack para ejecutarse en un mismo tiempo, conforme estos terminen, la pila se llenar de nuevos procesos a ejecutar, sin rebasar el nmero mximo de 10 procesos.

Captulo 2 Consideraciones Generales


Eliminacin de archivo de entrada y Sincrona La opciones -a y -d son excluyentes ya que para procesos asncronos (-a) el proceso padre (HotWatch) no sabe cuando terminarn sus hijos (Ejecutor, Detector, Split, etc.), por lo que borrar el archivo de entrada puede causar errores de procesamiento de dichos procesos hijos. Notas

Cuando se use la opcin de llamada asncrona a procesos hijos el responsable de borrar el archivo de entrada cuando no se necesite es el ltimo proceso en el flujo. HotWatch no borrar los archivos aunque se le especifique la opcin -d, si se especific tambin la opcin -a.

Instalacin de HotWatch como servicio Cuando HotWatch o cualquier componente se instale como servicio, se debe tomar en cuenta que los servicios carecen de interfase grfica de usuario (GUI) ya que trabajan sin necesidad de un login. Por lo que llamadas a programas con interfase grfica dentro de un servicio provoca que el proceso sea llamado pero la UI nunca ser vista en pantalla. Si el servicio espera por la terminacin de estos procesos, entonces esperar indefinidamente. Notas

Llamadas a programas como HForms, WMess, DocuBrowser y otros componentes con interfase grfica desde HotWatch dejarn esperando indefinidamente. Si el programa tiene interfase grfica pero termina por si mismo, no provoca ningn problema ya que HotWatch contina con su procesamiento despus que el proceso termina. Ejemplo: HForms p

Captulo 3 Cdigos de Retorno


HotWatch maneja los siguientes cdigos de error de retorno al proceso que lo llama:

Cdigo
DET_OK DET_BAD_SYNTAX DET_FILE_NOT_FOUND DET_LINE_NOT_FOUND DET_COMMAND_NOT_FOUND

Observacin
Ejecucin correcta Error de sintaxis Archivo no encontrado Error Interno. Lnea no encontrada. Comando no encontrado. La opcn p no ha sido especificada Comando no ha podido ser ejecutado. El programa especificado en p no existe o no ha podido ser ejecutado. Comando present error en ejecucin. El programa especificado en la opcin p si pudo ser ejecutado pero devolvi un cdigo de error. Se debe checar el log del proceso llamado.

Valor
0 601 602 603 604

DET_COMMAND_NOT_EXECUTED

605

DET_COMMAND_ERROR_EXECUTION

606