TOTVSTEC

Árvore de páginas



c-tree - Carga de Callback (Windows/Linux)

O banco de dados c-tree Server, disponibilizado pela TOTVS S.A., possui uma funcionalidade especial, chamada de CallBack, utilizada para a resolução de expressões de filtro que não são possíveis de serem resolvidas pelo banco.




Este recurso é instanciado dinamicamente pelo c-tree Server®, no momento em que o mesmo é iniciado. No ambiente Windows, o arquivo chamas-se ctreecb.dll e no Linux, chama-se ctreecb.so.

O arquivo do CallBack, disponibilizado junto da distribuição do c-tree Server® realizada pela TOTVS S.A., é um recurso que não é atualizado constantemente, porém, é importante que os ambientes com servidor TOTVS seja atualizado e o c-tree Server® possua o CallBack atualizado também.


Falha de carga

Ao iniciar a aplicação (Exemplo: ERP), o primeiro programa AdvPL que estabelecer conexão com o c-tree Server® verificará se a carga foi realizada com sucesso. Se houver alguma falha na carga do recurso, o sistema apresentará a seguinte mensagem no console do TOTVS | Application Server:


  • Ambiente Linux

     

Loading Ctree Client [/home/siga0984/space/ap7/bin_050331a/server_1/libmtclient.so]
******************************************************************
CtreeServer Could not Load ctreecb.so
Make sure that ctreecb.so is on Unix default library path
******************************************************************


  • Ambiente Windows

Loading Ctree Client [mtclient.dll]
******************************************************************
CtreeServer Could not Load ctreecb.dll
Make sure that ctreecb.dll is on Ctree Server's path
******************************************************************


Além disso, no console do c-tree Server, também serão apresentadas mensagens de falha na carga.


  • Ambiente Windows

LoadProtheus Error - Could not open ctreecb.dll - ERROR: 126
It was not possible to load ctreecb.dll


  • Ambiente Linux

     

PROTHEUS: It was not possible to load libctreecb.so - libctreecb.so: cannot open shared object file: No such file or directory


A falha na carga da dll/so do callback repercute em uma consequência: Expressões de filtro que utilizam expressões e funções AdvPL, que não são resolvidas pelo banco de dados, não conseguem ser resolvidas. Logo, resultam em erro fatal no AdvPL, quando da tentativa de navegação na tabela filtrada. O erro gerado corresponde ao erro 598: Could not evaluate conditional expression.

Exemplo

************************ (AUTOMAN,julio) ************************
First - Ctree Error 598 - IO Error: 0 - Could not evaluate conditional expression.
File: d:\ap7\ap_test\advpltests_top_ctree\sigaadv\sx2010.dtc


Em geral, as ocorrências de erro mais comuns de falha na carga do callback são reproduzidas no ambiente Linux, quando o c-tree Server® é carregado, sem que antes tenhas sido setada a variável de ambiente do Linux LD_LIBRARY_PATH, apontando para o path onde está sendo executado o c-tree Server®.

Para mais detalhes, consulte a documentação de instalação/configuração do c-tree Server em ambiente Linux.


Particularidades do ambiente Linux

Em ambiente Linux, esta ocorrência de falha de resolução de expressão de filtro pode ter outra causa, também relacionada a falha na carga do callback. Mesmo setando a variável de ambiente LD_LIBRARY_PATH, deve-se ter cautela para não instalar o c-tree Server® em um path no Linux, que contenha qualquer letra maiúscula no path de acesso ao c-tree Server®. O sistema (ERP) possui esta característica operacional e o callback também possui essas características.

Caso o c-tree Server® seja instalado em um path que contenha alguma letra maiúscula no caminho, o callback será carregado com sucesso. Porém, no momento de sua utilização no c-tree Server®, ocorrerá um erro de inicialização do callback.

Desta forma, será apresentada um mensagem, no console do c-tree Server,

jA não encontrado
DU6 W6 8UA\¾l¾D¾³':A
Ctree CallBack Error - Session [envctree710] not found in ap.ini. Verify the 'Environment in the Server' in file ./lib/config.cpp at line 58



  • Sem rótulos