BatchPaintTime: mudanças entre as edições

De CIGAM WIKI
Criou página com '{{VoltarPagina}} <br> Como Fazer > Utilidades/Diversos > Magic.ini > Batc...'
 
Sem resumo de edição
Linha 2: Linha 2:
<br>
<br>
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Magic.ini|Magic.ini]] > [[BatchPaintTime|Parâmetro BatchPaintTime]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Magic.ini|Magic.ini]] > [[BatchPaintTime|Parâmetro BatchPaintTime]]
=Objetivo=
Definir o intervalo de tempo (em milissegundos) em que o '''Magic xpa engine''' realiza o processamento (''polling'') de eventos pendentes durante a execução de processos batch.


=Descrição=
=Descrição=
O '''BatchPaintTime''' define o intervalo de tempo (em milissegundos) em que o '''Magic xpa engine''' executa o ''polling'' de eventos pendentes durante a execução de tarefas batch.<br>
O parâmetro '''BatchPaintTime''' controla o tempo em que o engine do Magic verifica e processa eventos internos enquanto uma tarefa batch está em execução.<br>
Esse parâmetro controla '''quando o engine processa eventos internos''', como atualizações de tela, timers e eventos de background.
Esses eventos incluem:
* Eventos de sistema
* Timers internos
* Processamento assíncrono necessário para fluxos de execução
* Funcionalidades dependentes de eventos, como '''A2F'''
 
De acordo com a documentação oficial do Magic xpa, o engine realiza o polling de eventos com base no '''Batch Event Interval''' e no '''Record Event Interval''', sendo acionado sempre que um desses intervalos é atingido.
 
Valor padrão do Magic xpa: '''1000 ms'''


No arquivo '''magic.ini''', esse parâmetro pode ser configurado através de um '''Logical Name (NL)'''.
=Impacto da configuração do NL = 0=
Quando o '''NL do BatchPaintTime é configurado com valor 0 no magic.ini''', o comportamento do engine é alterado de forma incorreta.


:Referência oficial:
'''Efeitos observados:'''
:Magic xpa 4.9.1 – ''Batch Event Interval''
* O mecanismo de polling de eventos batch é '''desativado'''
:Valor padrão: '''1000 ms'''
* Eventos internos deixam de ser processados no tempo esperado
:Nome no ini / linha de comando: '''BatchPaintTime'''
* O engine não executa corretamente fluxos dependentes de eventos
* O comportamento assíncrono da aplicação é comprometido


=Comportamento padrão (valor > 0)=
=Impacto na A2F=
Quando o '''BatchPaintTime''' está configurado com um valor maior que zero:
A funcionalidade '''A2F''' depende do correto processamento de eventos internos do Magic.
:* O Magic executa o ''polling'' de eventos em intervalos regulares.
:* Eventos são processados:
::* Pelo '''Batch Event Interval'''
::* Pelo '''Record Event Interval'''
:* A aplicação mantém comportamento assíncrono esperado.
:* Processos que dependem de eventos internos (ex: A2F) funcionam corretamente.


=Configuração incorreta – NL = 0=
Com o '''BatchPaintTime = 0''':
Quando o '''NL do BatchPaintTime é configurado como 0''', ocorre o seguinte comportamento:
* '''O NL não é iniciado corretamente'''
:* ❌ O intervalo de polling de eventos fica '''desabilitado'''.
* O fluxo da A2F pode não ser disparado
:* ❌ O engine '''não processa eventos pendentes durante a execução batch'''.
* Podem ocorrer travamentos ou interrupções no processamento
:* ❌ Eventos internos deixam de ser disparados no tempo esperado.
* O resultado do batch pode ser inconsistente ou incorreto
:* ❌ Impacto direto em funcionalidades que dependem de eventos assíncronos.


'''Impacto na A2F'''
'''Conclusão:'''
:* A '''A2F''' depende do processamento correto de eventos internos.
Configurar o BatchPaintTime como <code>0</code> impacta diretamente a A2F e não é suportado como configuração válida.
:* Com o '''BatchPaintTime = 0''', o NL '''não é iniciado corretamente'''.
:* O fluxo da A2F pode:
::* Não disparar
::* Ficar travado
::* Não executar etapas dependentes de eventos
:* Resultado: '''processamento inconsistente ou incorreto'''.


⚠️ '''Conclusão:'''
=Recomendação=
: Definir o NL do BatchPaintTime como 0 é considerado '''configuração incorreta'''.
Não utilizar o valor '''0''' para o parâmetro '''BatchPaintTime'''.


=Exemplo de configuração correta (magic.ini)=
=Exemplo de configuração correta (magic.ini)=
Linha 46: Linha 46:
   BatchPaintTime=1000
   BatchPaintTime=1000


'''Observações importantes'''
'''Observações'''
:* O valor <code>0</code> '''não significa execução imediata''' — significa '''desativar o mecanismo de polling'''.
:* O valor <code>0</code> '''não representa execução imediata''', mas sim a '''desativação do processamento de eventos batch'''.
:* Mesmo em processos batch sem interface gráfica, o Magic '''continua dependendo de eventos internos'''.
:* Mesmo processos batch sem interface gráfica dependem do processamento de eventos internos.
:* Alterações nesse NL devem ser feitas '''com cautela''', principalmente em ambientes produtivos.
:* Alterações nesse parâmetro devem ser realizadas com cautela em ambientes de produção.

Edição das 13h03min de 28 de janeiro de 2026

Voltar

Como Fazer > Utilidades/Diversos > Magic.ini > Parâmetro BatchPaintTime

Objetivo

Definir o intervalo de tempo (em milissegundos) em que o Magic xpa engine realiza o processamento (polling) de eventos pendentes durante a execução de processos batch.

Descrição

O parâmetro BatchPaintTime controla o tempo em que o engine do Magic verifica e processa eventos internos enquanto uma tarefa batch está em execução.
Esses eventos incluem:

  • Eventos de sistema
  • Timers internos
  • Processamento assíncrono necessário para fluxos de execução
  • Funcionalidades dependentes de eventos, como A2F

De acordo com a documentação oficial do Magic xpa, o engine realiza o polling de eventos com base no Batch Event Interval e no Record Event Interval, sendo acionado sempre que um desses intervalos é atingido.

Valor padrão do Magic xpa: 1000 ms

Impacto da configuração do NL = 0

Quando o NL do BatchPaintTime é configurado com valor 0 no magic.ini, o comportamento do engine é alterado de forma incorreta.

Efeitos observados:

  • O mecanismo de polling de eventos batch é desativado
  • Eventos internos deixam de ser processados no tempo esperado
  • O engine não executa corretamente fluxos dependentes de eventos
  • O comportamento assíncrono da aplicação é comprometido

Impacto na A2F

A funcionalidade A2F depende do correto processamento de eventos internos do Magic.

Com o BatchPaintTime = 0:

  • O NL não é iniciado corretamente
  • O fluxo da A2F pode não ser disparado
  • Podem ocorrer travamentos ou interrupções no processamento
  • O resultado do batch pode ser inconsistente ou incorreto

Conclusão: Configurar o BatchPaintTime como 0 impacta diretamente a A2F e não é suportado como configuração válida.

Recomendação

Não utilizar o valor 0 para o parâmetro BatchPaintTime.

Exemplo de configuração correta (magic.ini)

 [MAGIC_LOGICAL_NAMES]
 BatchPaintTime=1000

Observações

  • O valor 0 não representa execução imediata, mas sim a desativação do processamento de eventos batch.
  • Mesmo processos batch sem interface gráfica dependem do processamento de eventos internos.
  • Alterações nesse parâmetro devem ser realizadas com cautela em ambientes de produção.