Chaves da Seção [General] do appserver.ini

Tempo de leitura: 8 minutos

A seção [General] do appserver.ini contém as configurações comuns (globais) ao ambientes administrados pelo servidor TOTVS AppServer.

Segue abaixo as principais chaves da seção [General] do arquivo de configuração appserver.ini:

ConsoleLog

Essa chave determina a gravação de log das mensagens de execução do TOTVS AppServer.

Quando a chave é ativada, as informações, erros, mensagens de ConOut, etc. de execuções dos programas e serviços são gravadas em um arquivo de log chamado console.log no diretório do disco onde encontra-se os executáveis do TOTVS AppServer, exceto quando configuradas com o arquivo personalizado com a chave ConsoleFile, onde definimos um diretório personalizado, onde ficará esse arquivo .log.

Os valores aceitos são:

0 – Desabilita a gravação do log;
1 – Habilita a gravação do log;

Observação:Caso o arquivo (console.log) ultrapasse o tamanho de 1MB, o arquivo será renomeado, automaticamente, para a extensão .BAK e um novo será criado. Caso já exista um arquivo .BAK, o sistema o apagará para que seja possível renomear o arquivo de log atual que atingiu o tamanho limite.

Exemplo:
[General]
ConsoleLog=1

ConsoleFile

Essa chave permite especificar um novo path(diretório) e nome do arquivo para gravação do log de console do TOTVS AppServer.

Ao configurar essa chave, é necessário definir o path absoluto (com driver e unidade de disco, para ambiente Windows(Ex.:C:\TOTVS\Protheus_1212410\Protheus\Logs\console.log) e a partir do / (root), para ambiente Linux), seguido do nome do arquivo para gravação do log de console.

Por padrão, quando não informado, o TOTVS AppServer cria um arquivo (console.log) no diretório onde estão instalados os executáveis do TOTVS AppServer(Ex.:C:\TOTVS\Protheus_1212410\Protheus\bin\appserver).

Lembrando que essa chave só terá efeito se a chave ConsoleLog estiver ativa(ConsoleLog=1).

Obs.:Para que essa alteração tenha efeito deverá sempre reiniciar o TOTVS AppServer.

Exemplo:
[General]
ConsoleLog=1
ConsoleFile=C:\TOTVS\Protheus_1212410\Protheus\Logs\console.log

ConsoleMaxSize

Essa chave define o tamanho padrão do arquivo (console.log) gravado pelo TOTVS AppServer, quando utilizado como serviço, ISAPI ou quando a chave ConsoleLog está configurada como 1 na seção [General].

Os valores aceitos são:

Qualquer valor acima de zero até o máximo de 999999999 em bytes. Caso o valor não seja especificado, o valor padrão será 5MB (5242880 Bytes).

A partir da versão 24.3.0.4 do TOTVS AppServer o valor padrão será 50MB (52428800 Bytes).

Obs.:Caso o arquivo (console.log) ultrapasse o tamanho definido, o arquivo será renomeado, automaticamente, para a extensão .BAK e um novo será criado. Caso já exista um arquivo .BAK, o sistema o apagará para que seja possível renomear o arquivo de log atual que atingiu o tamanho limite.

Exemplo:

[General]
ConsoleLog=1
ConsoleMaxSize=10485760

MaxQuerySize

A chave permite alterar a validação do limite de tamanho de query, em bytes, executada através de uma aplicação ADVPL.

Os valores padrão e limites, em bytes, para essa configuração são:

Versão do TOTVS AppServer	Padrão	Mínimo	Máximo
Até a versão 13.2.3.34	15960	1024	31960
A partir da versão 12.2.3.35 e supeiores	32768	1024	65536

Exemplo:

[General]

MaxQuerySize=31960

ErroMaxSize

A chave define o tamanho padrão do arquivo (error.log) gravado pelo TOTVS AppServer quando da ocorrência de um erro na execução da aplicação.

Os valores aceitos são:

Qualquer valor acima de zero até o máximo de 999999999 em bytes. Caso o valor não seja especificado, o valor padrão será 3000000 Bytes).

Exemplo:

Neste exemplo, alteramos o tamanho máximo do arquivo de log, do console, para 10 MB.

[General]
ErrorMaxSize=10485760

BuildKillUsers

A chave encerra todas as conexões quando solicitado uma compilação ou aplicação de patch.

Os valores aceitos são:

0 – Não inicia a compilação enquanto existirem conexões abertas com a instância atual do TOTVSAppServer -(padrão);
1– Derruba todas as conexões abertas com a instância atual do TOTVS AppServer para permitir a compilação de fontes.

Observação:Caso existam outros processos em execução no TOTVS AppServer onde a IDE/TDS TOTVS VSCode está conectado, todos serão derrubados, inclusive aqueles que não pertencem ao ambiente que você está compilando. Este recurso foi desenvolvido para facilitar a compilação em ambientes onde são utilizadas “Working Threads”, como WEB Services Server em ADVPL, onde para cada nova compilação era necessário finalizar e iniciar novamente o TOTVS AppServer.

Exemplo:

[General]

BuildKillUsers=1

InactiveTimeout

A chave define o intervalo de tempo de inatividade (em segundos) para a interrupção / queda da conexão com o TOTVS AppServer.

Os valores aceitos são:

0 – Não inicia a compilação enquanto existirem conexões abertas com a instância atual do

Observações:

O valor é definido em segundos. Contudo, a inatividade considera o “minuto cheio” da inatividade. Por exemplo, quando configurado 90 segundos a desconexão será realizada em 2 minutos.
Quando definido tanto na seção [General] quanto na seção do ambiente [Environment], é considerado o tempo definido na seção do ambiente.

Exemplo:

Definindo o tempo de encerramento de tela por inatividade no TOTVS Protheus como 300 segundos.

[General]

InactiveTimeout=300

Prioridade da seção [Environment] sobre a seção [General]:

Definindo o InactiveTimout na seção [Environment] como 240 segundos:

[Environment]

InactiveTimeout=240

Definindo o InactiveTimout na seção [General] como 360 segundos:

[General]

InactiveTimeout=360

Como a prioridade é a seção [Environment] o tempo de queda do TOTVS Protheus será após os 240 segundos.

MaxStringSize

A chave permite alterar o tamanho máximo de uma string.

Os valores aceitos são:

1 – O tamanho da string é definido em um 1 MB;
>=50 – O tamanho da string é definido em 50 MB (valor default caso a chave não seja configurada);
<500 – O tamanho da string é definido em 500 MB.

Observações:

Esta chave em conjunto com a chave MemoMega do TOTVS AppServer, torna possível o armazenamento de conteúdos maiores que 1 MB em campos do tipo Memo (“M”) em tabelas acessadas via TOTVS DBAccess.
Caso o valor especificado na configuração MemoMega do TOTVS AppServer seja maior que 1 MB, a chave MaxStringSize do TOTVS AppServer deve ser alterada para contemplar o maior valor em uso.

Exemplo:

Definindo o tamanho máximo de uma string como 100 MB:

[General]
MaxStringSize=100

Mensagem padrão apresentada no console do TOTVS AppServer:

*Mensagem após utilizarmos a **MaxStringSize** no appserver.ini*

ServerMemoryInfo

Esta chave habilita o echo de informações adicionais de memória e processos no log de console do TOTVS AppServer, quando utilizada em conjunto com a chave DebugThreadUsedMemory.

Os valores aceitos são:

0 – Desabilita (Padrão);
1 – Habilita.

Observações:

Ao habilitar essa chave, em intervalos de 60 segundos, será registrado no log de console do TOTVS AppServer, informações internas e detalhadas sobre os processos em execução no momento e status dos pools internos de memória;
Após habilitar/desabilitar essa chave, na seção [General], o TOTVS AppServer deve ser parado e iniciado novamente, pois essa configuração somente é considerada no momento em que o servidor de aplicação é iniciado.

Exemplo:

[General]
DebugThreadUsedMemory=1
ServerMemoryInfo=1

App_Environment

Essa chave habilita no ambiente especificado o servidor REST que trata a interface PO-UI de acesso ao TOTVS Protheus.

Para esta chave ter efeito o TOTVS AppServer deve estar utilizando a Porta Multi Protocolo.
(Esta é a configuração padrão do TOTVS AppServer, mas eventualmente esta configuração padrão ter sido alterada).

Os valores aceitos são:

<nome_ambiente> – A chave deve receber o nome do ambiente onde será ativado o servidor REST responsável pelo tratamento da interface PO-UI do Protheus.

Observações:

Esta configuração é disponibilizada a partir da versão 19.3.0.1 do TOTVS AppServer;
Para utilizar o Smartclient HTML com a interface PO-UI nas versões 19.3.1.x do TOTVS AppServer;
Caso esta chave esteja habilitada, não será possível obter acesso exclusivo ao RPO para compilações de fontes e aplicações de patchs.
Caso não haja interesse em desativar a chave, pode-se utilizar a configuração do BuildKillUsers para forçar a liberação do repositório, viabilizando a compilações de fontes e aplicações de patchs.

Exemplo:

[General]
App_Environment=PROTHEUSADVPL

WorkThreadQtdMin

Essa chave define a quantidade mínima de work threads no servidor configurado para uso geral.

Os valores aceitos são:

10 (Padrão) – Valor padrão da quantidade mínima de work threads no servidor configurado para uso geral;
10 – Valor mínimo da quantidade mínima de work threads no servidor configurado para uso geral;
100 – Valor máximo da quantidade mínima de work threads no servidor configurado para uso geral.

Observações:

Esta chave somente será usada em servidores configurados para uso geral, e não para servidores configurados como LockServer. Isto ocorre quando em ambientes balanceados e em ambientes que separamos um servidor de aplicação para algum serviço específico;

Exemplo: