01. SINTAXE

TCGetInfo( < nSlot >, [ cParam ] )

02. PARÂMETROS

Nome

Tipo

Descrição

Obrigatório

Referência

nSlot

numérico

Indica o número do slot de informação a ser recuperada.

X


cParamcaractereAlguns slots de informação podem receber um parâmetro adicional ou critério de informação de retorno.



03. RETORNO

Nome

Tipo

Descrição

cInfoStr

caractere

Retorna uma string com a informação desejada.

04. OBSERVAÇÕES


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


Veja abaixo uma lista dos slots/informações que podem ser recuperadas:

Slot

Descrição

Observação

1

Retorna o nome completo da Build do .


2

Retorna uma string contendo o total de CPU em uso na máquina onde está instalado o .

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 .


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 .


6

Retorna o número de conexões atualmente estabelecidas com este .


7

Retorna o latência entre o  e o SGDB.


8

Retorna o latência entre o  Slave e o  Master (Somente se estiver utilizando a configuração distribuída).


9

Retorna a quantidade de memória (em KB) consumida pela thread do .


10

Retorna lista de threads conectadas neste , separadas por vírgula.


11

Retorna Lista de registros locados neste .
Caso seja informado o número de uma conexão do em cParam, serão retornados somente os locks que o processo indicado seja dono.

Colunas separadas por TAB (ASCII 9), linhas separadas por LF (ASCII 10).

O número da conexão é o mesmo retornado pela função TCGetSID.



12

Retorna Lista de registros locados neste .

Caso seja informado um número de segundos em cParam, serão retornados apenas os locks mantidos pelo tempo indicado ou superior.

Colunas separadas por TAB (ASCII 9), linhas separadas por LF (ASCII 10).



13

Retorna uma string contendo todas as informações da conexão atual do .

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 , 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 : STANDALONE, SLAVE ou MASTER


16

Caso o esteja em modo SLAVE, retorna o IP ou nome do host, seguido da porta do configurado como MASTER, separado pelo identificador ':' (dois pontos)


17

Retorna uma lista com as Threads do em que se está conectado, com seus respectivos statements em execução.


18

Retornar a arquitetura do onde se está conectado - 32Bits ou 64Bits.


19

Retornar o sistema operacional de onde o  em que se está conectado, está em execução - Windows ou Linux.


20

Retornar o modo de execução do  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 configuração MaxStringSize.


23

Retorna o endereço e porta do  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.


27

Retorna uma string informando o table space configurado. Se o retorno estiver vazio, não há configuração de table space para o DSN.

28

Retorna uma string informando o index space configurado. Se o retorno estiver vazio, não há configuração de index space para o DSN.

29Retorna uma string, 0 (zero) ou 1, indicando se a conexão atual é ODBC ou não.

30

Retorna uma string indicando o status de um Alter Table em execução.
Caso seja informado um alias de tabela, retorna o status apenas dessa tabela. Caso contrário, o status de todas as tabelas.

31Retorna uma string indicando o nome do tablespace utilizado para campos do tipo LOB (apenas para Oracle)

  • A função TCGetInfo somente está disponível no  Build com build superior a 7.00.131227A.
  • O uso desta função também requer a atualização do  Server, Build 20170202, release 17.1.1.0 ou superior

05. EXEMPLOS

user function test()
  TCLink()

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

  TCUnlink()

return

06. NESSA SEÇÃO

07. VEJA TAMBÉM