A rotina CTBA193 do TOTVS Protheus foi desenvolvida para executar o processamento de saldos contábeis sem a concorrência direta de usuários, o que resulta em ganhos expressivos de performance. Para a sua utilização, é obrigatório manter a atualização de saldos configurada como online e realizar o agendamento do respectivo schedule. Os lançamentos são inicialmente retidos na tabela de fila e consolidados nas tabelas definitivas de saldos conforme a periodicidade definida no JOB.

Dúvida

Qual a funcionalidade e a principal vantagem do Processamento em Fila por meio da rotina CTBA193?

Ambiente

Cross Segmento - TOTVS Backoffice (Linha Protheus) - Contabilidade Gerencial (SIGACTB) - A partir da versão 12

Solução

O grande diferencial da rotina CTBA193 consiste em processar os saldos de forma isolada da operação dos usuários, eliminando gargalos de concorrência. Para isso, o sistema exige que a atualização de saldos opere no modo online e que o agendamento (schedule) esteja devidamente configurado.

  • MV_ATUSAL = S (Atualização de saldo online obrigatória)
  • Configuração do Schedule CTBA193 via SIGACFG

Com o JOB em funcionamento, cada nova movimentação tem seus saldos direcionados à tabela CQA. A atualização efetiva das tabelas de saldos oficiais ocorre somente após a execução periódica do processo em segundo plano.

Pontos de Atenção

  • O parâmetro MV_ATUSAL precisa estar rigorosamente definido como "S", assegurando o comportamento online constante.

  • O arquivo de dicionário SX2 referente à tabela CQA deve possuir exatamente a mesma regra de compartilhamento aplicada às tabelas de saldos tradicionais (como CQ0, CQ1, CQ2, entre outras).

Recomendações de Arquitetura

Para mitigar sobrecargas de processamento e otimizar os recursos do ambiente, adote a estruturação centralizada do agendamento seguindo as diretrizes abaixo:

  • Modo de compartilhamento da tabela CQA: Configure a tabela CQA como compartilhada.

  • Entendimento lógico: A tabela CQA conta nativamente com o campo CQA_FILCT2, elemento encarregado de identificar e segmentar a filial de origem de cada registro.

  • Ajuste do agendamento centralizado: Com a tabela configurada como compartilhada, defina o agendamento da rotina CTBA193 em apenas uma única empresa e filial. Uma única thread será suficiente para ler, interpretar e processar os registros de todas as filiais mapeadas pelo campo CQA_FILCT2, proporcionando alta performance e alívio operacional aos servidores.

Saiba mais