Você está na página 1de 57

REMOTE Sesses e chaves do arquivo de configurao

Reviso: 22/08/2005 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Abaixo as sesses (entre colchetes) e as chaves de configurao do arquivo de configurao do Protheus Remote. Algumas chaves so dependentes de sistema operacional onde o Protheus Remote ser executado outras so dependentes da verso do Protheus. [config] lastmainprog = sigafat envserver = environment ltimo programa executado pelo Protheus Remote ltimo environment acessado pelo Protheus Remote

language = 1 ou 2 ou 3 idioma utilizado pelo Protheus Remote em suas mensagens de aviso. 1= Portugus (padro) 2 = Espanhol 3= Ingls, a partir do Protheus 8, esta opo poder ser obtida automaticamente (se no informada no arquivo de configurao) atravs da configurao do sistema operacional onde o Protheus Remote est sendo executado twotier = 1 ou 0 se habilita a opo de acionamento automtico do Protheus Server Local, 1 = aciona 0=no aciona (padro) serverdir = <path do Protheus Server> chave opcional utilizada em conjunto com a chave twotier onde informamos o path do Protheus Server Local. Se no informada, ser utilizado o path padro de instalao do Protheus Server. Ex: c:\ap7\bin\server se Protheus 7 browserenabled = 1 ou 0 se habilita o uso do navegador MS-Internet Explorer dentro do Protheus Remote ( 1 = habilita 0 = no habilita (padro) ), chave vlida somente para verses Windows do Protheus Remote helpbrowser = <path do navegador> no Protheus Remote Linux, informa o path do navegador padro para visualizao de arquivos de help locallog = 1 ou 0 habilita (se valor = 1) a gravao de um log no diretrio de arquivos temporrios da mquina onde est sendo executado o Protheus Remote (protheus_remote.log) com informaes necessrias para diagnsticos de erros do

Protheus Remote. Valor padro = 0. Quando este arquivo atinge tamanho de 1MB renomeado com o seguinte nome: protheus_remote_<ano>-<mes>-<dia>-<hora><minutos>-<segundos>.log. [ drivers ] active = tcp sesso ativa com configuraes de conexo entre Protheus Remote e Protheus Server ( no exemplo a sesso tcp deve existir no arquivo de configurao ) [ tcp ] Server server = 172.76.89.12 Server est sendo executado sesso com parmetros de conexo com o Protheus endereo TCP/IP ou nome da mquina onde o Protheus

porta = 8977 porta TCP/IP utilizada pelo Protheus Server na mquina cujo endereo foi configurada na chave server ( verificar arquivo de configurao do Protheus Server nessa mquina ) secureconnection = 0 ou 1 habilita conexo segura com o Protheus Server, 0 = no habilita (default ) 1 = habilita, o Protheus Server tambm deve ser configurado para aceitar esse tipo de conexo [ printer_map_port2spool ] sesso de mapeamento de portas de impresso para spool de impresso, sesso somente vlida para Protheus Remote Linux lpt<x> = <nome da impressora no spool> mapeamento da porta lpt<x>, onde x = nmero da porta, para a impressora configurada no spool. Em ambiente Linux, ser suportado somente servidor de impresso CUPS. Exemplo de chave: lpt1 = hp640c, toda impresso direcionada para a porta lpt1 ser redirecionada para a impressora CUPS nomedada hp640c. rawprintercommand = <comando> comando opcional para impresso mapeada, deve ter sintaxe como o exemplo: 'lpr -P <printer> -l -r <job>' onde <printer> e <job> sero substitudos pelo Protheus Remote no momento da execuo da impresso. REMOTE ACTIVE X

Auto-atualizao
Reviso: 22/02/2005 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Toda vez que acessamos uma pgina html que contm um controle ActiveX, o Internet Explorer compara a verso que esta instalada na mquina com a verso que est disponvel no Web Server. A verso do Protheus Remote ActiveX tambm muda de acordo com o nmero do build do Protheus Server. Se as verses forem diferentes, o Internet Explorer ir realizar um download do controle ActiveX do Web Server e instal-lo na mquina do browser. Esta atualizao automtica e no requer intervenso do usurio, somente deve ser confirmada a tela de certificado de segurana e autenticao ( Authenticode ).

Configurao do .htm
Reviso: 03/06/2004 Abrangncia Verso 8.11 Para configurar a carga do Protheus Remote ActiveX, deve-se editar ( com notepad.exe por exemplo ) o arquivo .htm que acompanha a distribuio do componente da maneira abaixo: Suponhamos que devamos acessar o Protheus Server que responde na mquina Server1 cujo endereo TCP/IP seja 212.122.87.2 na porta TCP/IP 8987, ainda desejamos que o programa inicial seja o mdulo SIGAFAT acessando o ambiente de execuo ENVIRONMENT, desejamos ainda que o usurio no possa alterar a configurao inicial, o arquivo .htm dever ficar assim: <html> <head> <meta http-equiv='Content-Language' content='en-us'> <meta http-equiv='Content-Type' content='text/html; charset=windows-1252'> <title>Protheus Remote 7</title> </head> <body topmargin='0' leftmargin='0' rightmargin='0'> <object classid='clsid:EDA3C4AB-B1B5-47B7-B6D1-B27858413B53' codebase='ap7rmtx.cab#version=7,0,1017,0' width='100%' height='100%' align=center

hspace='0' border='0' > <param name='Server' value='212.122.87.2'> <param name='TCPPort' value='8987'> <param name='Environments' value='ENVIRONMENT'> <param name='StartProgram' value='SIGAFAT'> <param name='ReadOnly' value='OFF'> // se desejar permitir alterao de valores na tela inicial do Protheus Remote ActiveX <param name='SecureConnection' value='1'> // se desejar conexo segura, o Protheus Server deve estar configurado para aceitar conexes seguras <param name='Browserenabled' value '1' > // se habilita o uso do MS-Internet Explorer dentro do Remote Protheus ActiveX </object> </body> </html> A cada atualizao do Protheus Remote ActiveX, que ocorre a cada troca de build do Protheus, as chaves do .htm acima 'classid' e 'codebase' sofrem alteraes de verso e portanto necessrio reeditar o .htm utilizado com as informaes de acesso desejadas.

Descrio do produto
Reviso: 12/11/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

O Protheus Remote ActiveX o prprio Protheus Remote compilado utilizando-se tecnologia de distribuio de componentes conhecida por ActiveX. A tecnologia ActiveX foi desenvolvida pela Microsoft e mantida por ela, por conseqncia somente suportada em ambiente Windows. Qualquer aplicao Windows que suporte ActiveX pode utilizar componentes ActiveX na forma de plugins com a finalidade de extender as suas funcionalidades. Para utilizao dessa tecnologia, recomenda-se verificar a documentao da Microsoft sobre a tecnologia e a documentao do aplicativo que deseja-se extender com uso de ActiveX.

O Protheus Remote ActiveX um componente ( .cab) que pode ser anexado a pginas html, para uso em Web ( Internet / Intranet ) que permite o acesso remoto ao Protheus Server com as mesmas funcionalidades do Protheus Remote. As funcionalidades e restries de uso so idnticas ao Protheus Remote. A comunicao entre Protheus Remote ActiveX e Protheus Server segue o mesmo mecanismo que o utilizado entre o Protheus Remote e Protheus Server. Quanto a compatibilidade com browsers, se o browser suporta uso de tecnologia ActiveX, tambm suportar o uso do Protheus Remote ActiveX, verifique a documentao do Browser a ser utilizado para saber se o mesmo suporta a tecnologia. Atualmente a Microsiga homologa o uso do browser Microsoft Internet Explorer verso 5 ou superior

Desinstalao
Reviso: 03/06/2004 Abrangncia Verso 8.11 Qualquer componente ActiveX que instalamos no Windows, isso se aplica ao Remote ActiveX, deve ser desinstalado pela ferramenta que o instalou. No caso do Remote ActiveX, o prprio Internet Explorer deve proceder a desinstalao do mesmo.

Qualquer outra maneira de desinstalar o Protheus Remote ActiveX pode corromper o Registro do Windows o que pode impossibilitar que novas verses do Protheus Remote ActiveX sejam instaladas. Pode ainda ser necessrio apagar do diretrio <WINDOWS\SYSTEM32> o arquivo apconn.dll quando mesmo procedendo os passos acima, quando na execuo de uma nova instalao do Protheus Remote ActiveX, ocorra o erro 'Incompatibilidade de verso...'

Instalao
Reviso: 05/11/2003

Abrangncia Verso 8.11 A instalao do Protheus Remote ActiveX depende da configurao do .htm fornecido com o componente e da instalao do .htm e .cab em algum Web Server como por exemplo MS-IIS ou Apache ou ainda o Protheus Server configurado com servidor Web. Se existe algum Firewall ou Proxy entre o Web Server e o browser que vai acessar o Protheus Remote ActiveX estes devero ser configurados para permitir o acesso ao endereo e porta TCP/IP configurados no arquivo .htm.

Segurana
Reviso: 22/02/2005 Abrangncia Verso 8.11 O Protheus Remote ActiveX basicamente composto de dois elementos:

A pgina HTML que efetua a carga do Remote ActiveX no browser e; O componente do Remote ActiveX (.cab) que distribuido pela Microsiga assinado com um certificado de autenticidade fornecido por orgo certificador ( www.verisign.com ).

A segurana de acesso da pgina HTML deve seguir os padres normais de acesso a qualquer Web Server ( login, chave de certificao, SSL... ), existem vrias solues de mercado. A segurana de execuo do componente Protheus Remote ActiveX garantida atravs:

Certificado de autenticidade do componente. Encriptao aplicada no contedo do protocolo de comunicao entre o Protheus Remote ActiveX e o Protheus Server; Login , menu de usurio e controle de alada conforme as regras do ERP.

As mesmas regras de segurana acima citadas valem para o Protheus Remote.

Configurao do Server

Reviso: 09/06/2003 Neste tpico so abordadas as chaves de configurao do Protheus Server, dispostas no Arquivo .INI de Configurao do Protheus Server. Este arquivo de configurao tm o nome de AP<n>SRV.INI, onde <n> a verso do Protheus que est sendo utilizada. Por exemplo , utiliando o Protheus AP7 , o arquivo .INI de configurao do Server chama-se Ap7Srv.ini . Este arquivo de configurao deve estar gravado no mesmo diretrio onde esto os executveis do Protheus Server. O Arquivo de configurao composto por sees e chaves. Cada seo indica um conjunto de configuraes e cada chave permite especificar um valor especfico a um item da configurao. Exemplo :
[secao1] chave1=valor1 chave2=valor2 [secao2] outrachave=outrovalor

Na rvore de tpicos ao lado, temos dispostas as chaves de configurao utilizadas para o Server Protheus. Em cada tpico da rvore so detalhadas as chaves obrigatrias e opcionais , bem como seus exemplos e interaes. Devido arquitetura da ferramenta Protheus Server , atravs do .INI so definidas sees genricas com as configuraes da ferramenta , e sees especficas com as configuraes dos ambientes da(s) aplicao(es) executadas. Segue abaixo o menor exemplo do arquivo Ap7Srv.ini , configurando apenas um ambiente de trabalho.
[ENVDBF609] ;; Configurao do Ambiente SourcePath=D:\Ap7\Apo RootPath=d:\AP_Data\ StartPath=\sigaadv RpoDb=Dbf RpoLanguage=Portuguese RpoVersion=609 LocalFiles=ADS [Drivers] ;; Configuraes da seo de conexo Active=TCP [TCP] ;; Parmetros de Conexo e porta do Listener de Conexes para Protheus Remote TYPE=TCPIP Port=1710

[Environment]
Reviso: 24/02/2005 As sees de configuraes de ambientes (Environment), especificadas no .INI do Protheus Server, contm as informaes dos diretrios de execuo do Protheus Server, as informaes do idioma, interface, diretrios e repositrio, e opcionalmente as informaes para acesso ao TopConnect. Estas informaes so identificadas para cada conexo, ou seja, cada Protheus Remote que se conectar ao Servidor deve informar qual a seo que deseja utilizar. Assim, os diretrios para trabalho, o idioma, a interface e o repositrio podem ser obtidos a partir das informaes da seo definida. Uma seo padro, chamada Environment, criada na instalao e utilizada sempre que o Protheus Remote se conectar sem informar uma seo atravs de parmetros de linha de comando. Podemos, atravs da configurao de mais de um environment, utilizar um Server Protheus para executar simultaneamente mais de uma aplicao Advpl, com ambientes completamente independentes, utilizando apenas uma instncia do Servidor Protheus. Na rvore de tpicos ao lado, temos documentadas todas as chaves relacionadas configurao de um ambiente de trabalho.

Exemplo
No exemplo abaixo, vemos uma configurao completa de um Ambiente, utiliando RPO TOP verso 710 .
[ENVTOP710] SourcePath=d:\Ap7\Projetos\WEBEX\WebRpo RootPath=d:\Ap7\Projetos\WEBEX StartPath=\WebADV RpoDb=Top RpoLanguage=Portuguese RpoVersion=710 LocalFiles=CTREE Trace=0 TopDataBase=MSSQL7 TopServer=SRVTEST1 TopAlias=WEBEX TopConType=TCPIP

ADSShare
Reviso: 29/04/2003 Abrangncia

Verso 5.07

Verso 5.08

Verso 6.09

Verso 7.10

Verso 8.11

Descrio
Indica um diretrio abaixo do raiz no servidor ADS, que deve estar compartilhado para o usurio logado na mquina onde est o servidor do protheus. Esta chave utilizada para especificar a conexo do Protheus com o Servidor ADS. Windows Devemos especificar este parmetro informando o nome do equipamento onde est o Servidor ADS e o nome do compartilhamento a ser utilizado para a conexo.

Exemplo
[EnvTesteWindows] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV AdsShare=\\Servidor\Compartilhamento RpoDb=ADS LocalFiles=ADSServer RpoLanguage=Portuguese RpoVersion=710 Trace=0

Linux Devemos especificar este parmetro informando o IP do servidor onde est o Servidor ADS, ":", a porta configurada no ads.conf (chave IP_PORT) e o path.

Exemplo
[EnvTesteLinux] SourcePath=\home\Ap7\projetos\hypersite\webrpo RootPath=\home\ap7\projetos\hypersite StartPath=\webadv AdsShare=//127.0.0.1:3000/home/ap7 RpoDb=ADS LocalFiles=ADSServer RpoLanguage=Portuguese RpoVersion=710 Trace=0

Observao : Esta chave utilizada apenas quando utilizamos um Servidor ADS para o ambiente e/ou arquivos ISAM

BTVPath

Reviso: 24/02/2005 Abrangncia Verso 6.09 Verso 7.10

Descrio
Quando utilizamos um repositrio e ambiente BTRIEVE, e a verso do BTrieve Server (Ex: PervasiveSQL2000), esta chave indica onde devem ser criados e abertos todos os arquivos BTrieve utilizados pelo sistema. Desse modo, sempre que for um arquivo BTrieve, o ERP ir ignorar o caminho descrito para a tabela no SX2 e utilizar o caminho de rede definido nesta chave. Observao : Esta chave utilizada apenas quando utilizamos um ambiente BTrieve com um Servidor BTrieve para as Tabelas do ERP

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV BTVPath=\\Servidor\Pasta RpoDb=BTV LocalFiles=ADS RpoLanguage=Portuguese RpoVersion=710 Trace=0

ConnectionTimeout
Reviso: 18/08/2005 Descrio: Configura o tempo em segundos que o Protheus Server aguarda quando envia um pacote de comunicao para o Protheus Remote solicitando retorno de dados. O valor padro 180 segundos. Situao:

O Protheus Server envia um comando de impresso para o Protheus Remote. O Protheus Remote deve enviar a resposta da ao em <t> tempo para que o Protheus Server no feche a conexo de comunio exibindo a mensagem de erro

no seu console e/ou arquivo de log: ' ... tMSGManager - Timeout waiting for data...' Exemplo de configurao: CONNECTIONTIMEOUT = 60 // Timeout de 60 segundos Observao:

O Protheus Remote envia uma mensagem de notificao para o Protheus Server a cada (CONNECTIONTIMEOUT / 3) segundos, ou seja, no valor padro de 60 segundos para que o Protheus Server no feche sua conexo por falta de comunicao. Modificando o valor do parmetro CONNECTIONTIMEOUT, o Protheus Remote manter a regra, modificando seu tempo de notificao para (CONNECTIONTIMEOUT / 3) segundos.

Ateno:

A diminuio do valor configurado para o parmetro CONNECTIONTIMEOUT para menor que o valor default (180 segundos) aumentar o trfego de pacotes de comunicao na rede onde estiver sendo executado o Protheus Server e Protheus Remote.

CtreeRootPath
Reviso: 09/05/2005 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Quando utilizado um Ctree Server em um ambiente com mais de um servidor protheus, por exemplo, um ambiente com Load Balance, devemos adicionar a chave CtreeRootPath, na configurao do(s) ambientes(s) que utilizam o CtreeServer. Atravs desta configurao, devemos especificar qual o caminho fsico correspondente ao compartilhamento acessado pelos servidores de aplicao Protheus (RootPath) dos ambientes que utilizam Ctree Server.

Importante : Esta configurao somente ser considerada quando especificamos na configurao do Protheus Server que est sendo utilizado um CtreeServer ( seo [general], chave ctreemode=server ). Caso seja especificada a configurao CtreeRootPath em um servidor que esteja, por exemplo, utilizando Ctree 'local', a aplicao Advpl em uso ser abortada, com a ocorrncia de erro 'Environment Config Error - CTREEROOTPATH requires CTREE SERVER environment' .

No exemplo abaixo, parte-se de um ambiente com 3 servidores de aplicao Protheus : SERVER_A , SERVER_B e SERVER_C , onde o Server_A o servidor master, e nele esto os dicionrios SXS , o Ctree Server; e o RootPath ( diretrio raiz ) deste ambiente utiliza a pasta D:\AP_Data . Esta pasta est compartilhada, e todos os servidores de aplicao Protheus possuem o RootPath de seus ambientes apontando para o compartilhamento \\SERVER_A\Ap_data\ . Logo, atravs da configurao CtreeRootPath, deve ser informada no environment qual o caminho fsico da pasta informada no RootPath no servidor SERVER_A ( no caso, D:\Ap_Data\ ) [Environment] RootPath=\\SERVER_A\Ap_data\ CTREERootPath=D:\Ap_data\ Utilizada desta maneira, esta configurao faz com que o Protheus Server faa as requisies de abertura, leitura e gravao de dados ao CtreeServer, sempre informando ao CtreeServer um caminho de acesso Local da tabela no servidor onde o CtreeServer est instalado, e no um caminho de rede. Em consequncia, h um menor trfego de rede e melhora na performance, contribuindo para uma maior estabilidade do sistema. Esta configurao est implementada a partir do Protheus Server - Build 7.00.041103A

FilesOnDemand
Reviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Esta chave aplicada apenas se o RpoDb for DBF. Seu objetivo fazer com que o sistema faa a abertura somente dos arquivos necessrios. geralmente utilizado em ambientes Netware quando o nmero mximo de arquivos abertos ultrapassado.

Valores vlidos

0 (DEFAULT) = Abre todos os arquivos utilizados pelo Mdulo do Advanced utilizado. 1 = Abre os arquivos utilizados pelo mdulo apenas no momento em que eles so necessrios.

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=DBF LocalFiles=ADS RpoLanguage=Portuguese RpoVersion=710 Trace=0 FilesOnDemand=1

LocalDbExtension
Reviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Define qual ser a extenso DEFAULT dos arquivos ISAM para os Drivers DBFCDX, DBFCDXAX. So definidos como arquivos ISAM, de acodo com o Rdd utilizado ( RpoDb ), os seguintes arquivos : RpoDB Arquivos ISAM Sindex, demais SXS ( exceto SX5 ) e arquivos de trabalho TOP (TopConnect) temporrios. DBF ou ADS Todos os arquivos ISAM, com exceo do SIGAMAT.EMP Sindex, demais SXS ( exceto SX5 ) e arquivos de trabalho BTRIEVE ou CTREE temporrios.

Valores vlidos
So consideradas vlidas para o parmetro extenses de arquivo que comeem com um ponto decimal, seguidos por trs caracteres alfanumricos. Caso este parmetro no seja especificado, o default .dbf

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=TOP

LocalFiles=CTREE RpoLanguage=Portuguese RpoVersion=710 Trace=0 LocalDbExtension=.DTC

LocalFiles
Reviso: 22/02/2005 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Indica a RDD que ser utilizada para abertura de arquivos locais (SXS, por exemplo) .

Valores vlidos

ADS: Utiliza Dlls do ADS Local. Esta opo DEFAULT quando utilizamos o Protheus Server em ambiente Windows. ADSSERVER: Devemos especificar esta chave quando da utilizao de um servidor ADS. CTREE: Utiliza CTree, Local ou Server. A distino entre estes dois depende da chave CTREEMODE na seo General.

Para ambientes UNIX/LINUX, a nica opo homologada CTREE.

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=TOP LocalFiles=CTREE RpoLanguage=Portuguese RpoVersion=710 Trace=0 LocalDbExtension=.DTC

MaxLocks

Reviso: 22/09/2003 Abrangncia Verso 8.11

Descrio
A fim de evitar erros srios no banco de dados devido a programas com erro (geralmente em loop), foi criado um parmetro para limitar o nmero mximo de 'locks' simultneas por conexo. Dificilmente existe necessidade de aumentar o valor 'default' que 10.000, mas caso haja necessidade, altere o parmetro de acordo com o necessidade. O aumento deste nmero no onera o sistema, mas deve ser utilizado com critrio para no trazer problemas ao banco de dados.

Valores vlidos
Numrico maior ou igual a zero.

10000 (DEFAULT)

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=DBF LocalFiles=ADS RpoLanguage=Portuguese RpoVersion=710 Trace=0 MaxLocks=20000

PictFormat
Reviso: 27/04/2005 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Esta chave atua na utilizao da picture '@E', utilizada no sistema em campos de entrada e sada de valores numricos ( @ ... SAY / GET ... PICTURE '@E...' ) , bem como na

funo advpl Transform(), quando utilizada esta picture. A picture '@E' utilizada quando desejamos exibir / mascarar um nmero utilizando o formato Europeu ( ',' vrgula como separador decimal e '.' ponto(s) para separador de milhar )

Valores vlidos

DEFAULT = Ajusta o formato de exibio do nmero utilizando ',' vrgula como separador decimal e '.' ponto(s) para separador de milhar. AMERICAN = Ajusta o formato de exibio do nmero no formato Americano, preservando o '.' ponto como separador decimal e ',' vrgula(s) para separador de milhar, mesmo que seja utilizado o '@E' na picture.

Observao
Esta configurao considerada pelas rotinas de inicializao do ambiente ERP Microsiga.

RootPath
Reviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Identifica o diretrio raiz do Environment, a partir do qual todos os diretrios utilizados pelo Advanced Protheus sero criados.

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=TOP LocalFiles=CTREE RpoLanguage=Portuguese RpoVersion=710 Trace=0 LocalDbExtension=.DTC

RpoDb

Reviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Identifica o tipo de base de dados utilizada. Esta informao utilizada pelo servidor para definir que repositrio ser acessado.

Valores vlidos

DBF ADS TOP CTREE BTV

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=TOP LocalFiles=CTREE RpoLanguage=Portuguese RpoVersion=710 Trace=0 LocalDbExtension=.DTC

RpoLanguage
Reviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Identifica a linguagem que ser utilizada. Esta informao tambm utilizada pelo servidor para definio do repositrio a ser acessado.

Valores vlidos

Portuguese English Spanish

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=TOP LocalFiles=CTREE RpoLanguage=Portuguese RpoVersion=710 Trace=0 LocalDbExtension=.DTC

RpoVersion
Reviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Identifica a verso do Repositrio de Objetos ( APO ) a ser utilizado no ambiente.

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=TOP LocalFiles=CTREE RpoLanguage=Portuguese RpoVersion=710 Trace=0 LocalDbExtension=.DTC

SourcePath
Reviso: 23/02/2005 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Identifica o diretrio onde o(s) repositrio(s) (APOs) para um determinado ambiente esto localizados na mquina em que o Protheus Server est instalado.

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=Top RpoLanguage=Portuguese RpoVersion=710 Trace=0

Obs: O Diretrio do SourcePath deve sempre ser local, no recomendado compartilhar o repositrio entre diversos servidores ou instancias de Protheus.

Trace
Reviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Indica se deve ser gravado um arquivo de log das mensagens de "warning" do Advanced Protheus. O arquivo (trace.log) gravado no diretrio onde encontram-se os executveis e dlls do Protheus Server.

Valores vlidos

0 (Default) : Desabilita a gravao do Log

1: Habilita a gravao do Log

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=Top RpoLanguage=Portuguese RpoVersion=710 Trace=1

WSPLReldir
Reviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Define o diretrio, a partir do RootPath, onde ficaro armazenados os relatrios em disco para visualizacao atravs do WebSpool do ERP. Caso este parmetro no seja especificado, o ERP buscar o contedo do parmetro MV_RELDIR, cujo defautl \RELATO\

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=Top RpoLanguage=Portuguese RpoVersion=710 Trace=0 WSPReldir=\WebRelato\

WSPLServer
Reviso: 29/04/2003

Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Define o Servidor, a porta e o ambiente onde o agendador de relatrios e o WebSpool executaro suas tarefas de relatrios assncronos. Caso este parmetro no seja especificado, o Default o Protheus Server onde estiver sendo realizada a conexo do Remote.

Exemplo
[EnvTeste] SourcePath=d:\Ap7\Projetos\HYPERSITE\WebRpo RootPath=d:\Ap7\Projetos\HYPERSITE StartPath=\WebADV RpoDb=Top RpoLanguage=Portuguese RpoVersion=710 Trace=0 WsplServer= MyServer,1024,MyEnvironment

CtreeServer
Reviso: 09/06/2003 Configurao das informaes para logar no Ctree Server. Apenas ser utilizada caso a chave "CTREEMODE" da seo "GENERAL" estiver com o valor "SERVER", pois caso contrrio ser utilizado o Ctree Local.

CTServerName
Reviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, podemos configurar o nome do servidor CTREE e a mquina que ele est sendo executado. Devemos utilizar esta chave em conjunto das chaves CTUserNAme e CTUserPass. Seu valor padro FAIRCOMS. Observao : Esta chave utilizada apenas quando utilizamos uma instalao do Protheus Server utilizando um CTREE Server .

Formatos Vlidos
Ambiente Windows <nomedoservidor>@SERVERNAME Ambiente Linux <nomedoservidor>@SERVERIP

Exemplo
[CTREESERVER] CTUserId=ADMIN CTUserPass=ADMIN CTServerName=FAIRCOMS@SERVERNAME

CTUserId
Reviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, podemos configurar o usurio para realizar o login no Servidor CTREE. Devemos utilizar esta chave em conjunto das chaves CTUserPass e CTServerName. Seu valor padro ADMIN. Observao : Esta chave utilizada apenas quando utilizamos uma instalao do Protheus Server utilizando um CTREE Server .

Exemplo
[CTREESERVER] CTUserId=ADMIN CTUserPass=ADMIN CTServerName=FAIRCOMS@SERVERNAME

CTUserPass
Reviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, podemos configurar a senha do usurio para realizar o login no Servidor CTREE. Devemos utilizar esta chave em conjunto das chaves CTUserNAme e CTServerName. Seu valor padro ADMIN. Observao : Esta chave utilizada apenas quando utilizamos uma instalao do Protheus Server utilizando um CTREE Server .

Exemplo
[CTREESERVER] CTUserId=ADMIN CTUserPass=ADMIN CTServerName=FAIRCOMS@SERVERNAME

EXEMPLOS

Configurao do Server
Reviso: 09/06/2003 Neste tpico so abordadas as chaves de configurao do Protheus Server, dispostas no Arquivo .INI de Configurao do Protheus Server. Este arquivo de configurao tm o nome de AP<n>SRV.INI, onde <n> a verso do Protheus que est sendo utilizada. Por exemplo , utiliando o Protheus AP7 , o arquivo .INI de configurao do Server chama-se Ap7Srv.ini . Este arquivo de configurao deve estar gravado no mesmo diretrio onde esto os executveis do Protheus Server. O Arquivo de configurao composto por sees e chaves. Cada seo indica um conjunto de configuraes e cada chave permite especificar um valor especfico a um

item da configurao. Exemplo :


[secao1] chave1=valor1 chave2=valor2 [secao2] outrachave=outrovalor

Na rvore de tpicos ao lado, temos dispostas as chaves de configurao utilizadas para o Server Protheus. Em cada tpico da rvore so detalhadas as chaves obrigatrias e opcionais , bem como seus exemplos e interaes. Devido arquitetura da ferramenta Protheus Server , atravs do .INI so definidas sees genricas com as configuraes da ferramenta , e sees especficas com as configuraes dos ambientes da(s) aplicao(es) executadas. Segue abaixo o menor exemplo do arquivo Ap7Srv.ini , configurando apenas um ambiente de trabalho.
[ENVDBF609] ;; Configurao do Ambiente SourcePath=D:\Ap7\Apo RootPath=d:\AP_Data\ StartPath=\sigaadv RpoDb=Dbf RpoLanguage=Portuguese RpoVersion=609 LocalFiles=ADS [Drivers] ;; Configuraes da seo de conexo Active=TCP [TCP] ;; Parmetros de Conexo e porta do Listener de Conexes para Protheus Remote TYPE=TCPIP Port=1710

APxSRV.INI (ADS)
Reviso: 30/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

[EnvADSLocal] SourcePath=c:\ap7\apo\

RootPath=c:\ap7 StartPath=\sigaadv\ RpoDb=DBF RpoLanguage=Portuguese RpoVersion=710 Cisasync=0 LocalFiles=ADS [EnvADSServer] SourcePath=c:\ap7\apo\ RootPath=\\srvname\ap7$ StartPath=\sigaadv\ ADSShare=\\srvname\ap7$ RpoDb=ADS RpoLanguage=Portuguese RpoVersion=710 Cisasync=0 LocalFiles=ADSSERVER [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=5050

APxSRV.INI (CTREE Local)


Reviso: 30/04/2003 Abrangncia Verso 6.09 [EnvCtree710] SourcePath=c:\ap7\apo\ RootPath=c:\ap7 StartPath=\sigaadv\ RpoDb=CTREE RpoLanguage=Portuguese RpoVersion=710 LocalFiles=CTREE localdbextension=.dtc [Drivers] Active=TCP Verso 7.10 Verso 8.11

[TCP] TYPE=TCPIP Port=5050

APxSRV.INI (CTREE Server)


Reviso: 30/04/2003 Abrangncia Verso 6.09 [General] CtreeMode=SERVER [EnvCtree710] SourcePath=c:\ap7\apo\ RootPath=c:\ap7 StartPath=\sigaadv\ RpoDb=CTREE RpoLanguage=Portuguese RpoVersion=710 LocalFiles=CTREE localdbextension=.dtc [CtreeServer] CTUserId=ADMIN CTUserPass=ADMIN CTServerName=FAIRCOMS@SERVERNAME [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=5050 Verso 7.10 Verso 8.11

APxSRV.INI (TOP)
Reviso: 30/04/2003 Abrangncia

Verso 5.07

Verso 5.08

Verso 6.09

Verso 7.10

Verso 8.11

[EnvTop710] SourcePath=c:\ap7\apo\ RootPath=c:\ap7\ StartPath=\sigaadv\ RpoDb=Top RpoLanguage=Portuguese RpoVersion=710 LocalFiles=ADS [Topconnect] Alias=BASE710 ConType=TCPIP DataBase=MSSQL7 Server=SrvTOP01 [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=5050

Ftp
Reviso: 09/06/2003

Servios de FTP
O protocolo FTP (File Transfer Protocol) permite a transferncia de arquivos entre um servidor e uma aplicao client de FTP (com um Web Browser como o Internet Explorer, por exemplo). Utilizando o Protheus Server como um servidor FTP, os usurios podero remotamente baixar arquivos disponibilizados em um diretrio configurvel no servidor. Para habilitarmos o servio de FTP SErver no Protheus , devemos incluir a seo FTP no arquivo .INI de configirao do PRotheus Server. Vejamos Abaixo um exemplo da seo FTP .
[FTP] Enable=1 Port=21 Path=D:\Ap7\Ftp

CanAcceptAnonymous
Reviso: 27/01/2005 Abrangncia Verso 5.07 Verses Anteriores Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Especificando a configurao CanAcceptAnonymous=1, habilitamos o acesso 'annimo' ao FTP Server do Protheus. O Default deste parmetro 0 (zero)

Enable
Reviso: 30/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Identifica se o servio de FTP deve ser ativado quando da inicializao do Server Protheus.

Valores vlidos

0 = Desabilitado 1 = Habilitado

Exemplo
[FTP] Enable=1 Port=21 Path=d:\Ap7\FTP

Path
Reviso: 30/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Identifica um diretrio absoluto no disco, a partir do qual o Server Protheus disponibilizar seu contedo e sub-diretrios via FTP para serem acessados por um Client FTP.

Exemplo
[FTP] Enable=1 Port=21 Path=D:\Ap7\Ftp

Port
Reviso: 30/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Permite especificar a porta do listener de conexes FTP . Por default , servidores de FTP utilizam a porta 21 .

Exemplo
[FTP] Enable=1 Port=21 Path=D:\Ap7\Ftp

LicenseClient

Reviso: 09/06/2003 O Servidor de licenas o responsvel pela liberao de senhas e controle aos acessos simultneos (semaforizao), a partir do Advanced Protheus AP7. Quando a empresa no for a de teste (99), necessrio que um dos servidores AP7 seja o servidor de licenas. Vantagens: maior segurana, melhor controle do processo de liberao de senhas e ganho de performance nestes processos. Atravs da seo [LicenseClient] no Ap7Srv.ini, informamos o caminho para que este Protheus Server conecte-se com o Protheus Server habilitado como Servidor de Licenas

Port
Reviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11

Descrio
Indica a porta de conexo a ser utilizada para conexo com o Servidor de Licencas.

Exemplo
[LicenseClient] Port=2000 Server=localhost

Server
Reviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11

Descrio
Indica o IP ou Nome do Servidor Protheus habilitado como Servidor de Licenas.

Exemplo
[LicenseClient]

Port=2000 Server=localhost

LicenseServer
Reviso: 09/06/2003 O Servidor de licenas o responsvel pela liberao de senhas e controle aos acessos simultneos (semaforizao), a partir do Advanced Protheus AP7. Quando a empresa no for a de teste (99), necessrio que um dos servidores AP7 seja o servidor de licenas. Vantagens: maior segurana, melhor controle do processo de liberao de senhas e ganho de performance nestes processos. Atravs da seo [LicenseServer] no Ap7Srv.ini, habilitamos o Servidor de Licenas. O Servidor de Licenas deve ter um dispositivo de segurana (Hardlock) na porta paralela ou USB e o driver do mesmo instalado.

Enable
Reviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11

Descrio
Indica se este Server Protheus ser habilitado como Servidor de Licenas.

Valores vlidos

0 : Desabilitado 1 : Habilitado

Exemplo
[LicenseServer] Enable=1 Port=2000 ShowStatus=1

Port
Reviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11

Descrio
Indica a Porta TCP que ser disponibilizado o Listener do Servidor de Licenas. Esta porta no pode coincidir con outra porta de conexo especificada no INI.

Exemplo
[LicenseServer] Enable=1 Port=2000 ShowStatus=1

ShowStatus
Reviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11

Descrio
Habilita mensagens de controle na tela console do Protheus Server.

Valores vlidos

0 : Desabilitado 1 : Habilitado

Exemplo
[LicenseServer] Enable=1 Port=2000 ShowStatus=1

OnStart
Reviso: 09/06/2003 Na seo OnStart do Arquivo de Configurao do Server Protheus, podemos especificar um ou mais programas ou rotinas a serem executadas no momento que o Protheus Server iniciado. Tambm podemos configurar este recurso para executar todas as rotinas em um intervalo de tempo pr-definido, aps o incio da aplicao. Usamos tambm esta configurao para inicializar ambientes de Working Threads, utilizadas em ambiente WEB. Para cada rotina ou job a ser executado, devemos criar uma nova chave no INI, onde sero configurados o tipo e parmetros do Job. Aps configurarmos os Jobs, inserimos no INI a chave ONSTART, onde especificamos os Jobs que devem ser executados na inicializao do Protheus Server. Vejamos o exemplo abaixo, onde configuramos a execuo da funo Advpl conout(), a ser executada na carga do servidor, no ambiente ENVTOP710, recebendo apenas 1 parmetro, contendo uma String definida no INI
[ONSTART] JOBS=TESTE01 [TESTE01] Main=conout Environment=ENVTOP710 nParms=1 Parm1="Teste de JOB com o Servidor Protheus"

RefreshRate
Reviso: 10/03/2004 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Determina um intervalo de tempo em segundos para que os jobs especificados na chave ONSTART sejam executados novamente automaticamente, caso os mesmos no estejam ainda em execuo.

Observao
Esta chave, uma vez especificada, vlida para todos os jobs da chave OnStart, de modo que TODOS os Jobs especificados na chave ONSTART, sero executados novamente caso j tenham sido terminados.

Exemplo
[ONSTART] Jobs=JOB_WS_0101,JOB_TESTE RefreshRate=180

SSLCONFIGURE

Configurao do Server
Reviso: 09/06/2003 Neste tpico so abordadas as chaves de configurao do Protheus Server, dispostas no Arquivo .INI de Configurao do Protheus Server. Este arquivo de configurao tm o nome de AP<n>SRV.INI, onde <n> a verso do Protheus que est sendo utilizada. Por exemplo , utiliando o Protheus AP7 , o arquivo .INI de configurao do Server chama-se Ap7Srv.ini . Este arquivo de configurao deve estar gravado no mesmo diretrio onde esto os executveis do Protheus Server. O Arquivo de configurao composto por sees e chaves. Cada seo indica um conjunto de configuraes e cada chave permite especificar um valor especfico a um item da configurao. Exemplo :
[secao1] chave1=valor1 chave2=valor2 [secao2] outrachave=outrovalor

Na rvore de tpicos ao lado, temos dispostas as chaves de configurao utilizadas para o Server Protheus. Em cada tpico da rvore so detalhadas as chaves obrigatrias e opcionais , bem como seus exemplos e interaes. Devido arquitetura da ferramenta Protheus Server , atravs do .INI so definidas sees genricas com as configuraes da ferramenta , e sees especficas com as configuraes

dos ambientes da(s) aplicao(es) executadas. Segue abaixo o menor exemplo do arquivo Ap7Srv.ini , configurando apenas um ambiente de trabalho.
[ENVDBF609] ;; Configurao do Ambiente SourcePath=D:\Ap7\Apo RootPath=d:\AP_Data\ StartPath=\sigaadv RpoDb=Dbf RpoLanguage=Portuguese RpoVersion=609 LocalFiles=ADS [Drivers] ;; Configuraes da seo de conexo Active=TCP [TCP] ;; Parmetros de Conexo e porta do Listener de Conexes para Protheus Remote TYPE=TCPIP Port=1710

CertificateServer
Reviso: 12/08/2005 Abrangncia Verso 8.11 Localizao e nome de arquivo, de Certificado de Segurana Seguro ( No formato PEM, formato semelhante ao do Apache! ). Exemplo: [SSLConfigure] CertificateServer=d:\ap7\certificates\server-cert.pem Note: Este certificado deve ser adquirido de uma certificadora oficial e isso implica numa espera normal de 1 a 3 meses.

KeyServer
Reviso: 12/08/2005 Abrangncia Verso 8.11

Nome do arquivo que contm a chave de segurana que dever ser utilizado pelo Certificado de segurana. No formato PEM, formato semelhante ao do Apache!. Exemplo: [SSLConfigure] KeyServer=d:\ap7\certificate\server-key.pem Note: Este certificado deve ser adquirido de uma certificadora oficial e isso implica numa espera normal de 1 a 3 meses.

PassPhrase
Reviso: 12/08/2005 Abrangncia Verso 8.11 Senha que permite a utilizao do certificado/chave de segurana. [SSLConfigure] PassPhrase=minhasenha

ServerNetwork ( Load Balance )


Reviso: 13/04/2005 Atravs da seo [ServerNetwork], podemos configurar mais de um Servidor Protheus para balanceamento de carga via SoftWare. Devemos informar nesta chave quais so o(s) servidor(es) disponvel(is) na rede para realizar a(s) conexo(es). Para cada servidor disponvel, devemos criar uma nova seo no INI e informar nela o tipo de conexo (TCP), a porta , o Nome do Servidor e/ou o IP, e o nmero de conexes mxima permitidas.

Exemplo :
[ServerNetwork] Servers=SERVER1,SERVER2

[SERVER1] TYPE=TCPIP Server=Servidor1 Port=1024 Connections=60 [SERVER2] TYPE=TCPIP Server=Servidor2 Port=3024 Connections=40

TopConnect
Reviso: 26/04/2004

Chaves da Seo :

alias contype database server protheusonly topapi Na seo TopConnect, no INI do Protheus Server, definimos as opes de conexo default do(s) Environment(s) configurado(s) no Servidor. As chaves de configurao permitem a definio do Banco de Dados utilizado, Alias, Servidor, tipo da conexo entre o Protheus e o TopConnect e demais opes. Estas informaes apenas so utilizadas por ambientes que utilizam Repositrio de Objetos ( APO ) e a configurao de ambiente RpoDB=TOP. No caso de utilizao de mais de um ambiente com RpoDb=TOP, e exista a necessidade dos ambientes de estabelecer conexo com Bancos de Dados diferentes e/ou em outras estaes, com outro servidor TopConnect, possvel configurar os parmetros de conexo com o TopConnect com as chaves originais desta seo dentro da seo do Environment desejado, bastando apenas prefixar o nome da chave com a string 'Top'. A(s) chave(s) de configurao para conexo com o TopConnect especificada(s) dentro da seo do environment tm preferncia sobre as chaves especificadas na seo TopConnect.

Alias
Reviso: 30/04/2003

Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, setada dentro da seo [Topconnect] do Arquivo INI do Protheus Server, informamos o Alias da Base de Dados, configurado no TopConect, para estabelecer uma conexo com om Banco de Dados.

Exemplo
[Topconnect] Alias=BASE710 ConType=TCPIP DataBase=MSSQL7 Server=SrvTOP01

Observao: Podemos especificar um alias para uso em um ambiente (environment) especfico, especificando esta chave, prefixada com TOP, dentro da seo do environment desejado. Vale lembrar que a configurao desta chave diretamente no environment tem precedncia sobre a especificao default na seo TopConnect.

Exemplo
[Environment] ... TOPAlias=BASE710 TOPConType=TCPIP TOPDataBase=MSSQL7 TOPServer=SrvTOP01

ConType
Reviso: 30/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, setada dentro da seo [Topconnect] do Arquivo .INI do Protheus Server, informamos diretamente o protocolo a ser utilizado na conexo entre o Protheus

Server e o TopConnect. Por default, caso esta chave no seja especificada, utilizado o protocolo TCPIP.

Valores vlidos

TCPIP (Default) : Utiliza o protocolo TCPIP NPIPE : Utiliza o protocolo Named Pipes

Exemplo
[Topconnect] Alias=BASE710 ConType=TCPIP DataBase=MSSQL7 Server=SrvTOP01

Observao: Podemos especificar um protocolo diferenciado para uso em um ambiente (environment) especfico, especificando esta chave, prefixada com TOP, dentro da seo do environment desejado. Vale lembrar que a configurao desta chave diretamente no environment tm precedncia sobre a especificao default na seo TopConnect.

Exemplo
[Environment] ... TOPAlias=BASE710 TOPConType=NPIPE TOPDataBase=MSSQL7 TOPServer=SrvTOP01

Importante: Quanto a utilizao do protocolo Named Pipes, caso o TopConnect esteja instalado em um equipamento e o Server Protheus esteja instalado em outro servidor, imprescindvel que o usurio de rede do Servidor Protheus tenha seu login validado no equipamento onde est o TopConnect . Vale lembrar que este protocolo existe apenas em ambientes Windows, sendo para fins gerais desaconselhvel seu uso, por tratar-se de um protocolo no suportado em outras plataformas, este poder no mais ser suportado em verses futuras.

DataBase
Reviso: 30/04/2003

Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, setada dentro da seo [Topconnect] do Arquivo INI do Protheus Server, informamos o tipo de banco de dados utilizado pelo TopConnect para estabelecer uma conexo atravs do mesmo.

Valores vlidos

MSSQL7 ORACLE SYBASE INFORMIX AS/400

Exemplo
[Topconnect] Alias=BASE710 ConType=TCPIP DataBase=MSSQL7 Server=SrvTOP01

Observao: Podemos especificar este parmetro para uso em um ambiente (environment) especfico, declarando esta chave, prefixada com TOP, dentro da seo do environment desejado. Vale lembrar que a configurao desta chave diretamente no environment tm precedncia sobre a especificao default na seo TopConnect.

Exemplo
[Environment] ... TOPAlias=BASE710 TOPConType=TCPIP TOPDataBase=ORACLE TOPServer=SrvTOP01

ProtheusOnly
Reviso: 30/04/2003

Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, setada dentro da seo [Topconnect] do Arquivo INI do Protheus Server, possvel realizar a conexo com o TopConnect, quando a configurao do Servidor do TopConnect estiver setada para apenas permitir conexes vindas do Protheus Server.

Valores vlidos

0 (Default) : Desabilitado 1 : Habilitado.

Exemplo
[Topconnect] Alias=BASE710 ConType=TCPIP DataBase=MSSQL7 Server=SrvTOP01 ProtheusOnly=1

Observao: Podemos declarar este parmetro para uso em um ambiente (environment) especfico, especificando esta chave, prefixada com TOP, dentro da seo do environment desejado. Vale lembrar que a configurao desta chave diretamente no environment tm precedncia sobre a especificao default na seo TopConnect.

Exemplo
[Environment] ... TOPAlias=BASE710 TOPConType=TCPIP TOPDataBase=ORACLE TOPServer=SrvTOP01 TOPProtheusOnly=0

IMPORTANTE: Quando da instalao do TopConnect, a configurao default permitir a conexo de outras aplicaes externas, alm do Siga Advanced Protheus. Caso a chave ProtheusOnly=1 seja usada no Protheus Server, e o Server TOP no seja configurado para apenas aceitar conexes do Protheus, ou vice-versa, no ser possvel realizar a conexo entre o Protheus Server e o TopConnect, sendo gerados os erros TOPCONN - ProtheusOnly e TOPCONN - No connection: -36, respectivamente. Para habilitar esta configurao no Servidor do TopConnect, verso Windows, devemos inserir uma entrada no Registry do Servidor, em HKEY_LOCAL_MACHINE\SOFTWARE\topconn.ini, a chave ProtheusOnly, tipo REG_DWORD, com o valor 1. Para habilitar esta configurao no Servidor do TopConnect, verso Linux / Unix, deve-se editar o arquivo TopConn.ini, e inserir nele a chave ProtheusOnly=1 Recomenda-se realizar esta alterao com o Servio do TopConnect parado. Caso ela seja realizada com o Servio do Top em funcionamento, o mesmo dever ser re-iniciado para que esta alterao tenha efeito.

Server
Reviso: 30/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, setada dentro da seo [Topconnect] do Arquivo INI do Protheus Server, informamos o IP ou o nome do Servidor default para estabelecer uma conexo com um Banco de Dados atravs do TopConnect. O Servidor especificado deve ter o TopConnect instalado e configurado.

Exemplo
[Topconnect] Alias=BASE710 ConType=TCPIP

DataBase=MSSQL7 Server=SrvTOP01

Observao: Podemos especificar um servidor de TopConnect para uso em um ambiente (environment) especfico, especificando esta chave, prefixada com TOP, dentro da seo do environment desejado. Vale lembrar que a configurao desta chave diretamente no environment tm precedncia sobre a especificao default na seo TopConnect.

Exemplo
[Environment] ... TOPAlias=BASE710 TOPConType=TCPIP TOPDataBase=ORACLE TOPServer=SrvTOP02

Observao 2: Quando instalamos o Server Protheus e o TopConnect no mesmo equipamento, podemos especificar a chave Server=LOCALHOST

TOPApi
Reviso: 26/04/2004 Abrangncia Verso 6.09 Verso 7.10 Verso 8.11

Descrio
Atravs desta chave, setada dentro da seo [Topconnect] do Arquivo .INI do Protheus Server, informamos a verso da DLL do Top utilizada pelo Protheus Server para estabelecer a conexo com o TopConnect.

Valores vlidos

TOPAPI32.DLL: Conexes com TopConnect com verso anterior 4.0 em ambiente Windows TOPAPI40.DLL: Conexes com TopConnect com verso 4.0 em ambiente Windows TOPAPI32.SO: Conexes com TopConnect com verso anterior 4.0 em ambiente Unix TOPAPI40.SO: Conexes com TopConnect com verso 4.0 em ambiente Unix

Exemplo
[Topconnect] Alias=BASE710 ConType=TCPIP DataBase=MSSQL7 Server=SrvTOP01 TOPApi=topapi40.dll

Observao: ESTE PARMETRO DIFERE DOS DEMAIS, POIS NO PODEMOS ESPECIFIC-LO DIRETAMENTE DENTRO DE UM ENVIRONMENT. ESTA CONFIGURAO EXCLUSIVA DA SEO TOPCONNECT, SENDO CONSIDERADA PARA TODOS OS ENVIROMNENTS DO PROTHEUS SERVER.

TOPCONNECT
Reviso: 22/02/2005 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

RELAO DE ERROS DO TOPCONNECT

Constant Name: TCF_NoError Value: 0 Meaning: A Chamada da Funo no foi completada como desejada. -------------------------------------------------------------------------------Constant Name: TCF_NoRouterInstalled Value: -1 Meaning: Voc est tentado executar a funo TC_Connect sem ter uma camada de comunicao.

Recovery: Voc necessita ter um Appc ou TCP/IP router disponvel -------------------------------------------------------------------------------Constant Name: TCF_NoConnection Value: -2 Meaning: Voc est tentado executar uma funo sem estabelecer conexo previa. Recovery: Execute a funo do TC_Connect -------------------------------------------------------------------------------Constant Name: TC_NoUserSecurity Value:-4 Meaning: Voc necessita fornecer um user+password vlido com o TC_Setuser Recovery: -------------------------------------------------------------------------------Constant Name: TCF_No_More_Connections Value: -6 Meaning: No H mais conexes disponveis. Recovery: Feche uma das conexes e tente nova conexo. -------------------------------------------------------------------------------Constant Name: TCF_ScanTableError Value: -7 Meaning: H uma diferena entre o formato do registro corrente que o AS/400 arquiva e o formato digitado na PC Table. Recovery: Obtenha o registro do formato AS/400 para o arquivo usando no programa do TClient, e check a tabela

-------------------------------------------------------------------------------Constant Name: TCF_InvalidFile Value: -10 Meaning: Voc est tentando abrir um arquivo que no pod ser encontrado Recovery: Verifique se o arquivo est na biblioteca indicada sobre abertura -------------------------------------------------------------------------------Constant Name: TCF_UnknownFile Value: -11 Meaning: Voc est tentando abrir um arquivo que no est associado com um processo no AS/400. Recovery: Verifique o identifier de tabela utilizado em abertura. -------------------------------------------------------------------------------Constant Name: TCF_InvalidProgram Value: -12 Meaning: O programa especificado na funo do TC_Call no pode ser encontrado. Recovery: Verifique a localizao do Nome do programa. -------------------------------------------------------------------------------Constant Name: TCF_InvalidOperation Value: -13 Meaning: O programa est utilizando uma funo invalida. Recovery: Cheque a existncia da funo. -------------------------------------------------------------------------------Constant Name: TCF_InvalidKeyNum Value: -14

Meaning: Voc tem especificado um nmero de campo chave maior que o arquivo, como uma funo de acesso chave. Recovery: Veja o valor de parmetro do n_keys -------------------------------------------------------------------------------Constant Name: TCF_TooManyFiles Value: -16 Meaning: Voc est tentando abrir um arquivo, mas o nmero de mximo de arquivos ao servidor excedeu. Recovery: Feche um dos arquivos abertos e tente abrir o arquivo outra vez. -------------------------------------------------------------------------------Constant Name: TCF_InvalidNumRecs Value: -17 Meaning: Um nmero negativo est especificado no parmetro do lock_or_count da operao multiple-read Recovery: Verifique o valor de parmetro do Lock_or_count da operao multiple-read. -------------------------------------------------------------------------------Constant Name: TCF_CallFailed Value: -18 Meaning: O programa que chamou a funo do TC_Call falhou. Recovery: Consulte no AS/400 as mensagens de erro. -------------------------------------------------------------------------------Constant Name: TCF_CommandFailed Value: -19 Meaning: O comando do OS/400 chamado na funo do TC_Call Falhou.

Recovery: Consulte no AS/400 as mensagens de erro. -------------------------------------------------------------------------------Constant Name: TCF_OverrideFailed Value: -20 Meaning: O OVRDBF comando de OS/400 est falhando na abertura o arquivo. Recovery: Consulte no AS/400 as mensagens de erro. -------------------------------------------------------------------------------Constant Name: TCF_QueryFailed Value: -21 Meaning: Um erro foi produzido no OPNQRYF ou no comando SELECT do AS/400 Recovery: Consulte no AS/400 as mensagens de erro. -------------------------------------------------------------------------------Constant Name: TCF_OpenFailed Value: -23 Meaning: O arquivo no pode ser aberto. Recovery: Consulte no AS/400 as mensagens de erro. -------------------------------------------------------------------------------Constant Name: TCF_NotOpened Value: -24 Meaning: Voc est tentando uma operao com um arquivo que no est aberto. Recovery: Verifique se o arquivo foi aberto apropriadamente. -------------------------------------------------------------------------------Constant Name: TCF_NoRecordFound

Value: -25 Meaning: O registro solicitado no pode ser encontrado como uma funo de acesso ao campo chave. Recovery: Verifique os valores do campo chave no registro. -------------------------------------------------------------------------------Constant Name: TCF_EndOfrecords Value: -26 Meaning: Voc chegou no fim do arquivo ou o fim de registros que esto em Read_Multiple. Recovery: Esta uma mensagem consultiva -------------------------------------------------------------------------------Constant Name: TCF_NoWritePossible Value: -27 Meaning: Voc no pode incluir um novo registro no arquivo. Recovery: Verifique o valor da chave de ndice em registro. Voc pode estar tentado escrever um registro com uma chave duplicada ou database est cheio. -------------------------------------------------------------------------------Constant Name: TCF_NoRecordEqual Value: -28 Meaning: No H registro pertencendo chave especificada na funo do TCF_ReadE. Recovery: Verifique o valor das chaves de ndice em registro. -------------------------------------------------------------------------------Constant Name: TCF_UpdateFailed Value: -29

Meaning: Voc no pode criar registro no arquivo. Recovery: Verifique a chave utilizada na criao, e assegure que o registro no esteja Locado. -------------------------------------------------------------------------------Constant Name: TCF_DeleteFailed Value: -30 Meaning: Voc no pode deletar o registro no arquivo. Recovery: Verifique a chave utilizada, e assegure que o registro no est Locado. -------------------------------------------------------------------------------Constant Name: TCF_RecordLocked Value: -31 Meaning: O registro est locado por outra tarefa. Recovery: Verifique qual a tarefa que no est liberando o registro -------------------------------------------------------------------------------Constant Name: TCF_NoAuthorization Value: -33 Meaning: O uso do TOPconnect no est autorizado. Recovery: Isto indica que a conexo com o AS/400 no pode ser completada porque a chave do TOPConnect invlida ou est expirada. -------------------------------------------------------------------------------Constant Name: TCF_TooManyUsers Value: -34 Meaning: O nmero de mximo de usurios conectados foi alcanado. Recovery: Alguns usurios devero desconectar ou mais licenas sero necessitadas.

-------------------------------------------------------------------------------Constant Name: TCF_NoDBConnection Value: -35 Meaning:O Database no pode ser acessado. Recovery: -------------------------------------------------------------------------------Value: -58 Meaning: 'No H Memria Do DOS' Recovery: Indica que no pode ter o desempenhado necessario devido insuficincia de memria corrente para a situao. -------------------------------------------------------------------------------Value: -90 Meaning: ' Memria Insuficiente' Recovery: Indica que o trabalho no pode ser feito devido a insuficincia de Memria do PC . Corrija a situao. -------------------------------------------------------------------------------Value: -99 Meaning: 'Build Invlido' Recovery: Build Protheus incompatvel com verso do TopConnect. Certifique-se que ambos estejam atualizados.. UPDATE APENAS 8.11

Atualizao Automtica do Remote Protheus 8


Reviso: 04/08/2005

Abrangncia Verso 8.11

Atualizao Automtica do Remote Protheus 8


Para agilizar a atualizao do Protheus Remote nas estaes, possvel configurar uma mquina com a verso mais recente e, a partir dela, efetuar a atualizao automtica nas estaes. Para habilitar este procedimento, necessrio incluir a seo 'UPDATE', no arquivo MP8SRV.INI, com as seguintes chaves: [UPDATE] Enable=1 PathWindows=<localizao do Remote atualizado> (Se utilizado ambiente remote em Windows) PathLinux=<localizao do Remote atualizado> (Se utilizado ambiente remote em Linux) Exemplo de Configurao Servidor Protheus no Windows: [UPDATE] Enable=1 PathWindows=c:\protheus8\bin\remote_upd PathLinux=c:\protheus8\bin\remote_linux_upd Exemplo de Configurao Servidor Protheus no Linux: [UPDATE] Enable=1 PathWindows=/microsiga/protheus8/bin/remote_upd PathLinux=/microsiga/protheus8/bin/remote_linux_upd

Quando uma estao carregar o Protheus Remote, o sistema ir verificar se o Build do Remote compatvel com o servidor. Caso os Builds sejam compatveis, ao iniciar qualquer mdulo do ERP, e o recurso de atualizao automtica estiver devidamente configurado e habilitado, sero verificados automaticamente os arquivos da pasta especificada no servidor para atualizao, e s arquvios da pasta do Remote em execuo na estao. Caso um arquivo existente no servidor no seja encontrado na estao, ele copiado para a mesma. Caso os arquivos existam, porm o arquivo apresente alguma diferena ( Tamanho, Data e/ou Horrio ) , o arquivo tambm copiado do servidor para a estao. Este processo executado automaticamente, mostrando na tela do remote uma janela, informando sobre o progresso da verificao / atualizao:

Caso o Build do Remote na estao no seja compatvel com o Servidor em uso, e o recurso de atualizao automtica estiver devidamente configurado e habilitado, ser apresentada ao usurio a seguinte mensagem:

Ao confirmar a atualizao, ser apresentada uma janela com a progresso do processo.

Todos os arquivos gravados no diretrio informado para atualizao no Protheus Server sero copiados para a estao onde se encontra o Protheus Remote, inclusive os arquivos INI. O Protheus Server enviar estao remota os arquivos correspondentes ao sistema operacional que o Protheus Remote utiliza: Windows ou Linux.

Requisitos para Atualizao Automtica


Para que a atualizao automtica seja realizada corretamente, importante observar: Os arquivos constantes nas pastas de atualizao no Protheus Server devero estar descompactados; O usurio deve ter direito de gravao no diretrio do Protheus Remote da estao onde este aplicativo est sendo executado / atualizado; Quando utilizamos o Protheus Server em ambiente Linux, os arquivos das pastas de atualizao automtica devem conter apenas letras minsculas, mesmo que se destinem atualizao de um Protheus Remote para ambiente Windows;

IMPORTANTE : Ao definir a(s) pasta(s) para conter os arquivos a serem atualizados do Protheus Remote no servidor, devemos criar uma pasta especfica para esta finalidade, e no utiliz-la para execuo do Protheus Remote na estao servidora. Para que, nesta pasta, existam apenas os arquivos da pasta Remote que devam ser enviados todas as estaes remotas.

Caractersticas da Atualizao Automtica


No necessrio utilizar FTP, CABs ou compartilhamentos de rede para esta atualizao, pois o Remote utilizar o prprio protocolo de conexo do Protheus para fazer a atualizao. Os arquivos so copiados para uma pasta temporria na estao remota, criada a partir da pasta onde est sendo executado o Protheus Remote. A aplicao Remote cria automaticamente uma pasta de backup, onde realizada uma cpia de segurana de todos os arquivos da pasta atual do Protheus Remote, antes de efetivar a atualizao. So mantidas na estao 03 (trs) cpias de segurana dos arquivos do Protheus Remote, referente s trs ltimas atualizaes efetuadas. As pastas so criadas seqencialmente, a cada atualizao efetuada, com os nomes de backup.001, backup .002 e backup .003. Caso as trs pastas j existam no momento da execuo da atualizao, a pasta backup.001 eliminada, as pastas .002 e .003 so renomeadas para .001 e .002, respectivamente, e uma nova pasta backup .003 criada para conter a cpia de segurana mais recente dos arquivos. Em caso de impossibilidade ou falha da rotina de atualizao automtica, o Protheus Remote exibir uma janela contendo a mensagem No foi possivel atualizar automaticamente o Remote. Neste caso, o administrador do sistema deve ser notificado, e verificar se os requisitos para o funcionamento da atualizao foram preenchidos.

Mensagens da Rotina de Atualizao Automtica


Reviso: 02/03/2005 Abrangncia Verso 8.11

Mensagens da Rotina de Atualizao Automtica

A partir do Protheus 8, Build 7.00.050131a, as mensagens de falha na execuo da rotina de atualizao automtica passaram a fornecer maiores detalhes sobre a ocorrncia, tanto na aplicao Protheus Remote, como tambm no console do Protheus Server, de modo a auxiliar o administrador do ambiente a identificar a causa da ocorrncia. Ocorrncia: No foi recebido nenhum arquivo a atualizar.

Possveis causas: O diretrio especificado para a atualizao, na configurao do Protheus Server, no contm nenhum arquivo a atualizar. Verifique se o diretrio informado existe no ambiente do servidor, e se os arquivos do Protheus Remote para atualizao encontram-se no diretrio informado. Neste caso, exibido no console do Protheus Server a seguinte mensagem:

[02/02/2005 16:50:36] Starting Thread for remote update *** WARNING: Update directory [c:\mp8\bin\rmtupd_windows\] EMPTY. *** UNABLE TO PROCEED WITH AUTOMATIC REMOTE UPDATE *** Please verify update server path. [02/02/2005 16:50:54] Finishing Thread for remote update O Protheus Server foi atualizado, porm o diretrio especificado para a atualizao dos arquivos do Protheus Remote no foi atualizado. Quando uma estao remota iniciar o Protheus Remote, e proceder com a atualizao automtica, caso os arquivos da estao estejam atualizados em relao aos arquivos informados no Protheus Server, o servidor no enviar nenhum arquivo estao remota. Verifique se os arquivos colocados na pasta configurada para atualizao no Protheus Server so compatveis com o build do servidor Protheus atualmente em uso. Neste caso, exibido no console do Protheus Server a seguinte mensagem:

[02/02/2005 17:03:22] Starting Thread for remote update *** WARNING : Build mismatch on files in update server. *** Verify if remote update files math with this Protheus Build. [02/02/2005 17:03:25] Finishing Thread for remote update O Protheus Server est sendo executado em um ambiente Linux / Unix, e existem um ou mais arquivos no diretrio de atualizao configurado no Protheus Server, que possuem em seu nome catacteres em letra maiscula. Todos os arquivos colocados nos diretrios de atualizao automtica configurados no Protheus Server, quando trabalhamos com o mesmo em ambiente Linux, devem ser colocados em letras minsculas. Neste caso, os nomes de todos os arquivos invlidos so exibidos no console do Protheus Server, atravs da seguinte mensagem:

*** WARNING : Invalid update file [/protheus8/bin/remote_windows/ApExcel.xla]

Ocorrncia: No foi possvel atualizar o executvel do Protheus Remote

Possveis causas: O diretrio especificado para a atualizao, na configurao do Protheus Server, no contm o executvel do Protheus Remote. Verifique no servidor, se o arquivo executvel do remote encontra-se na pasta de atualizao. O arquivo executvel do Protheus Remote est com um atributo de somente-leitura ligado. Retire o atributo de somente-leitura do arquivo. O usurio logado na estao remota no tem direito de escrita no diretrio de trabalho do Protheus Remote. Verifique os direitos do usurio logado na estao remota.

Ocorrncia: No foi possvel atualizar um arquivo do Protheus Remote Arquivo [xxxxxxxx]

Possveis causas: O arquivo informado na mensagem est com um atributo de somenteleitura ligado. Retire o atributo de somente-leitura do arquivo. O arquivo informado na mensagem pode estar em uso por outra aplicao da estao. Verifique se no existe outra aplicao que esteja realizando algum acesso a este arquivo. Feche os demais aplicativos da estao para certificar-se disso. O usurio logado na estao remota no tem direito de escrita no diretrio de trabalho do Protheus Remote. Verifique os direitos do usurio logado na estao remota.

Ocorrncia: No foi possvel atualizar o atributo de execuo do Protheus Remote.

Observao: Ocorrncia reproduzida apenas na atualizao remota de estaes Linux. Possveis causas: Verificar se o usurio atualmente logado na estao remota possui direitos para alterao do atributo do executvel do Protheus Remote.

Ocorrncia: No foi possvel identificar os arquivos no diretrio do Protheus Remote Possveis causas: Verificar se o usurio atualmente logado na estao remota possui direitos de leitura no diretrio de trabalho do Protheus Remote.

Verificar a localizao fsica dos arquivos do Protheus Remote na estao remota, e de que maneira a aplicao Protheus Remote est sendo executada; caso esteja sendo executado a partir de um 'atalho', verificar se o diretrio de trabalho do atalho o mesmo em que se encontra o executvel do Protheus Remote.