Get application info

4D v18


Get application info -> Resultado

Parâmetro	Tipo	Descrição
Resultado	Objeto	Informação sobre a atividade da aplicação ativa

Descrição

O comando Get application info retorna um objeto que traz informação detalhada sobre a atividade da aplicação ativa e da configuração de rede.

O comando pode ser executado em aplicações rodando tanto em modo standalone e ambientes cliente/servidor. A informação retornada depende de onde Get application info for executado. Por exemplo, se executado a partir de um 4D remoto, a informação se aplica apenas a uma workstation remota. Entretanto, se o comando for selecionado, a informação retornada aplica ao servidor.

O objeto retornado contém as propriedades abaixo:

Propriedade Tipo Descrição Exemplo

volumeShadowCopyStatus

string

Retorna o estado do Serviço Volume Shadow Copy. Só para Windows. Para saber mais, veja Usar Serviço Volume Shadow Copy em Windows.

Valores possíveis:

Constante	Valor	Comentário
vss available	available	O serviço está disponível
vss error	error	O serviço experimentou um erro.
vss not available	notAvailable	O serviço não está disponível
vss update required	updateRequired	O serviço precisa ser atualizado

"available"

launchedAsService boolean True se a aplicação for lançada como um serviço. Valores possíveis: true, false. Para saber mais, veja Registrar um banco de dados como serviço. false

portID number 4D Server: port para active listening, 4D remote: port para conexões remotas. Não retorna nada em modo standalone. Minimum: 1. Para saber mais, veja Número de porta. 19814

TLSEnabled boolean True se TLS estiver ativado para comunicações cliente/servidor. Não retorna nada em modo standalone. Valores possíveis: true, false. Para saber mais, veja O protocolo SSL e as conexões cliente/servidor. true

newConnectionsAllowed boolean Só em 4D Server. True se novas conexões forem permitidas. Valores possíveis: true, false. Para saber mais, veja Botão Aceitar/Rejeitar novas conexões. true

cpuUsage number Porcentagem do processador usada por 4D. Note que para Macs o número exibido é para 1 núcleo e representa uma média para o processador. 10.03

headless boolean True se a aplicação estiver rodando em modo headless. Valores possíveis: true, false. Para saber mais, veja Apêndice B: 4D usando linhas de comando. false

uptime number Tempo decorrido (em segundos) desde que o banco de dados 4D local foi aberto. Para conexões remotas, retorna o tempo que passou desde que a conexão começou. 143

pid number ID da instância do processo da aplicação 4D (fornecida pelo OS) -- permite identificar cada instância 4D executando, por exemplo a partir de um script externo 16600

networkInputThroughput number A taxa de dados (bytes/segundos) para input de rede da máquina rodando a aplicação. Em modo remoto, a taxa para a máquinia remota é retornada. Para saber mais, veja Página Monitor. 37311495

networkOutputThroughput number A taxa de dados (bytes/segundos) para output de rede da máquina rodando a aplicação. Em modo remoto, a taxa para a máquina remota é retornada. Para saber mais, veja Página Monitor. 88058023

useLegacyNetworkLayer boolean True se a capa de rede legado usada para a aplicação servidor. Não retorna nada em modo standalone. Valores possíveis: true, false. Para saber mais, veja Ativar ou desativar a capa de rede antiga. false

IPAddressesToListen collection Só em 4D Servidor. Retorna o endereço IP que o Servidor 4D escuta. Para saber mais, veja IP configuration. ["192.168.18.12","192.168.18.10"]

IPAddressesAllowDeny collection Só em 4D Servidor. Retorna uma coleção de endereços IP que são permitidos ou negados nas configurações de banco de dados. Para saber mais, veja IP configuration. [{"mode": "allow", "ip": "192.168.*"},{...}]

[ ].mode string Propriedade descrevendo se o endereço IP é permitido ou não. Valores possíveis: : "allow" ou "deny" "allow"

[ ].ip string IP addresses "192.167.1.2"

(*) Em Windows, deve ser iniciado previamente este contador, por exemplo, mediante uma chamada ao comando Get application info em Método banco de dados On Startup.

Exemplo

O código abaixo retorna um objeto que contém informação sobre a aplicação que está rodando:

 C_OBJECT($appInfo)

 $appInfo:=Get application info

Se o código for executado de um ambiente standalone, o objeto vai conter (por exemplo):


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.035875,
    "uptime": 469,
    "networkInputThroughput": 377263157,
    "networkOutputThroughput": 12345242236 
}

Se o código for executado de um cliente remoto 4D, o objeto vai conter (por exemplo):


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.035875,
    "portID": 19814,
    "TLSEnabled": false,
    "uptime": 143,
    "useLegacyNetworkLayer": true,
    "networkInputThroughput": 268047058,
    "networkOutputThroughput": 12207686274 
}

Se o código for executado em 4D Server, o objeto contém (por exemplo):


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.016125,
    "portID": 19814,
    "TLSEnabled": false,
    "uptime": 192,
    "useLegacyNetworkLayer": true,
    "newConnectionsAllowed": true,
    "IPAddressesToListen": [
        "192.168.18.8",
        "192.168.18.7" 
    ],

      "IPAddressesAllowDeny": [
       { "mode": "allow", "ip": "192.168.*"},
       {"mode": "deny", "ip": "192.167.15.3"},
       {"mode": "allow", "ip": "192.167.1.2" }
    ],

    "networkInputThroughput": 149014925,
    "networkOutputThroughput": 80238805 
}

Ver também

Execute on server
Get database parameter
Get system info
REJECT NEW REMOTE CONNECTIONS