Schedule

Produto Data da criao Pas(es) FNC : Microsiga Protheus - Configurador V10 Chamado 13/02/09 : Todos : 000000079122008 Data da reviso Banco de Dados : SAP569 29/03/10 : Todos

O novo Schedule introduz alguns conceitos de arquitetura e funcionamento diferentes dos utilizados atualmente. Esta nova ferramenta formada por trs componentes principais: Manager: componente responsvel por fazer o gerenciamento das tarefas, bem como o controle de gerao das tarefas e das filas de execues (Task e Queue). Agent: este componente gerencia as execues e distribu as tarefas para as Executes configuradas que esto disponveis para utilizao. Os agents podem estar localizados em diferentes servidores, possibilitando a distribuio da carga de execues. Execute: so os componentes responsveis por fazer a execuo das tarefas. a nica entidade que consome licena. Esse consumo de licena se d apenas durante a execuo de uma tarefa.

O Novo Schedule atende a todas as funcionalidades do Schedule antigo mais algumas implementaes. Dentre as novidades esto: Nova interface; Distribuio de Agents em servidores distintos; Monitoramento das execues; Possibilidade do aumento das Executes disponveis em cada Agent, de acordo com a demanda. Facilidade no agendamento de tarefas multi-empresa/filial; Facilidade na disponibilizao de novas rotinas para agendamento; Monitoramento em tempo real da execuo de tarefas. Log de execues. Importao dos agendamentos do Schedule anterior. Monitor de integrao com ERPs.

SIGACFG Schedule 1

Limpeza das tabelas utilizadas

Este boletim tcnico est dividido em sees, que detalham todas as atividades do Schedule que podem ser desempenhadas pelo administrador e usurios do Microsiga Protheus, sendo apresentados os seguintes tpicos: Seo 1 Procedimentos para utilizao do Schedule. Seo 2 Configurao de agents. Seo 3 Cadastro de agendamentos. Seo 4 Monitor de servios. Seo 5 Monitor de agents. Seo 6 Monitor de agendamento. Seo 7 Importao dos registros do Schedule antigo. Seo 8 Monitor de integrao com ERPs. Seo 9 Limpeza das tabelas utilizadas

Seo 1 - Procedimentos para Utilizao

Para utilizar a rotina do Schedule, o menu deve ser alterado. Para realizar esse procedimento: 1.Acesse o mdulo Configurador. 2.Desmarque todos os menus, selecione Configurador e clique em OK. 3.Adicione todos os itens do menu atual para o novo menu. Clicando no item Configurador da rvore esquerda e logo aps em adicionar. 4.Dentro do Novo Menu, procure por Schedule dentro de Ambiente. 5.Clique sobre a opo Schedule, e, em seguida em Detalhes localizado na Barra de Botes central. 6.Altere o nome do programa de MSSCHEDULE para CFGA010 e confirme a alterao clicando em OK. 7.Depois clique na opo Monitor, e, depois, no boto Remover que se encontra na Barra de Botes central. 8.Realize a gerao do menu clicando no boto Gerar, localizado na Barra de Botes central. Salve o arquivo com nome SIGACFG e feche o mdulo Configurador. Para iniciar a utilizao do Schedule: 1. Acesse o mdulo Configurador > Ambientes > Schedule > Schedule: 2. Na viso inicial, selecione Schedule.

2 SIGACFG Schedule

3.Selecione a opo Iniciar todos os servios. 4.O processo de monitoramento das tarefas do Schedule ser iniciado. Automaticamente, o arquivo de configurao do Microsiga Protheus alterado. As chaves includas no arquivo .INI so:

[ONSTART] RefreshRate=180 jobs=_SCHDMANAG,_SCHDQUEUE

[_SCHDMANAG] Main=_SCHDMANAG Environment=Ambiente Protheus

[_SCHDQUEUE] Main=_SCHDQUEUE Environment=Ambiente Protheus

Seo 2 Configurao de agents

Para que as tarefas possam ser executadas, necessrio que exista um agent cadastrado com a empresa equivalente. Para configurar os agents: 1. Acesse Schedule > Agent > Cadastro. O novo Schedule permite que agents sejam adicionados automaticamente. Na Barra Superior, o boto Adicionar Agent (+) adiciona um agent para cada empresa existente no cadastro de empresas. Cada agent cadastrado j vem configurado com duas threads. possvel verificar os status dos agents clicando na Legenda. possvel incluir agents manualmente. Para isso, clique no cone (+) localizado na janela inferior. Alm disso, nesta mesma barra, tambm possvel solicitar alterao e excluso (x) de um agent.

SIGACFG Schedule 3

Obs.: recomendvel que seja utilizado sempre o endereo IP e no o alias de rede. Ex.: Correto: 172.16.75.160, No recomendvel: maquina_01.

Seo 3 Cadastro de Agendamentos

1. Para cadastrar agendamentos, acesse Agendamentos, Cadastro. 2. No cadastro de agendamentos possvel importar os registros do Schedule antigo para o novo Schedule. Clique no primeiro boto da tela "Importar agendamentos antigos". Obs.: A importao realizada apenas uma vez. Para isso as tabelas do Schedule antigo, SX4 e SXM, so alteradas. includo um campo chamado X4_IMPORT ou XM_IMPORT respectivamente, que sinaliza se o registro foi ou no importado. 3. Na Barra Superior da pasta Detalhes possvel adicionar (+), alterar (lpis) e excluir (x) um agendamento. 4. Para selecionar uma rotina, posicione o cursor sobre o campo Rotina e, em seguida, clique no boto de interrogao (?). 5. Aps informar a rotina, se ela estiver dentro dos padres determinados para agendamento, ser necessrio informar os parmetros. Se a tela de parmetros no se abrir automaticamente basta clicar no boto Parmetros.

6. Para agendar um processo especial (que no esteja dentro dos padres de Schedule), basta informar a rotina e informar os parmetros entre parnteses para que sejam lidos. Ex.: u_teste( par01, par02 ). 7. O novo Schedule possibilita a seleo de mais de uma empresa e filial para a execuo de tarefas durante o cadastramento de um agendamento.

8. O campo Empresa/Filial possui recurso de pesquisa de opes para facilitar o preenchimento. Este campo permite selecionar mltiplas Empresas/Filiais para preenchimento. 9. Para agendar uma rotina, preciso informar o mdulo que ser utilizado para a execuo. Esse mdulo pode ser informado diretamente (se o usurio souber o cdigo relacionado), ou pode ser feita uma pesquisa ativando-se o F3 do campo.

10. Para informar uma recorrncia para um agendamento, clique em Recorrncia, localizado na janela inferior dessa viso. 11. Para recorrncia existem cinco tipos: Diria: informe o perodo de dias a ser considerado, assim como o nmero de execues por perodo, o intervalo e a data de trmino, se houver. Semanal: informe os dias da semana a serem considerados, assim como o nmero de execues por perodo, o intervalo e a data de trmino, se houver.

4 SIGACFG Schedule

Mensal: informe o ms a ser considerado, assim como o nmero de execues por perodo, o intervalo e a data de trmino, se houver. Anual: informe o ano a ser considerado, assim como o nmero de execues por perodo, o intervalo e a data de trmino, se houver. Sempre ativo: Esta opo mantm a rotina agendada em funcionamento contnuo at a data de trmino, se houver.

Para informar a quantidade de execues em um mesmo dia, existe os campos: Nmero de Execues no mesmo dia; Intervalo e Execues.

Alm de informar a quantidade de execues preciso indicar o intervalo entre elas. O mnimo permitido de 15 minutos. O recurso Execues, exibe em uma lista a hora de cada execuo. Para essa recorrncia pode ser informado que existe uma data de trmino ou no. Para realizar filtros no browse onde os agendamentos so exibidos, utilize o boto de filtro, localizado na parte superior do browse. possvel realizar buscas no browse a partir da opo Buscar localizada acima do browse de agents. Esse mesmo cadastro pode ser realizado atravs das prprias rotinas. Mas, para isso o usurio deve possuir permisso de agendamento e gerao de arquivo no servidor. O cadastro segue o mesmo princpio.

Seo 4 Monitor de Servios

1. Existem dois servios que j configurados no Schedule. O Servio de Verificao de Agendamentos: este servio responsvel por monitorar os agendamentos e gerar as tarefas para execuo. O Servio de Gerenciamento de Filas: este servio responsvel por fazer a distribuio das tarefas entre os agents configurados. Estes servios podem ser visualizados na viso inicial, no browse localizado na parte superior da tela. Para realizar o gerenciamento dos servios existe uma barra de botes localizada acima do browse de servios: O primeiro boto permite iniciar todos os servios de uma s vez. O segundo inicia servios especficos.
SIGACFG Schedule 5

O terceiro boto interrompe todos os servios de uma vez. O quarto boto interrompe um servio por vez. Devido complexidade de manipulao dos agents, bem possvel que seja necessrio solicitar a atualizao de status. Para isso, clique em Atualizar.

Seo 5 Monitor de Agents

Na primeira viso de agent, so exibidas as informaes sobre o status do agent e sobre os eventos de cada um. No browse localizado na parte superior da tela, so exibidos todos os agents configurados, seu status e a data e hora da ultima utilizao. Para realizar o gerenciamento dos agents existe uma Barra de Botes acima do browse de servios, O primeiro boto permite iniciar todos os servios de uma s vez. O segundo inicia servios especficos. O terceiro boto interrompe todos os servios de uma vez. O quarto boto interrompe um servio por vez. Devido complexidade de manipulao dos agents, bem possvel que seja necessrio solicitar a atualizao de status. Para isso clicar no ltimo boto, Atualizar. No browse localizado na parte inferior da tela so exibidas as informaes sobre os eventos de cada agent. As informaes sobre os eventos podem ser atualizadas atravs pelo boto Atualizar. Para fazer o controle do funcionamento de cada thread acesse Schedule > Agent > Monitor. O browse superior exibe as mesmas informaes contidas na viso inicial. Os agents configurados, status e data e hora da ultima utilizao. Para realizar o gerenciamento dos agents existe uma Barra de Botes localizada acima do browse de servios, com as mesmas funcionalidades daS existentes na viso inicial. No browse localizado na parte inferior dessa viso possvel visualizar todas as threads configuradas para cada agent com seu status, e o que esta sendo processado em tempo real. A Barra de Botes localizadas acima do browse possibilita o aumento das threads, utilizando o boto Aumentar Nmero de Threads (+), ou a diminuio das threads, utilizando o boto Diminuir Nmero de Threads (-). Para atualizar as informaes das threads utilizar o boto Atualizar.

Seo 6 Monitor de Agendamentos

6 SIGACFG Schedule

Na viso inicial do Schedule possvel visualizar todas as tarefas que esto na fila de execuo. Essas tarefas esto em um browse localizado na parte inferior da tela. Para realizar filtros no browse onde as tarefas so exibidas, utilize o boto de Filtro, localizado na parte superior do browse. possvel realizar buscas no browse a partir da opo Buscar localizada acima do browse de tarefas. Os detalhes de cada status podem ser visualizados clicando duas vezes no browse. Na viso inicial de Agendamentos so exibidos todos os agendamentos configurados, que tambm consta com as opes Filtro e Buscar. Os detalhes de cada status podem ser visualizado clicando duas vezes no browse para a exibio da Legenda. Um agendamento pode ser executado a qualquer momento, utilizando o boto Executar Agora (>). Para visualizar as informaes dos agendamentos, acesse Schedule > Agendamentos > Monitor . Na primeira janela localizada na parte superior da tela, so listados todos os agendamentos e seus status, que tambm conta com as opes de Filtro e Buscar e Legenda, assim como as demais janelas. Na janela central, so exibidas as tarefas geradas por cada agendamento: No painel inferior so visualizados os eventos da tarefa selecionada.

Seo 7 Importao de Registros do Schedule Antigo

Para importar os agendamentos do Schedule basta utilizar a opo Importar Agendamentos Antigos. 1. Acesse: Schedule > Agendamentos > Cadastros e clique no primeiro boto.

Seo 8 Monitor de Integrao com ERPs

1. Para realizar o monitoramento das transaes entre o Protheus e os demais ERPs, basta ir at a viso EAI. Na parte superior da tela so visualizadas todas as transaes. Caso uma transao falhe, possvel recoloc-la na fila clicando no boto Tentar Novamente. Para realizar filtros no browse onde as transaes so exibidas, utilizar o boto de Filtro, localizado na parte superior do browse. Os detalhes de cada status podem ser visualizado clicando-se duas vezes no browse. No painel inferior so visualizados os eventos da transao selecionada. possvel atualizar os eventos utilizando o boto Atualizar.

SIGACFG Schedule 7

Seo 9 Limpeza das Tabelas Utilizadas

1.Para fazer a limpeza das tabelas utilizadas pelo Schedule, acesse Schedule> Limpeza de Tabelas. 2. Selecione a Tabela. 3.Para limpar registros necessrio realizar um filtro anteriormente, utilizando o boto Filtro. 4.Aps a verificao dos dados filtrados utilizar o boto Excluir registros (x). 5.Ateno aps a excluso com o Schedule, os registros ainda no foram deletados fisicamente. Para que isso acontea necessrio que todos os usurios e servios do Microsiga Protheus sejam finalizados; ou seja, preciso ter acesso exclusivo s tabelas para efetuar a deleo fsica dos registros.

Informaes Tcnicas
XX0 Agents XX1 Agendamentos XX2 Agendamentos X Empresa-Filial XX3 EAI XX4 Configurao EAI/ _SCHDTSK Tarefas geradas pelo agendamento SXH Event Viewer/ SXI - RSS cfga010.prw Windows/Linux 000000775522008

Tabelas Utilizadas

Rotinas Envolvidas Sistemas Operacionais Nmero do Plano

8 SIGACFG Schedule