Manual do Usuário do E3

Tweak

Copyright © 1999 - 2023 Elipse Software Ltda. Todos os direitos reservados.

Versão 6.5.162 (01/06/2023)
Sumário
1 Introdução ................................................................................................................................................... 1
2 Funcionamento do E3 Tweak .................................................................................................................... 2
3 Configurações dos Logs ............................................................................................................................ 4
3.1 Definir o Tempo Mínimo da Função de Gravar Logs ....................................................................... 4
3.2 Definir o Tempo para Avisos de Funções Travadas ......................................................................... 4
3.3 Definir a Frequência do Log de Estatísticas do REC ......................................................................... 4
3.4 Adicionar Filtro de Tags do Storage ................................................................................................... 5
3.5 Habilitar ou Desabilitar as Seções de Logs ........................................................................................ 5
3.6 Definir o Intervalo entre Estatísticas de Processo ............................................................................ 9
4 Configurações do E3 Server .................................................................................................................... 11
4.1 Desabilitar Múltiplas CPUs ................................................................................................................ 11
4.2 Bloquear o Windows de Entrar no Modo Hibernar ........................................................................ 11
4.3 Definir o Tamanho do DesktopHeap ............................................................................................... 11
4.4 Definir Tempo Limite para o Fim do E3Run ................................................................................... 12
4.5 Definir Número de Tentativas de Leitura da Chave de Produto .................................................. 12
4.6 Recuperar o Serviço HASP ................................................................................................................. 12
4.7 Reiniciar o Serviço HASP ................................................................................................................... 12
4.8 Alterar o Nome do Serviço HASP ..................................................................................................... 12
4.9 Configurar a Porta TCP/IP Utilizada pelo REC ................................................................................ 12
4.10 Configurar o Heartbeat da Licença ................................................................................................ 13
4.11 Definir Ping Obrigatório .................................................................................................................. 13
4.12 Definir Número de Retentativas Caso o Ping Falhe .................................................................... 13
4.13 Definir o Tempo Limite para o Ping .............................................................................................. 13
5 Configurações do E3Run ......................................................................................................................... 14
5.1 Ocultar a Janela de Progresso .......................................................................................................... 14
5.2 Definir Tamanho da Pilha da Thread de Runtime .......................................................................... 14
6 Configurações do E3DBEngine ............................................................................................................... 15
6.1 Desabilitar o Thread Pool .................................................................................................................. 15
7 Configurações do REC ............................................................................................................................. 16
7.1 Definir Nível de Compressão ............................................................................................................ 16
7.2 Definir o Tempo Limite da Conexão ................................................................................................ 16
7.3 Definir as Opções de Criptografia .................................................................................................... 17
8 Configurações do Filtro COM ................................................................................................................. 18
8.1 Habilitar Filtro ..................................................................................................................................... 18
9 Configurações do IOServer ..................................................................................................................... 19
9.1 Definir Tempo Limite do Watchdog ................................................................................................ 19
10 Configurações de Exceções ................................................................................................................... 20
10.1 Capturar até Exceções Tratadas ..................................................................................................... 20
10.2 Desativar o Fechamento dos Processos ........................................................................................ 20
10.3 Configurar o Tipo de MiniDump Gerado ...................................................................................... 20

I
11 Configurações de Profiling ................................................................................................................... 21
11.1 Ativar Profiling de Scripts ............................................................................................................... 21
11.2 Definir o Intervalo de Tempo entre Geração de Estatísticas ...................................................... 21
11.3 Definir a Duração Mínima para Logar Scripts .............................................................................. 21
11.4 Definir a Duração Mínima para Logar Fragmentos ..................................................................... 22
11.5 Desabilitar a Liberação Periódica de Memória para o Sistema Operacional ............................. 22
11.6 Habilitar o Depurador de Scripts .................................................................................................... 22
11.7 Habilitar o Depurador JIT ............................................................................................................... 22
11.8 Definir o Intervalo de Tempo Entre Relatórios de Profiling de Processo ................................. 22

II
CAPÍTULO
Introdução
1
O E3 Tweak é uma pequena e simples ferramenta de configuração avançada para o E3. A grande finalidade é
introduzir uma interface gráfica a todas aquelas configurações que até então só poderiam ser executadas através do
Editor do Registro do Windows, diretamente no Registro do Windows.

Janela principal do E3 Tweak

Introdução 1
CAPÍTULO
Funcionamento do E3 Tweak
2
O E3 Tweak é apresentado em uma janela com itens de configuração dispostos em uma listagem com os respectivos
valores. Os itens são classificados conforme a área na qual as configurações atuam, que são Logs, E3 Server, E3Run,
E3DBEngine, REC, Filtro COM, IOServer, Exceções e Profiling.
Cada item de configuração na listagem possui, na coluna Valor, um controle do tipo Caixa de Seleção ou
Incremento-Decremento. Se o valor existente neste controle está acinzentado, significa que a chave não existe no
Registro do Windows. Selecionar um novo valor para o item automaticamente cria a chave no Registro. A descrição, o
valor padrão e a chave de Registro de cada item de configuração selecionado são mostrados no rodapé da janela do
E3 Tweak, conforme a figura a seguir.

Rodapé da janela principal do E3 Tweak

Os itens cujos valores são numéricos na coluna Valor possuem um controle do tipo Incremento-Decremento, que
permite aumentar ou diminuir o valor. Já os itens cujos valores são Booleanos possuem uma Caixa de Seleção com os
valores Sim, Não e Default. Este último valor sempre apresenta, entre parênteses, o valor padrão, Sim ou Não, para
o item selecionado. Além da edição direta dos valores nos campos, é possível utilizar a tecla DELETE para retornar ao
valor padrão, tanto para campos numéricos quanto para Booleanos. A barra de espaços permite alternar entre os
valores de campos Booleanos, Sim e Não, bem como o duplo clique do mouse. Por fim, clicar com o botão direito do
mouse em um item apresenta um menu contextual com a opção Set to Default, que permite retornar o valor do item
para o padrão.

NOTA
Os valores numéricos podem ser digitados no formato decimal, hexadecimal ou octal, mas são sempre mostrados
no formato decimal, exceto para o item Configurar o Tipo de MiniDump Gerado, que é sempre mostrado em
hexadecimal.

Ao selecionar um dos itens de configuração na listagem, o rodapé da janela automaticamente atualiza-se, exibindo a
descrição do item, o valor padrão e a chave do Registro que deve ser modificada ou criada.
A parte inferior da janela do E3 Tweak mostra as opções destinadas à confirmação ou não das configurações. A
opção Aplicar salva todas as mudanças executadas imediatamente. A opção OK salva todas as mudanças executadas
e fecha o E3 Tweak. A opção Cancelar fecha a janela do E3 Tweak sem salvar as alterações. Além destas opções,
existe ainda a opção Restaurar padrões, que apaga todas as chaves no Registro do Windows, retornando todos os
itens para os valores padrão. Esta opção exige a confirmação da operação, que pode ser desfeita clicando em
Cancelar na janela principal do E3 Tweak, se necessário.

2 Funcionamento do E3 Tweak
 Caixa de diálogo para confirmação da opção Restaurar
Padrões
Cada item de configuração é descrito nos capítulos a seguir.

NOTA
O E3 Tweak é uma aplicação que necessita de privilégios de escrita no Registro do Windows. Por esta razão, requer
elevação de privilégios ao ser inicializado no Windows 10 ou superior.

Funcionamento do E3 Tweak 3
CAPÍTULO
Configurações dos Logs
3
Esta seção contém as configurações do E3 Tweak para os logs do E3.

Configurações dos Logs

3.1 Definir o Tempo Mínimo da Função de Gravar Logs

É possível definir o tempo mínimo para logar uma função nos logs Full. Funções que durarem menos que este tempo
não são logadas. O item de configuração é Tempo mínimo da função de gravar logs (milissegundos).
Quando este item não é modificado, considera-se o valor padrão de 100 milissegundos. Modifica-se o item e
preenche-se o campo de edição para atribuir um valor de tempo diferente. O valor 0 (zero) força todas as chamadas
a serem logadas. Um valor muito baixo pode prejudicar sensivelmente a performance da aplicação.

3.2 Definir o Tempo para Avisos de Funções Travadas

É possível definir o tempo, em milissegundos, que uma função deve estar executando para que seja gerado um aviso
(EcoLogWarning) de que a função provavelmente está trancada. O item de configuração é Tempo para avisos de
funções travadas (milissegundos).
O valor 0 (zero) no campo de edição desabilita esta opção. Se este valor não é igual a 0 (zero), o valor mínimo aceito
é 20000. Quando este item não é modificado, considera-se o valor padrão de 30000 milissegundos.

3.3 Definir a Frequência do Log de Estatísticas do REC

Esta opção permite configurar a frequência, em segundos, da gravação do log de estatísticas do protocolo REC. O
valor padrão desta opção é 300, ou cinco minutos. O valor 0 (zero) desabilita a geração periódica de logs, e o valor
mínimo aceito é 10. Caso um valor entre 1 (um) e 9 (nove) seja informado no campo, o E3 utiliza o valor 10.

4 Configurações dos Logs

3.4 Adicionar Filtro de Tags do Storage
Esta seção permite filtrar quais Tags são gravados no log. Este campo de edição é do tipo String, e pode-se utilizar o
caractere * (asterisco) no início ou no final do texto de filtragem, permitindo selecionar vários Tags que terminam ou
iniciam por uma determinada String. O valor padrão desta seção é uma String vazia.

3.5 Habilitar ou Desabilitar as Seções de Logs

É possível definir as Seções de log que são habilitadas. Algumas Seções podem ser subdivididas em Módulos, e é
possível habilitar cada Módulo separadamente. Cada Módulo possui um item de configuração com a questão
Habilitar seção/módulo de log?.
Se os itens não são modificados, considera-se automaticamente que os logs não são criados. Se os itens são
modificados, a resposta Não desabilita a criação de logs, com exceção da Seção IOData, exemplificada em detalhes
nas Notas, e a resposta Sim habilita o log da Seção. Modificar o valor da Seção implica na alteração de todos os
valores dos Módulos dentro desta Seção.

NOTAS
· A Seção IOData é uma exceção neste caso. O item correspondente é Desabilitar a seção IOData. Não modificar
este item equivale a habilitar a Seção. Modificá-lo respondendo Não à pergunta Habilitar seção/módulo de log?
permite que a Seção seja desabilitada.
· A alteração das variáveis pode ser realizada com o E3 em execução e é aplicada até 30 segundos depois de
executada.

As Seções de log disponíveis estão descritas na tabela a seguir.

Seções de log e os respectivos módulos
SEÇÃO DESCRIÇÃO
DB Mostra erros em operações de banco de dados ou
operações de descarte de dados, bem como o resultado
de operações executadas nas threads de aquisição e de
execução

EdbSync Log de mensagens informativas sobre o processo de

importação e sincronização de modelos elétricos
externos

ImportExport Log gerado pelo E3 Studio em processos de importação

ou exportação de dados

IOData Mostra os dados lidos e escritos pelo E3Run

Playback Log gerado pelo E3Playback

RECRaw Log detalhado das comunicações do REC. Os Módulos

disponíveis nesta Seção são Client: Registra os pacotes
de requisições e Server: Registra os pacotes de
respostas

Storage Permite acompanhar as operações do Storage. Os

Módulos disponíveis nesta Seção são Dropped: Lista
todos os valores que foram descartados pelo Storage,
Input: Lista todas as variações de valores dos Tags
associados ao Storage e Stored: Mostra todos os
valores que o Storage envia para o Banco de Dados

Sync Permite acompanhar as informações que são

sincronizadas entre o E3 Server e o E3Run e entre E3
Servers em modo Hot-Standby. Os Módulos disponíveis
nesta Seção são Alarm: Mostra mensagens de alarme
geradas pelo E3Run, que são passadas para o sumário
de alarmes mantido pelo E3 Server e Vars: Mostra as
alterações realizadas na base de dados de Tags
persistentes do E3 Server

Configurações dos Logs 5

 SEÇÃO DESCRIÇÃO
Undo Registra as atividades do sistema da opção de menu
Desfazer do E3 Studio

Existem sessões de log especiais que registram as operações executadas em uma thread específica, bem como a
duração. Apenas as operações que durarem mais que um determinado tempo, cujo valor padrão é 100 ms, são
logadas. Estes logs permitem verificar quando o processamento do E3 se torna lento, quase parado. As sessões de
log especiais estão descritas a seguir.

· Full: Log principal, que reúne informações gerais sobre a execução do E3 Server, E3Run, E3 Studio e E3 Viewer. Os
Módulos disponíveis estão descritos na tabela a seguir.
Módulos disponíveis no Log Full
MÓDULO DESCRIÇÃO
AccessChecker Thread para verificação de permissões ou acesso do
Domínio no E3 Server (E3Run)

AlarmCallbackManager Thread para recebimento de eventos de alarmes de

Domínios Remotos (E3Run)

AlarmQueue Threads de envio de eventos de alarmes

AlarmServer Thread do E3Run responsável pelo envio assíncrono de

eventos de Alarmes

DBCallbackManager Thread responsável por receber e armazenar em cache

as estatísticas enviadas pelo processo E3DBEngine

DefragDlg Thread para desfragmentação de arquivos de projeto e

bibliotecas (Studio)

DomainManager Thread de gerenciamento do estado do Domínio no E3

Server, ou seja, abre ou fecha o Domínio ativo,
atualizando o Domínio a partir de modificações no
arquivo .dom

E3Admin Thread principal do E3 Admin

E3Runtime Thread principal do E3Run, permite identificar

travamentos ou lentidão na execução da aplicação E3

E3Server Thread principal do E3 Server

EdbSync Thread responsável pelo processo de importação e

sincronização de modelos elétricos externos

EventQueue Threads do E3 Server responsáveis pelo envio assíncrono

de eventos de Associações

IOManager Thread do E3Run responsável pelo recebimento dos

dados gerados pelos IOServers

LicenseManager Thread do verificador de licenças do E3 Server

LinePrinter Thread para envio assíncrono de dados para

Impressoras de Linha (E3Run)

Link2Stub Thread do E3Run responsável pelo envio assíncrono de

eventos de Associações

OpcAsyncCreateServer Threads do cliente OPC responsáveis pelo isolamento da

conexão e acesso ao servidor OPC

OpcCallback Thread do E3Run ou do E3 Studio responsável pelo

recebimento assíncrono de eventos dos clientes OPC

OpcClient Thread onde é executado o cliente OPC

OpcClientHost Thread principal do cliente OPC

6 Configurações dos Logs

 MÓDULO DESCRIÇÃO
OPCGroup Thread de envio de notificações do servidor OPC do E3
(E3Run)

OpcQueue Thread responsável pelo envio assíncrono das

notificações do cliente OPC

PowerCADWarmUp Thread usada para efetuar a pré-carga do módulo

PowerCAD durante a abertura do Elipse Power Studio

PowerHubReceive Thread para recebimento de notificações dos estudos

elétricos (E3Run)

PowerHubReceive2 Thread para recebimento de notificações dos estudos

elétricos em formato EDB (E3Run)

PowerHubSend Thread para envio de atualizações aos estudos elétricos

(E3Run)

PowerHubSend2 Thread para envio de atualizações aos estudos elétricos

em formato EDB (E3Run)

RECAppartment Thread utilizada para gerenciar a transmissão de pacotes

REC em uma conexão

RECChannel Thread utilizada para gerenciar a transmissão de dados

via rede nas conexões REC

RemoteDomain Threads do E3 Server responsáveis pelo gerenciamento

das conexões clientes de Domínios Remotos

RemoteDomainsManager Thread onde ocorre o gerenciamento do conjunto dos

RemoteDomain

SafeServerSession Thread para acesso ou manutenção dos dados retentivos

do Domínio (E3Run)

ServerControl Threads do E3 Server responsáveis pelo gerenciamento

de um servidor do Domínio local ou remoto

ServerControlCallback Thread de envio de notificações para o E3 Admin (E3

Server)

ServerControlMonitor Thread do E3 Server responsável por iniciar

automaticamente o E3 Admin para os usuários logados

ServerLinkManager Thread do E3 Server que implementa o gerenciamento

de Associações

ServerSubscriptionManager Thread onde são gerenciadas as conexões de assinaturas

de alarmes

StandbyAlgorithm Thread do E3 Server que implementa as decisões do

algoritmo de Hot-Standby

Studio Thread principal, ou de de interface, do E3 Studio

ThreadPool Thread reaproveitável do processo E3DBEngine

responsável por executar consultas

UaCallback Thread de recebimento de notificações dos clientes OPC

UA (UaDriver)

UaClient Thread principal do cliente OPC UA

UaQueue Thread de envio de notificações dos clientes OPC UA

(UaDriver)

VideoRecorder Thread usada para gerenciar a gravação de vídeos em

um E3Playback

Viewer Thread principal, ou de de interface, do E3 Viewer,

permite diagnosticar tempos de abertura de Telas e
tempo de execução de scripts, entre outros

Configurações dos Logs 7

· FullDB: Registra a operação das threads de acesso a banco de dados do E3, gerados pelo E3Run e pelo E3 Server.
Os Módulos disponíveis estão descritos na tabela a seguir.
Módulos disponíveis no Log FullDB
MÓDULO DESCRIÇÃO
DBAcquisition Thread que passa para as filas, os arquivos .e3i, os
dados gerados pela aplicação

DBCallback Thread que envia estatísticas de conexão e operações

concluídas ou falhadas para o processo pai

DBEngineHost Thread principal do processo E3DBEngine

DBExec Thread que remove operações das filas, os arquivos .e3o,

e executa os comandos no banco de dados

OCIThread Thread da OCI (Oracle Call Interface)

WatchDog Thread do processo E3DBEngine responsável por

terminar este processo caso uma operação muito
demorada esteja trancada

· FullIO: Registra a atividade nas threads do IOServer. Os Módulos disponíveis estão descritos na tabela a seguir.
Módulos disponíveis no Log FullIO
MÓDULO DESCRIÇÃO
CallBack Thread de envio para o E3Run de dados coletados por
um Driver

Driver Thread onde um Driver executa

IOServer Thread principal do IOServer, que recebe a configuração

de um Driver e requisições enviadas pelo E3Run

UaClientHost Thread principal do processo E3UaClient

WatchDog Thread do IOServer responsável por terminar o processo

caso alguma operação muito demorada esteja trancada

· FullPower: Registra informações mais detalhadas das threads do PowerEngine2, ou seja, arquivos de modelo
elétrico no formato EDB. Este log registra, por exemplo, informações de diagnóstico de performance, além de
resultados detalhados de diversas operações. Os Módulos disponíveis estão descritos na tabela a seguir.
Módulos disponíveis no Log FullPower
MÓDULO DESCRIÇÃO
DistLoadModel Módulo responsável pelos cálculos do Estudo Elétrico
Modelagem de Cargas para Distribuição

ExternalReader Módulo responsável pelos cálculos do Estudo Elétrico

Leitor Externo

LoadShedding Módulo responsável pelos cálculos do Estudo Elétrico

Descarte de Cargas

PowerEngine Módulo principal do Elipse Power, responsável pelo

tratamento das requisições do Elipse Power

PowerFlow Módulo responsável pelos cálculos do Estudo Elétrico

Fluxo de Potência

SelfHealing Módulo responsável pelos cálculos do Estudo Elétrico

Autorrecuperação

Send Módulo responsável pelo envio para o Elipse Power dos

resultados gerados pelos diversos Estudos Elétricos

8 Configurações dos Logs

 MÓDULO DESCRIÇÃO
StateEstimator Módulo responsável pelos cálculos do Estudo Elétrico
Estimador de Estados

TopologyProcessor Módulo responsável pelos cálculos do Estudo Elétrico

Processador Topológico

Workspace Módulo responsável por centralizar os valores de

Medidas usadas pelos Estudos Elétricos

· PowerEngine: Registra informações gerais das threads do PowerEngine2, ou seja, arquivos de modelo elétrico no
formato EDB. Os Módulos disponíveis estão descritos na tabela a seguir.
Módulos disponíveis no Log PowerEngine
MÓDULO DESCRIÇÃO
DistLoadModel Thread com informações sobre o Estudo Elétrico
Modelagem de Cargas para Distribuição

ExternalReader Thread com informações sobre o Estudo Elétrico Leitor

Externo

Input Thread com informações de entrada de Medidas e

Fontes de Medida

LoadShed Thread com informações sobre o Estudo Elétrico

Descarte de Cargas

Output Thread com informações de saída de Medidas e Fontes

de Medida

PowerEngine Thread com informações globais do PowerEngine

PowerFlow Thread com informações sobre o Estudo Elétrico Fluxo

de Potência

SelfHealing Thread com informações sobre o Estudo Elétrico

Autorrecuperação

StateEstimator Thread com informações sobre o Estudo Elétrico

Estimador de Estados

TopologyProcessor Thread com informações sobre o Estudo Elétrico

Processador Topológico

Workspace Thread com informações sobre os valores de Medidas

usadas pelos Estudos Elétricos

NOTA
A configuração do Módulo tem precedência sobre a configuração da Seção apenas.

3.6 Definir o Intervalo entre Estatísticas de Processo

Esta Seção permite configurar as opções de tempo de registro de estatísticas de processo. As opções disponíveis
nesta Seção estão descritas na tabela a seguir.
Opções para o intervalo entre estatísticas de processo
MÓDULO DESCRIÇÃO
E3Admin Configura o intervalo entre estatísticas do processo E3
Admin. O valor padrão desta opção é 60

E3DBEngine Configura o intervalo entre estatísticas do processo

E3DBEngine. O valor padrão desta opção é 60

E3OpcClient Configura o intervalo entre estatísticas do processo

E3OpcClient. O valor padrão desta opção é 60

Configurações dos Logs 9

 MÓDULO DESCRIÇÃO
E3PowerEngine Configura o intervalo entre estatísticas do processo
E3PowerEngine. O valor padrão desta opção é 60

E3Run Configura o intervalo entre estatísticas do processo

E3Run. O valor padrão desta opção é 60

E3Server Configura o intervalo entre estatísticas do processo E3

Server. O valor padrão desta opção é 60

E3UaClient Configura o intervalo entre estatísticas do processo

E3UaClient. O valor padrão desta opção é 60

IOServer Configura o intervalo entre estatísticas do processo

IOServer. O valor padrão desta opção é 300

Studio Configura o intervalo entre estatísticas do processo

Studio. O valor padrão desta opção é 60

Viewer Configura o intervalo entre estatísticas do processo

Viewer. O valor padrão desta opção é 60

NOTA
Para todos os Módulos, o valor 0 (zero) desabilita o registro de estatísticas. A utilização de um valor entre 1 (um) e 9
(nove) força o E3 a utilizar o valor 10. Todos os valores estão em segundos.

10 Configurações dos Logs

CAPÍTULO
Configurações do E3 Server
4
Esta seção contém as configurações do E3 Tweak para o E3 Server.

Configurações do E3 Server

4.1 Desabilitar Múltiplas CPUs

No caso de computadores biprocessados, é possível configurar o E3 Server para utilizar apenas a primeira ou todas
as CPUs disponíveis no sistema, através do item de configuração Múltiplas CPUs.
Se este item não é modificado, considera-se automaticamente que o E3 Server executa em todas as CPUs.
Se este item é modificado, e a resposta para a pergunta Habilitar múltiplas CPUs? é Sim, o E3 Server é habilitado a
executar em todas as CPUs disponíveis no sistema. A resposta Não habilita o E3 Server a executar em apenas uma
CPU.

4.2 Bloquear o Windows de Entrar no Modo Hibernar

É possível configurar o Windows para que entre ou não em modo de hibernação ou suspensão, conhecido como sleep
mode, e, portanto, evitar que um Domínio ou E3 Server em execução esteja inacessível. Isto pode ser realizado usando
a opção Bloquear o Windows de entrar em modo hibernar. As opções disponíveis são 0: Nunca impede o Windows
de entrar em modo de suspensão, 1: Impede o Windows de entrar em modo de suspensão se um Domínio estiver em
execução (padrão) e 2: Impede o Windows de entrar em modo de suspensão se um E3 Server está em execução.

4.3 Definir o Tamanho do DesktopHeap

É possível definir o tamanho, em KB, do DesktopHeap para os processos do E3 que executam na conta SYSTEM na
opção Tamanho do DesktopHeap. Este valor deve estar entre 512 e 12288 KB para sistemas 32 bits e 768 e 20480 KB
para sistemas 64 bits. O valor padrão desta opção é 4096 KB para sistemas 32 bits e 6144 KB para sistemas 64 bits.

Configurações do E3 Server 11
4.4 Definir Tempo Limite para o Fim do E3Run
É possível especificar o tempo máximo, em milissegundos, para o encerramento do E3Run, através do item Tempo
limite para o fim do E3Run (milissegundos).
Se o item não é modificado, considera-se automaticamente o valor de 60000 milissegundos, ou um minuto.
Se este item é modificado, o valor configurado indica o tempo máximo, em milissegundos, para que o E3Run seja
encerrado. Se o valor configurado é igual a 0 (zero), o E3Run é encerrado imediatamente.

4.5 Definir Número de Tentativas de Leitura da Chave de

Produto
O E3 Server realiza um certo número de tentativas de leitura do dispositivo de proteção que contém a configuração.
Se esta leitura não é bem-sucedida, o E3 é iniciado em modo Demo. É possível configurar o número de tentativas de
leitura da HASP, executadas quando o E3 Server é iniciado, através do item de configuração Número de tentativas de
leitura da chave de produto.
Se este item de configuração não é modificado, considera-se automaticamente o valor 5 (cinco), isto é, são executadas
cinco tentativas de encontrar o dispositivo de proteção, com intervalos mínimos de um segundo.
Se este item é modificado, o valor configurado indica o número de tentativas de leitura do HASP pelo E3 Server. Se
configurado o valor 0 (zero), o modo Demo é habilitado automaticamente, estejam o driver HASP ou o dispositivo de
proteção instalados ou não.
Durante o tempo de procura do dispositivo, o E3 Server permanece indisponível.

4.6 Recuperar o Serviço HASP

A opção Recuperar serviço HASP permite que o E3 Server tente recuperar o serviço HASP caso não tenha acesso à
licença por mais de 50 segundos. Se não houver acesso à licença por mais de 100 segundos, o E3 Server tenta
terminar o serviço HASP, o processo hasplms, periodicamente em intervalos de tempo não inferiores a 10 segundos.
Esta opção só tem efeito se a opção (Re)iniciar serviço HASP está configurada para Sim. O valor padrão desta
opção é Sim.

NOTA
O E3 Server deve obrigatoriamente ser reiniciado em caso de alteração no valor desta opção.

4.7 Reiniciar o Serviço HASP

A opção (Re)iniciar serviço HASP permite que o E3 Server, caso não tenha acesso à licença por mais de 20
segundos, tente reiniciar o serviço HASP, o processo hasplms, periodicamente em intervalos de tempo não inferiores
a 10 segundos. O valor padrão desta opção é Sim.

NOTA
O E3 Server deve obrigatoriamente ser reiniciado em caso de alteração no valor desta opção.

4.8 Alterar o Nome do Serviço HASP

A opção Nome do serviço HASP permite alterar o nome do serviço que monitora o acesso à licenças. O valor padrão
desta opção é "hasplms".

NOTA
O E3 Server deve obrigatoriamente ser reiniciado em caso de alteração no valor desta opção.

4.9 Configurar a Porta TCP/IP Utilizada pelo REC

É possível definir o número da porta utilizada pelo REC através do item Porta TCP/IP utilizada pelo REC.
Se este item não é modificado, considera-se automaticamente a porta padrão 6515.
Se este item é modificado, o valor configurado indica o número da porta utilizada pelo protocolo REC. Podem ser
usados valores maiores que 1024 e menores ou iguais a 65535. Valores iguais ou menores que 1024 são reservados.
Valores nulos ou inválidos habilitam a utilização da porta 6515.

12 Configurações do E3 Server
4.10 Configurar o Heartbeat da Licença
Na conexão de licença do servidor com o E3 Viewer é aplicado por padrão um keep-alive (ou heartbeat). Se o E3
Tweak passar algum tempo sem responder, a conexão é desfeita automaticamente. O tempo do heartbeat pode ser
configurado no item Heartbeat da licença (milissegundos).
O valor preenchido no campo de edição indica o período do heartbeat em milissegundos.
Se o valor é igual a 0 (zero), o heartbeat é desligado. Se o valor não é alterado, considera-se um tempo padrão de
cinco segundos, ou 5000 milissegundos. O tempo máximo que o E3 Viewer pode permanecer sem enviar o heartbeat,
ou seja, o tempo limite no servidor é sempre o dobro do tempo de heartbeat configurado.

4.11 Definir Ping Obrigatório

Indica se o comando ping é obrigatório, um valor diferente de 0 (zero), ou opcional, um valor igual a 0 (zero) ou
omitido. Se o comando ping é obrigatório, o E3 Server desconecta automaticamente os E3 Viewers e WebViewers
que não responderem ao comando ping no momento da conexão. O valor padrão desta opção é 0 (zero).

4.12 Definir Número de Retentativas Caso o Ping Falhe

Define o número de retentivas em caso de falha no comando ping. O valor padrão desta opção é 0 (zero), ou seja,
nenhuma retentativa é executada. Os valores permitidos para esta opção estão na faixa entre 1 (um) e 10 retentativas.
Para valores acima do limite máximo, é armazenado o valor máximo permitido.

4.13 Definir o Tempo Limite para o Ping

É possível forçar o E3 Server para que detecte rapidamente a desconexão de E3 Viewers remotos, interrompendo o
acúmulo de dados a serem enviados para o E3 Viewer, através do item Tempo limite para o ping (milissegundos).
O valor desta opção indica o tempo limite em milissegundos. Se o item não é modificado, considera-se o valor
padrão de 2000 milissegundos. Se o item é modificado e o valor da variável é configurado como 0 (zero), este
mecanismo de ping é desligado. O valor máximo permitido é de 10000 milissegundos.
O ideal é que seja sempre usado o menor valor possível permitido pela rede. Isto permite que o E3 Server detecte a
queda dos E3 Viewers no mínimo tempo possível, evitando o empilhamento excessivo de mensagens.

Configurações do E3 Server 13
CAPÍTULO
Configurações do E3Run
5
Esta seção contém as configurações do E3 Tweak para o E3Run.

Configurações do E3Run

5.1 Ocultar a Janela de Progresso

É possível optar entre exibir ou ocultar a janela de progresso do E3Run através do item Ocultação da janela de
progresso.
Se este item não é modificado, considera-se automaticamente que a janela deve ser exibida.
Se este item é modificado, e a pergunta Ocultar a janela de progresso do E3Run? é respondida com Sim, a janela de
progresso é ocultada. Se a pergunta é respondida com Não, a janela é exibida.

5.2 Definir Tamanho da Pilha da Thread de Runtime

O E3 Server armazena as chamadas de funções em uma estrutura temporária em tempo de execução chamada de
pilha da thread e, conforme as funções vão sendo processadas, são retiradas desta pilha. Embora não seja
recomendado, o tamanho desta pilha pode ser ajustado pelo item Tamanho da pilha da thread de runtime
(megabytes). O campo de edição deve receber um valor numérico que especifica o tamanho da pilha, em megabytes,
a ser usado.
Se este item não é modificado, o valor da pilha é fixado em 4 (quatro) megabytes. O valor 0 (zero) indica que deve ser
usado o tamanho padrão do Windows, que é de 1 (um) megabyte em versões mais recentes. Valores entre 1 (um) e 3
(três) permitem reduzir o tamanho da pilha, o que não é recomendado. O valor máximo desta variável é 256. Valores
maiores são automaticamente armazenados com o valor máximo da variável.

14 Configurações do E3Run
CAPÍTULO
Configurações do E3DBEngine
6
Esta seção contém as configurações do E3 Tweak para o E3DBEngine.

Configurações do E3DBengine

6.1 Desabilitar o Thread Pool

Desabilita o recurso de Thread Pool do E3DBEngine. Esta opção é verificada pelo E3DBEngine apenas quando o
processo é iniciado. O E3DBEngine deve ser reiniciado se esta opção é modificada.

Configurações do E3DBEngine 15
CAPÍTULO
Configurações do REC
7
Esta seção contém as configurações do E3 Tweak para o protocolo REC.

Configurações do REC

7.1 Definir Nível de Compressão

É possível habilitar a compactação de pacotes de comunicação através do protocolo REC entre o E3 Server, o E3
Viewer e o E3 Studio através do item de configuração Nível de compressão.
O valor padrão deste item é 0 (zero). Se este item não é modificado, considera-se automaticamente que a
compressão está desabilitada.
Se este item é modificado, qualquer valor entre 1 (um) e 9 (nove) ativa a compactação. O valor recomendado é 6
(seis). Quaisquer valores fora desta faixa desabilitam a compactação de pacotes do protocolo REC.
Esta configuração é aplicada somente para a compactação do E3 Server ou do E3 Viewer executando localmente na
máquina. Tanto o E3 Server quanto o E3 Viewer suportam descompactação de pacotes, independente das
configurações.

7.2 Definir o Tempo Limite da Conexão

Para casos em que o E3 Server está iniciando e a detecção do dispositivo de proteção é demorada, é possível
controlar o tempo máximo que o E3 Studio ou o E3 Admin levam para conectarem-se ao E3 Server. Isto é realizado
através do item Tempo limite da conexão (milissegundos).
O campo de edição deste item indica o tempo máximo de conexão, em milissegundos.
Quando o item não é modificado, considera-se o valor padrão de 6000 milissegundos, para permitir esperar os 5000
milissegundos que o E3 Server pode demorar por padrão para detectar o dispositivo de proteção.

16 Configurações do REC
NOTA
O E3 Admin tenta conectar-se ao E3 Server repetidamente, exceto quando se usa um atalho do tipo E3Admin -
opção.

7.3 Definir as Opções de Criptografia

A comunicação com o E3 Server pode ser criptografada com o padrão AES-128. Este controle é realizado no item
Opções de Criptografia. Os valores possíveis para este item são os seguintes:
· 0 (zero): Criptografia desligada. Este é o valor padrão caso a chave de registro não exista e mantém o
comportamento existente até a versão 5.5
· 1 (um): Criptografia ligada. Este valor utiliza criptografia quando o cliente suportar mas permite que clientes
antigos conectem sem criptografia
· 2 (dois): Criptografia obrigatório. Este valor impede que clientes das versões 5.5 ou anteriores se conectem, pois
não suportam criptografia

Qualquer valor diferente de 0 (zero), 1 (um) ou 2 (dois) nesta opção habilita a opção 0 (zero), ou seja, desliga a
criptografia.

Configurações do REC 17
CAPÍTULO
Configurações do Filtro COM
8
Esta seção contém as configurações do E3 Tweak para o filtro COM.

Configurações do filtro COM

8.1 Habilitar Filtro

O E3Run implementa um filtro de chamadas COM (Component Object Model) visando evitar chamadas reentrantes. Este
filtro por padrão está desabilitado e para habilitá-lo, recomendável apenas nos sistemas que apresentarem erros ou
travamentos aparentemente sem causa, pode-se modificar o item Habilitação do filtro.
Se este item é modificado, a resposta Sim para a pergunta Habilitar filtro de mensagens COM? habilita o filtro, e a
resposta Não desabilita o filtro.
Esta configuração é lida do Registro apenas quando o E3Run é iniciado. Portanto, ao alterar o Registro o E3 tem que
ser reiniciado.
No log Full do E3 é possível verificar as chamadas COM reentrantes, para permitir a depuração de problemas.

18 Configurações do Filtro COM

CAPÍTULO
Configurações do IOServer
9
Esta seção contém as configurações do E3 Tweak para o IOServer.

Configurações do IOServer

9.1 Definir Tempo Limite do Watchdog

O IOServer possui um mecanismo de watchdog que monitora as chamadas realizadas pelo E3Run. Se alguma das
chamadas demorar mais do que um minuto, o valor padrão, então as seguintes ações são tomadas:
· Uma mensagem de erro é gravada no log do E3
· O processo do IOServer é imediatamente terminado e a chamada DCOM proveniente do E3Run ou do E3 Studio
falha, provavelmente criando um novo processo para o IOServer

O valor 0 (zero) no item Tempo limite do 'watchdog' (segundos) desabilita o watchdog. Os valores possíveis para
esta opções estão no intervalo entre 10 (dez segundos) e 3600 (uma hora).

Configurações do IOServer 19
CAPÍTULO
Configurações de Exceções
10
Esta seção contém as configurações do E3 Tweak para as exceções do E3.

Configurações de Exceções

10.1 Capturar até Exceções Tratadas

Permite capturar até mesmo as exceções que são tratadas e, dependendo da configuração da opção Desativar o
Fechamento dos Processos, fechar ou não o processo do E3. O valor padrão desta opção é Falso.

10.2 Desativar o Fechamento dos Processos

Desativa o fechamento forçado de processos do E3 quando são detectadas exceções ou falhas graves. O valor
padrão desta opção é Falso.

10.3 Configurar o Tipo de MiniDump Gerado

Permite configurar a geração de arquivos minidump para análise de GPFs (General Protection Failures). O valor padrão
desta opção é 0 (zero, gera um arquivo minidump normal). Para mais informações sobre os valores possíveis para
esta opção, consulte a documentação da Microsoft.

20 Configurações de Exceções
CAPÍTULO
Configurações de Profiling
11
Esta seção contém as configurações do E3 Tweak para o Profiling de Scripts.

Configurações de Profiling

11.1 Ativar Profiling de Scripts

O Profiling de Scripts é uma ferramenta que coleta o tempo de execução de cada script e apresenta estatísticas
sobre o número de execuções e a duração de cada script. Este Profiling está desativado por padrão e, para ativá-lo,
modifique o item Ativar Profiling de Scripts.

NOTA
O Profiling de Scripts deve ser habilitado antes da execução do E3Run, E3 Viewer ou E3 Studio.

11.2 Definir o Intervalo de Tempo entre Geração de

Estatísticas
A opção Intervalo de tempo entre geração de estatísticas (em segundos) permite habilitar a geração de estatísticas
em um determinado intervalo de tempo. Configurar esta opção com o valor 0 (zero, padrão) gera as estatísticas
apenas ao término da carga da aplicação (E3Run) e ao término da execução do processo (E3Run, Viewer ou Studio).
Os valores possíveis para esta opção estão no intervalo entre 1 (um segundo) e 86400 (24 horas).

11.3 Definir a Duração Mínima para Logar Scripts

A opção Duração mínima para logar scripts (milissegundos) permite habilitar a geração de estatísticas de scripts
que já acumularam mais do que um determinado intervalo de tempo do tempo de execução total. Configurar esta

Configurações de Profiling 21
opção com o valor 0 (zero) gera as estatísticas de todos os scripts, mesmo os scripts ainda não executados. O valor
padrão desta opção é de 100 milissegundos.

11.4 Definir a Duração Mínima para Logar Fragmentos

A opção Duração mínima para logar fragmentos (linhas de script) permite habilitar a geração de estatísticas
apenas de linhas de scripts que já acumularam mais do que um determinado intervalo de tempo, em milissegundos,
do tempo de execução total. Configurar esta opção com o valor 0 (zero) gera as estatísticas de todas as linhas de
scripts executadas. O valor padrão desta opção é de 10 milissegundos.

NOTA
O VBScript considera um fragmento qualquer linha de código que lê ou escreve em uma propriedade de um objeto,
que chame um método de um objeto ou que chame os métodos CreateObject ou GetObject. O tempo não incluído
nos fragmentos corresponde à execução do restante do código do script, como por exemplo operadores e cálculos.

11.5 Desabilitar a Liberação Periódica de Memória para o

Sistema Operacional
A opção Desabilitar a liberação periódica de memória para o sistema operacional permite habilitar ou desabilitar a
liberação de memória do E3Run e E3 Studio para o sistema operacional. Desabilitar esta opção (padrão) permite que
os processos do E3Run e E3 Studio liberem memória para o sistema operacional.

11.6 Habilitar o Depurador de Scripts

Esta opção habilita ou desabilita a declaração da hierarquia de scripts dos processos do E3. O valor padrão desta
opção é Não (desabilitada). Os itens disponíveis nesta opção estão descritos na tabela a seguir.
Itens disponíveis na opção Habilitar o depurador de scripts
OPÇÃO DESCRIÇÃO
Habilitar o depurador de scripts para o E3Run Habilita ou desabilita o depurador de scripts para o
processo E3Run

Habilitar o depurador de scripts para o Studio Habilita ou desabilita o depurador de scripts para o
processo Studio

Habilitar o depurador de scripts para o Viewer Habilita ou desabilita o depurador de scripts para o
processo Viewer

NOTA
O valor padrão para as opções descritas na tabela anterior é o valor definido na opção Habilitar o depurador de
scripts.

11.7 Habilitar o Depurador JIT

Esta opção habilita ou desabilita o acionamento do depurador JIT (Just-in-time) sempre que ocorre um erro de script.
O valor padrão desta opção é Não (desabilitada).

11.8 Definir o Intervalo de Tempo Entre Relatórios de

Profiling de Processo
A opção Intervalo entre relatórios de Profiling de processo permite habilitar a geração de relatórios de profiling de
diversos processos do E3 em um determinado intervalo de tempo, em segundos. Os processos disponíveis nesta
opção são E3Admin, E3DBEngine, E3OpcClient, E3Run, E3Server, E3UaClient, IOServer, Studio e Viewer. Configurar
qualquer uma das opções de processo com o valor 0 (zero, padrão) desabilita a geração de relatórios de profiling.

22 Configurações de Profiling
Matriz Filial em São Paulo
Rua Mostardeiro, 322/Cj. 902, 1001 e 1002 Rua dos Pinheiros, 870/Cj. 141 e 142
90430-000 — Porto Alegre — RS 05422-001 — São Paulo — SP
Fone: (+55 51) 3346-4699 Fone: (+55 11) 3061-2828
Fax: (+55 51) 3222-6226 Fax: (+55 11) 3086-2338
E-mail: elipse-rs@elipse.com.br E-mail: elipse-sp@elipse.com.br

Filial no Paraná Filial em Minas Gerais

Av. Sete de Setembro, 4698/1708 Rua Antônio de Albuquerque, 156/705
80240-000 — Curitiba — PR 30112-010 — Belo Horizonte — MG
Fone: (+55 41) 4062-5824 Fone: (+55 31) 4062-5824
E-mail: elipse-pr@elipse.com.br E-mail: elipse-mg@elipse.com.br

Filial no Rio de Janeiro Filial em Taiwan

Av. José Silva de A. Neto, 200/Bl. 4/Sl. 109B 9F., No.12, Beiping 2nd St., Sanmin Dist.
22775-056 — Rio de Janeiro — RJ 807 — Kaohsiung City — Taiwan
Fone Comercial: (+55 21) 2430-5912 Fone: (+886 7) 323-8468
Suporte Técnico: (+55 21) 2430-5963 Fax: (+886 7) 323-9656
E-mail: elipse-rj@elipse.com.br E-mail: evan@elipse.com.br

Consulte nosso website para informações sobre um representante no seu estado

www.elipse.com.br
kb.elipse.com.br
forum.elipse.com.br
www.youtube.com/elipsesoftware
elipse@elipse.com.br

Gartner, Cool Vendors in Brazil 2014, April 2014.

Gartner does not endorse any vendor, product or service depicted in its
research publications, and does not advise technology users to select only
those vendors with the highest ratings. Gartner research publications
consist of the opinions of Gartner’s research organization and should not
be construed as statements of fact. Gartner disclaims all warranties,
expressed or implied, with respect to this research, including any warranties
of merchantability of fitness for a particular purpose.