TOTVSTEC

Árvore de páginas

Solicita ao Pool de Conexões AdvPL uma conexão com o DBAccess, previamente criada.

Sintaxe

TCGetPool( < cPool > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cPool

caractere

Nome do pool de onde será solicitada uma conexão.

X


Retorno

Nome

Tipo

Descrição

nRet

numérico

Retorna um valor numérico maior ou igual a 0 (zero) para casos de sucesso.

Atenção

Esta função não está disponível para uso com RPODB=SQLITE.

Observações

  • A TCGetPool não cria novas conexões caso não exista nenhuma disponível no pool
  • Será apresentado erro -35 caso ocorra erro na obtenção de uma conexão, ou caso não haja conexão disponível
  • Após utilizar uma conexão do pool, para encerrá-la, deve-se utilizar a função TCUnLink
  • Após utilizar uma conexão do pool, caso quiser devolvê-la ao pool, deve-se utilizar a função TCSetPool
  • Caso utilize uma conexão do pool e não a devolva, ela ficará ativa e só será destruída após o timeout da engine de pool (default: 60 segundos)
  • Para saber como definir o timeout do Pool de Conexão, leia a documentação da chave DBPool.

Exemplos

user function exemplo
  
  TCLink()
  TCSetPool("MYPOOL")
  conout("Erro na execucao da TCGetDB(). Nao ha conexao ativa.")
  conout("Retorno da TCGetDB(): '" + TCGetDB() + "'")
    
  TCGetPool("MYPOOL")
  conout("Sucesso na execucao da TCGetDB(). Ha conexao ativa")
  conout("Retorno da TCGetDB(): '" + TCGetDB() + "'")
  
  TCUNLink()
  
return

Veja também


  • Sem rótulos