TOTVSTEC

Árvore de páginas

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 AdvPL com a informação desejada.

04. OBSERVAÇÕES


Atenção

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 TOTVS | DBAccess.


2

Retorna uma string contendo o total de CPU em uso na máquina onde está instalado o TOTVS | 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 TOTVS | 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 TOTVS | DBAccess.


6

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


7

Retorna o latência entre o TOTVS | DBAccess e o SGDB.


8

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


9

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


10

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


11

Retorna Lista de registros locados neste TOTVS | DBAccess.
Caso seja informado o número de uma conexão do TOTVS | DBAccess 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 TOTVS | DBAccess.

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


16

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


17

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


18

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


19

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


20

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


23

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


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.

EM DESENVOLVIMENTO

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.

EM DESENVOLVIMENTO

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

EM DESENVOLVIMENTO

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.

EM DESENVOLVIMENTO

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

EM DESENVOLVIMENTO

  • A função TCGetInfo somente está disponível no TOTVS | Application Server Build com build superior a 7.00.131227A.
  • O uso desta função também requer a atualização do TOTVS | DBAccess 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


  • Sem rótulos