TCGetInfo

Retorna informações sobre o DBAccess conectado atualmente

Sintaxe

TCGetInfo( [ nInfo ], [ cParam ] )

Parâmetros

Retorno

Observações

• Veja abaixo as informações implementadas:
  • 1 - Retorna o nome completo da Build do DBAccess.
  • 2 - Retorna uma string contendo o total de CPU em uso na máquina onde está instalado o DBAccess. Caso seja uma máquina Windows, retorna o percentual de 0 a 100 %. Para ambiente Linux, retorna o Load Average da máquina.
  • 3 - Retorna a quantidade de memória (em KB) consumida pelo serviço do DBAccess.
  • 4 - Retorna informação sobre a versão do sistema operacional.
  • 5 - Retorna string com informações de memória da máquina e do aplicativo DBAccess.
  • 6 - Retorna o número de conexões atualmente estabelecidas com este DBAccess.
  • 7 - Retorna o latência entre o DBAccess e o SGDB.
  • 8 - Retorna o latência entre o DBAccess Slave e o DBAccess Master (Somente se estiver utilizando DBAccess Distribuído).
  • 9 - Retorna a quantidade de memória (em KB) consumida pela thread do DBAccess.
• A partir da Build em desenvolvimento, a função passa a retornar as seguintes informações:
  • 10 - Retorna lista de threads conectadas neste DBAccess, separadas por virgula.
  • 11 - Retorna Lista de registros locados neste DBAccess. Colunas separadas por TAB (ASCII 9), linhas separadas por LF (ASCII 10).
    Caso seja informado o número de uma conexão do DBAccess em cParam, serão retornados somente os locks que o processo indicado seja dono.
  • 12 - Retorna Lista de registros locados neste DBAccess. Colunas separadas por TAB (ASCII 9), linhas separadas por LF (ASCII 10).
    Caso seja informado um número de segundos em cParam, serão retornados apenas os locks mantidos pelo tempo indicado ou superior.
  • 13 - Retorna uma string contendo todas as informações da conexão atual do DBAccess. Colunas separadas por TAB (ASCII 9) , linhas separadas por LF (ASCII 10).
  • 14 - Deve ser informado em cParam o número de uma conexão do DBAccess, para que seja retornada uma string contendo as informações desta conexão – as informações retornadas são as mesmas da opção 13, porém a conexão deve ser especificada.
  • 15 - Retorna uma string indicando o modo de configuração do DBAccess: STANDALONE, SLAVE ou MASTER
  • 16 - Caso o DBAccess esteja em modo SLAVE, retorna o IP ou nome do host, seguido da porta do DBAccess configurado como MASTER, separado pelo identificador ':' (dois pontos)
  • 17 - Retorna uma lista com as Threads do DBAccess em que se está conectado, com seus respectivos statements em execução.
  • 18 - Retornar a arquitetura do DBAccess onde se está conectado - 32Bits ou 64Bits.
  • 19 - Retornar o sistema operacional de onde o DBAccess em que se está conectado, está em execução - Windows ou Linux.
  • 20 - Retornar o modo de execução do DBAccess onde se está conectado - Release ou Debug.
  • 21 - Retorna uma string, 0 (zero) ou 1, indicando se o DBAuditTrail está configurado para o ambiente em que se está conectado.
  • 22 - Retorna o valor (em bytes) definido na chave de configuação MaxStringSize.
  • 23 - Retorna o endereço e porta do DBAccess Mirror, caso configurado.
  • 24 - Retorna uma lista de processos que estão com uma determinada tabela aberta.
  • 25 - Retorna uma string, 0 (zero) ou 1, indicando se a configuração DataReadOnly está desativada ou ativada.
  • 26 - Retorna uma string, 0 (zero) ou 1, indicando se a configuração ReadOnly está desativada ou ativada.
• A função TCGetInfo() somente está disponível a partir do TOTVS Application Server Build 7.00.131227A e superiores, com data de geração igual ou superior a 03/02/2017.
• O uso desta função também requer a atualização do DBAccess Server, Build 20170202, release 17.1.1.0 ou superior.

Exemplos

user function test()

  TCLink()

  For nI := 1 to 26
    conout('SLOT ' + cValToChar(nI) + ":" + TCGetInfo(nI))
  Next

  TCUnlink()
return

Veja também

• TCLink