Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. SINTAXE

Bloco de código
themeEclipse
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

Inclusão de trecho
AdvPL
AdvPL
nopaneltrue
com a informação desejada.

04. OBSERVAÇÕES


Nota
titleAtençã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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.


2

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.


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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.


6

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.


7

Retorna o latência entre o 

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
e o SGDB.


8

Retorna o latência entre o 

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
Slave e o 
Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
Master (Somente se estiver utilizando a configuração distribuída).


9

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.


10

Retorna lista de threads conectadas neste

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
, separadas por vírgula.


11

Retorna Lista de registros locados neste

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.
Caso seja informado o número de uma conexão do
Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
em cParam, serão retornados somente os locks que o processo indicado seja dono.

Nota

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.

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

Nota

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
.

Nota

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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
, 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

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
: STANDALONE, SLAVE ou MASTER


16

Caso o

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
esteja em modo SLAVE, retorna o IP ou nome do host, seguido da porta do
Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
configurado como MASTER, separado pelo identificador ':' (dois pontos)


17

Retorna uma lista com as Threads do

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
em que se está conectado, com seus respectivos statements em execução.


18

Retornar a arquitetura do

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
onde se está conectado - 32Bits ou 64Bits.


19

Retornar o sistema operacional de onde o 

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
em que se está conectado, está em execução - Windows ou Linux.


20

Retornar o modo de execução do 

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
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 

Inclusão de trecho
dbaccess
dbaccess
nopaneltrue
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.

Estado
titleem 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.

Estado
colourGrey
titleem desenvolvimento

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

Estado
colourGrey
titleem 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.

Estado
colourGrey
titleem desenvolvimento

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

Estado
colourGrey
titleem desenvolvimento

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

05. EXEMPLOS

Bloco de código
themeEclipse
user function test()
  TCLink()

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

  TCUnlink()

return

06. NESSA SEÇÃO

Page Tree
root@parent
reversetrue

07. VEJA TAMBÉM

Templatedocumentos