Você está na página 1de 15

Agendador de tarefas

LOGIX
Rev.00 03/02/2010

TOTVS Unidade Joinville


Av. Santos Dumont, 831 Bairro Bom Retiro
Fone: (47) 2101-3000 Fax: (47) 2101-3001
89222-9000 Joinville Santa Catarina
www.totvs.com.br

Agendador de tarefas Logix

NDICE
1.

Agendador de tarefas ............................................................................................. 1

2.

Logix Scheduler ...................................................................................................... 6

3.

Registro de execuo do gatilho ............................................................................ 7

4.

Monitoramento das execues X Visualizador de registro de execuo ........... 8

5.

Consulta/filtro para visualizar histrico de execuo por gatilho ..................... 9

6.

Regras para implementao de um JOB ............................................................ 10

LOGIX

Agendador de tarefas Logix

1.

Agendador de tarefas

At o momento, utilizava-se o crontab para agendamentos no Linux, e o programa Tarefas


agendadas para agendamentos no Windows. No Logix 10 o agendamento de rotinas do ERP ser
feito no prprio Logix.
O agendador de tarefas pode ser cadastrado no programa JOB0003 (Agendador de tarefas).
Por meio desse programa possvel cadastrar todas as informaes necessrias da tarefa que ser
executada.
Tecnicamente essas informaes so chamadas de gatilhos.

A partir das informaes cadastradas algumas regras podem ser estabelecidas, como por exemplo,
especificar se a forma de aviso ser Avisar sempre, Avisar somente quando houver erro ou
No avisar.
No JOB0003 essas informaes so selecionadas no campo Envia e-mail, como mostra a figura
abaixo:

LOGIX

Agendador de tarefas Logix

Na seo Especificao de Execuo possvel cadastrar as informaes de agendamento,


conforme mostram as figuras abaixo:
a) Especificao de execuo
Possibilita que seja especificado o perodo que o gatilho (JOB) ser executado, as especificaes
so semelhantes s disponveis no crontab do Linux.

b) Especificao da data inicial e data final da execuo do gatilho


2

LOGIX

Agendador de tarefas Logix

c) Especificao dos perodos de execuo

d) Especificao das tarefas a serem executadas

LOGIX

Agendador de tarefas Logix

e) Especificao de seqncia dependente por tarefa


Para esse caso, podero ser cadastradas tarefas que so pr-requisitos uma das outras.
Exemplo: programas que emitem relatrio. Primeiramente deve-se executar a rotina que prepara a
base de dados, e essa rotina estando concluda, iniciada a rotina que procede com a emisso do
relatrio.

LOGIX

Agendador de tarefas Logix

Em relao aos gatilhos, esses s podero ser modificados ou excludos se estiverem com situao
Pendente ou Inativo, estando com a situao Andamento a excluso no ser permitida.
Ao tentar modificar ou excluir um gatilho, algumas mensagens de erros sero exibidas:

LOGIX

Agendador de tarefas Logix

2.

Logix Scheduler

Scheduler um programa executado em background que verifica os agendamentos das tarefas.


Antes de iniciar o servidor TOTVS Tec algumas configuraes devem ser feitas no Logix
Scheduler, veja a seguir:

[ONSTART]
Seo para iniciar o Logix Scheduler automaticamente quando o Servidor TOTVS Tec for
iniciado.
Jobs=4GLJOB1
Referncia do JOB que ser executado.
[4GLJOB1]
Detalhamento da referncia citada no OnStart.
Environment=logix102
Nome do ambiente onde os JOBs sero executados.

LOGIX

Agendador de tarefas Logix

Main=jobStarter
Nome do programa (ADVPL) que dever ser executado em modo JOB.
[logixscheduler]
Seo para configurao do Logix Scheduler.
ScheduleEnable=1
Habilita ou no a execuo do Logix Scheduler.
JobLogEnable=1
Habilita ou no a gerao do arquivo de LOG de execuo.
JobLogPath=c:\logix\lst
Define o caminho onde os arquivos de LOG sero gerados.
LoopLoadJob=33
Define a quantidade de verificaes a serem feitas at a prxima atualizao da lista de
execuo (select no BD).
Valor padro (mnimo) para no sobrecarregar o TOTVS Tec.
VerifyJobInterval=55
Tempo (em segundos) entre cada verificao (sleep)
Valor padro (mnimo) para no sobrecarregar o TOTVS Tec.
JOBMonitorAutoRefresh=5
Tempo (em segundos) para atualizao automtica das informaes de execuo dos gatilhos
(JOBs) no monitor de execues de gatilhos.
LicenseCompanyID=01
O valor do cdigo da empresa no LOGIX e precisa ser vlido.
LicenseUserid=admlog
O valor do login do usurio LOGIX a precisa ser vlido e de preferncia um usurio que tenha
permisso de acesso total ao sistema LOGIX, para no gerar erro de permisso de acesso de
execuo para os agendamentos de execuo de aplicaes.

Estas 2 novas chaves so necessrias para validao do controle de licenas do


sistema.

3.

Registro de execuo do gatilho

De acordo com a informao selecionada no campo Envia e-mail, o aviso das execues poder
ser enviado por e-mail quando a execuo de um gatilho estiver concluda, como mostram as
figuras abaixo:

LOGIX

Agendador de tarefas Logix

4.

Monitoramento das execues X Visualizador de registro de execuo

Na aba Monitoramento so exibidos os gatilhos (JOBs) que esto sendo executados.

Na aba Registro Execuo so consultados os histricos dos gatilhos (JOBs) que j foram
executados.

LOGIX

Agendador de tarefas Logix

5.

Consulta/filtro para visualizar histrico de execuo por gatilho

Os filtros sero exibidos de acordo com as informaes selecionadas na tela abaixo:

Por meio da tela abaixo possvel consultar o status de finalizao na execuo do gatilho.
Os possveis status so Andamento, Interrompido, Cancelado ou Finalizado.

LOGIX

Agendador de tarefas Logix

6.

Regras para implementao de um JOB

O programa JOB dever obrigatoriamente ter uma funo de chamada JOB e receber um
parmetro do tipo CHAR(6), no padro: <nome_do_programa>_job(l_rotina)
Exemplo:
FUNCTION log9001_job(l_rotina)
...
RETURN 0
END FUNCTION

O parmetro rotina passado por parmetro, possibilita a definio de vrias rotinas JOBs
em um nico arquivo de programa. A rotina a ser executada informada no JOB0003,
associada ao nome do programa.
Exemplo:
FUNCTION log9001_job(l_rotina)
CASE l_rotina
WHEN JOB1
...
WHEN JOB2
...
END CASE
...
RETURN 0
END FUNCTION

A funo JOB dever obrigatoriamente retornar (RETURN) um STATUS de erro, sendo 0


(ZERO, no houveram erros) ou diferente de ZERO, caso tenha ocorrido algum erro. Esse
retorno define o que ser gravado no registro de execuo, se o gatilho (JOB) foi executado
com sucesso ou no.
Exemplo de implementao de um JOB

10

LOGIX

Agendador de tarefas Logix

Exemplo disponvel em: http://suporte.logocenter.com.br/faq/?View=entry&EntryID=842 .

Quadro de Revises
Reviso Descrio da alterao
00
Inicial.

Data
03/02/10

LOGIX

11