Logística - Linha Protheus - GFE - Parametrização do programa CD0433 - Monitor de Integração, para execução batch RPW

Tempo aproximado para leitura: 00:02:00 min

Dúvida
Como parametrizar o programa CD0433 - Monitor de Integração, para execução batch RPW - Remote Procedure Wait?

Ambiente
TOTVS Logística - TOTVS Frete Embarcador (Linha Protheus) - Gestão de Frete Embarcador (SIGAGFE) - Todas as Versões

Solução
O ERP- Enterprise Resource Datasul utiliza o programa CD0433, para buscar as informações do SIGAGFE e atualizar no ERP Datasul. Entre as operações estão as integrações com Contas a Pagar, Obrigações Fiscais e Recebimento - Notas de Rateio. Este programa possui uma rotina de execução contínua, que monitora a base de dados do Totvs GFE, e há três formas de execução: on-line, batch RPW e execução em background - fundo da tela.
Em caso de execução de forma on-line ou background, enquanto a sessão do programa estiver aberta, será realizada atualização. Caso seja finalizada a sessão, o processo de atualização é paralisado.
Para a execução de forma batch, utiliza-se do RPW, com o conceito de Agenda Automática, tipo Genérica. Para isso, realize o seguinte procedimento:

1. Execute o programa CD8600 - Agenda Automática e selecione a pasta Genéricos, incluindo para o programa CD0433 uma agenda. Nesse programa, é definida a periodicidade de execução do programa CD0433.
   
   
2. Após a criação da agenda, execute o programa CD0433, no botão Agendar Execuções via RPW,  clique na janela de criação de pedido que deseja utilizar agenda genérica. Confirmando a criação do primeiro pedido de execução, através do programa de Ativação do Servidor de Execução - BTB908ZA, o pedido será executado, serão criados novos pedidos conforme a parametrização realizada no programa CD8600.
   
   
3. Em caso de paralização da execução da agenda, para identificar a causa, execute o programa CD8600, localize a agenda do programa CD0433 e verifique incialmente se alcançou o termino da agenda. Nesse caso precisa ser alterado para um prazo maior de Expiração. Caso a agenda estiver ativa, localize o último pedido executado, anotando o seu número. Em seguida, execute o programa BTB001AA- Monitor Pedido Execução e localize o pedido. Ao clicar na opção Detalhe, consulte os detalhes da execução do pedido e verifique o conteúdo do botão ERRO.
   Com a mensagem de erro identificada, providencie a correção para então executar novamente o programa CD0433 e criar um novo pedido Item 2.

Importante
Quando agendamos o CD0433 no RPW podemos informar a recorrência do agendamento. Por exemplo, o agendamento do RPW pode ser de 5 em 5 minutos.
Mas para cada execução do CD0433 a própria rotina do programa contém um número de interações que  irá processar. Por padrão, esse número é 10.
Veja um exemplo. O programa está agendado para executar às 08 horas. Nesse momento, ele irá processar o CD0433 uma vez apenas. O programa, por sua vez, irá fazer 10 vezes o processamento de todo o grupo de opções selecionadas, Documento Frete Fiscal, Documento Frete Rateio e outros.  Terminando o processamento do grupo marcado por 10 vezes, o processo é finalizado e vai aguardar o novo agendamento.
Caso haja necessidade de aumentar esse número de processamento que por padrão é 10, será necessário usar o código progress abaixo: 

FIND FIRST funcao
     WHERE funcao.cd-funcao = "GFE_TTPARAM" EXCLUSIVE-LOCK NO-ERROR.
IF NOT AVAIL funcao THEN DO:
   MESSAGE "Criando função GFE_TTPARAM e gravando o número limite de interações com 50." VIEW-AS ALERT-BOX INFO BUTTONS OK.
   CREATE funcao.
   ASSIGN funcao.cd-funcao = "GFE_TTPARAM"
          funcao.ativo     = yes
          funcao.int-1 = 50. /*número de interações - informe conforme necessidade*/ 
END.
ELSE DO:
   MESSAGE "Função GFE_TTPARAM já existe, ativando a mesma e aumentando o limite de interações para 50." VIEW-AS ALERT-BOX INFO BUTTONS OK.
   ASSIGN funcao.ativo = yes
          funcao.int-1 = 50. /*número de interações - informe conforme necessidade*/
END.
MESSAGE "Fim do processamento." VIEW-AS ALERT-BOX INFO BUTTONS OK.

O código acima deve ser executado num editor do Progress do ERP Datasul. Nesse exemplo ele irá aumentar de 10 interações padrão, para 50 interações. 
Por meio do log do CD0433 é possível verificar o tempo de execução do agendamento RPW do pedido e também identificar quantas interações o GFE está realizando.
Quando os pedidos são gerados de 5 em 5 minutos por exemplo, o programa do RPW aguarda mais 4 minutos para nova execução. Isso pode causar um entendimento de que não está funcionando, porém está apenas aguardando a nova execução.
É necessário verificar, portanto, se realmente as execuções são realizadas de 5 em 5 minutos, ou se processam apenas uma vez, sem obedecer a agenda do CD8600.

Saiba mais
Para mais informações acesse: Logística - Linha Protheus - GFE - Melhor desempenho na execução do programa CD0433