Application info

Application info : Object

Paramètres	Type		Description
Résultat	Object	←	Informations sur l'activité de l'application active

Historique

Release	Modifications
21 R2	Support des propriétés "useFluentUI" et "canUseFluentUI"

Description

The Application info command returns an object providing detailed information about the active application's activity and network configuration.

The command can be executed on applications running in both standalone and client/server environments. The information returned depends on where Application info is executed. For example, if executed from a remote 4D, the information applies only to the remote workstation. If the command is called in a method that is executed on the server, the information returned applies to the the server.

L'objet retourné contient les propriétés suivantes :

Propriété	Type	Description	Exemple
canUseFluentUI	boolean	True if the running configuration (application and system) allows the application to use Fluent UI on Windows (useless on macOS). Possible values: true, false.	true
cpuUsage(*)	number	Percentage of processor used by 4D. Note, for Macs, the number displayed is for 1 core and represents an average for the processor.	10.03
headless	boolean	True si l'application fonctionne en mode headless. Possible values: true, false. For more information, see Command Line Interface.	false
IPAddressesAllowDeny	collection	4D Server only. Returns a collection of IP addresses that are allowed or denied in the database's settings. For more information, see IP configuration.	[{"mode": "allow", "ip": "192.168.*"},{...}]
[ ].mode	string	Property describing whether the IP address is allowed or not. Possible values: "allow" or "deny"	"allow"
[ ].ip	string	IP address	"192.167.1.2"
IPAddressesToListen	collection	4D Server only. Returns the IP addresses that 4D Server listens for. For more information, see IP configuration.	["192.168.18.12","192.168.18.10"]
launchedAsService	boolean	True if application launched as a service. Possible values: true, false. For more information, see Registering a Database as a Service.	false
networkInputThroughput(*)	number	The data rate (bytes/seconds) for network input of the machine running the application. In remote mode, the rate for the remote machine is returned. For more information, see Monitor Page.	37311495
networkOutputThroughput(*)	number	The data rate (bytes/seconds) for network output of the machine running the application. In remote mode, the rate for the remote machine is returned. For more information, see Monitor Page.	88058023
newConnectionsAllowed	boolean	4D Server only. True if new connections allowed. Possible values: true, false. For more information, see Accept/Reject New Connections Button.	true
pid	number	ID of the 4D application instance process (provided by the OS) -- allows identifying each running 4D instance, for example from an external script	16600
portID	number	4D Server: port for active listening, 4D remote: port for remote connections. Not returned in standalone environment. Minimum: 1. For more information, see Port Number.	19814
remoteDebuggerSessionID	text	Session ID of the remote application to which the server debugger is attached. This ID is also returned by Process activity.	"A838A40BJN3NJKH..."
SDIMode	boolean	True if the application is running in SDI mode on Windows (useless on macOS). Possible values: true, false. For more information, see SDI mode	true
TLSEnabled	boolean	True if TLS enabled for client/server communications. Not returned in standalone environment. Possible values: true, false. For more information, see Encrypt Client-Server Communications.
uptime	number	Temps écoulé (en secondes) depuis l'ouverture de la base de données 4D locale. For remote connections, returns the time elapsed since the connection was made.	143
useFluentUI	boolean	True if the application is running in Fluent UI on Windows (useless on macOS). Possible values: true, false.	true
useLegacyNetworkLayer	boolean	True si l'ancienne couche réseau est utilisée pour le serveur d'application. Not returned in standalone environment. Possible values: true, false. For more information, see Network layer.	false
useQUICNetworkLayer	boolean	True if QUIC network layer used for the application server and db4d server. Not returned in standalone environment. Possible values: true, false. Pour plus d'informations, voir cet article de blog.	false
volumeShadowCopyStatus	string	Returns the status of the Volume Shadow Copy Service. Windows only. For more information, see Using Volume Shadow Copy Service on Windows. Possible values: Constant Value Comment vss available available The service is available. vss error error The service experienced an error. vss not available notAvailable The service is unavailable. vss update required updateRequired The service needs to be updated.	"available"

(*) On Windows, you need to get this counter previously initialized, for example by a call to the Application info command in the On Startup database method.

Exemple

The following code returns an object containing information about the running application:

 var $appInfo : Object
 $appInfo:=Application info

If the code is executed from a standalone environment, the object contains (for example):

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

Si le code est exécuté à partir d'un client distant 4D, l'objet contient (par exemple) :

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

Si le code est exécuté sur 4D Server, l'objet contient (par exemple) :

{
  "launchedAsService": false,
  "volumeShadowCopyStatus": "notAvailable",
  "cpuUsage": 10.016125,
  "portID": 19814,
  "TLSEnabled": false,
  "uptime": 192,
  "headless": false,
  "pid": 9560,
  "useLegacyNetworkLayer": true,
  "useQUICNetworkLayer": false,
  "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
}

Voir également

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

Propriétés

Numéro de commande	1599
Thread safe	✓