REMOTE Sesses e chaves do arquivo de configuraoReviso:
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 =
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 = 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_----.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 = mapeamento da porta lpt, 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
opcional para impresso mapeada, deve ter sintaxe como o exemplo:
'lpr -P -l -r ' onde e sero substitudos pelo Protheus Remote no
momento da execuo da impresso. REMOTE ACTIVE X
Auto-atualizaoReviso: 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 .htmReviso: 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: Protheus
Remote 7 // se desejar permitir alterao de valores na tela inicial
do Protheus Remote ActiveX // se desejar conexo segura, o Protheus
Server deve estar configurado para aceitar conexes seguras // se
habilita o uso do MS-Internet Explorer dentro do Remote Protheus
ActiveX 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 produtoReviso: 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
DesinstalaoReviso: 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 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...'
InstalaoReviso: 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.
SeguranaReviso: 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 APSRV.INI, onde 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.
ExemploNo 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
ADSShareReviso: 29/04/2003 Abrangncia
Verso 5.07
Verso 5.08
Verso 6.09
Verso 7.10
Verso 8.11
DescrioIndica 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
DescrioQuando 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
ConnectionTimeoutReviso: 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 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.
CtreeRootPathReviso: 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
FilesOnDemandReviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08
Verso 6.09 Verso 7.10 Verso 8.11
DescrioEsta 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
LocalDbExtensionReviso: 29/04/2003 Abrangncia Verso 6.09 Verso
7.10 Verso 8.11
DescrioDefine 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 vlidosSo 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
LocalFilesReviso: 22/02/2005 Abrangncia Verso 5.07 Verso 5.08
Verso 6.09 Verso 7.10 Verso 8.11
DescrioIndica 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
DescrioA 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 vlidosNumrico 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
PictFormatReviso: 27/04/2005 Abrangncia Verso 6.09 Verso 7.10
Verso 8.11
DescrioEsta 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.
ObservaoEsta configurao considerada pelas rotinas de inicializao
do ambiente ERP Microsiga.
RootPathReviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08
Verso 6.09 Verso 7.10 Verso 8.11
DescrioIdentifica 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
DescrioIdentifica 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
RpoLanguageReviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08
Verso 6.09 Verso 7.10 Verso 8.11
DescrioIdentifica 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
RpoVersionReviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08
Verso 6.09 Verso 7.10 Verso 8.11
DescrioIdentifica 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
SourcePathReviso: 23/02/2005 Abrangncia Verso 5.07 Verso 5.08
Verso 6.09 Verso 7.10 Verso 8.11
DescrioIdentifica 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.
TraceReviso: 29/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso
6.09 Verso 7.10 Verso 8.11
DescrioIndica 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
WSPLReldirReviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10
Verso 8.11
DescrioDefine 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\
WSPLServerReviso: 29/04/2003
Abrangncia Verso 6.09 Verso 7.10 Verso 8.11
DescrioDefine 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
CtreeServerReviso: 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.
CTServerNameReviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10
Verso 8.11
DescrioAtravs 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 VlidosAmbiente Windows @SERVERNAME Ambiente Linux
@SERVERIP
Exemplo[CTREESERVER] CTUserId=ADMIN CTUserPass=ADMIN
CTServerName=FAIRCOMS@SERVERNAME
CTUserIdReviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10
Verso 8.11
DescrioAtravs 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
CTUserPassReviso: 29/04/2003 Abrangncia Verso 6.09 Verso 7.10
Verso 8.11
DescrioAtravs 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 ServerReviso: 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 APSRV.INI, onde 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
FtpReviso: 09/06/2003
Servios de FTPO 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
CanAcceptAnonymousReviso: 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)
EnableReviso: 30/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso
8.11
DescrioIdentifica 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
PathReviso: 30/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso
8.11
DescrioIdentifica 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
PortReviso: 30/04/2003 Abrangncia Verso 6.09 Verso 7.10 Verso
8.11
DescrioPermite 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
PortReviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11
DescrioIndica a porta de conexo a ser utilizada para conexo com
o Servidor de Licencas.
Exemplo[LicenseClient] Port=2000 Server=localhost
ServerReviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11
DescrioIndica o IP ou Nome do Servidor Protheus habilitado como
Servidor de Licenas.
Exemplo[LicenseClient]
Port=2000 Server=localhost
LicenseServerReviso: 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.
EnableReviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11
DescrioIndica se este Server Protheus ser habilitado como
Servidor de Licenas.
Valores vlidos
0 : Desabilitado 1 : Habilitado
Exemplo[LicenseServer] Enable=1 Port=2000 ShowStatus=1
PortReviso: 30/04/2003 Abrangncia Verso 7.10 Verso 8.11
DescrioIndica 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
ShowStatusReviso: 30/04/2003 Abrangncia Verso 7.10 Verso
8.11
DescrioHabilita mensagens de controle na tela console do
Protheus Server.
Valores vlidos
0 : Desabilitado 1 : Habilitado
Exemplo[LicenseServer] Enable=1 Port=2000 ShowStatus=1
OnStartReviso: 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"
RefreshRateReviso: 10/03/2004 Abrangncia Verso 5.07 Verso 5.08
Verso 6.09 Verso 7.10 Verso 8.11
DescrioDetermina 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.
ObservaoEsta 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 ServerReviso: 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 APSRV.INI, onde 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
CertificateServerReviso: 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.
KeyServerReviso: 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.
PassPhraseReviso: 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
TopConnectReviso: 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.
AliasReviso: 30/04/2003
Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso
8.11
DescrioAtravs 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
ConTypeReviso: 30/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso
6.09 Verso 7.10 Verso 8.11
DescrioAtravs 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.
DataBaseReviso: 30/04/2003
Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso
8.11
DescrioAtravs 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
ProtheusOnlyReviso: 30/04/2003
Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso
8.11
DescrioAtravs 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.
ServerReviso: 30/04/2003 Abrangncia Verso 5.07 Verso 5.08 Verso
6.09 Verso 7.10 Verso 8.11
DescrioAtravs 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
TOPApiReviso: 26/04/2004 Abrangncia Verso 6.09 Verso 7.10 Verso
8.11
DescrioAtravs 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.
TOPCONNECTReviso: 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 8Reviso: 04/08/2005
Abrangncia Verso 8.11
Atualizao Automtica do Remote Protheus 8Para 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= (Se utilizado
ambiente remote em Windows) PathLinux= (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 AutomticaPara 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 AutomticaReviso: 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.