Get process activity

Home

4D v20.6


Get process activity {( Optionen )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
Optionen	Lange Ganzzahl	Eine bestimmte Liste zurückgeben
Funktionsergebnis	Objekt	Momentaufnahme der laufenden Prozesse bzw. Benutzersitzungen (nur 4D Server)

Beschreibung

Die Funktion Get process activity gibt eine Momentaufnahme (snapshot) der verbundenen Benutzersitzungen bzw. dazugehörigen laufenden Prozessen zu einem bestimmten Moment zurück. Sie gibt alle Prozesse zurück, d.h. auch interne Prozesse, die durch den Befehl PROCESS PROPERTIES nicht erreichbar sind.

Bei Ausführung auf dem Server ohne den Parameter Optionen (Standardeinstellung) gibt Get process activity die Liste der Benutzersitzungen und der Prozesse zurück. Hierzu ein Beispiel:

{
"sessions": [
          {
             "type": "remote",
             "userName": "Designer",
             "machineName": "iMac27caroline",
             "systemUserName": "Caroline Briaud",
             "IPAddress": "192.168.18.18",
             "hostType": "mac",
             "creationDateTime": "2017-09-22T12:46:39Z",
             "state": "postponed",
             "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
           },...
       ],
"processes": [
          {
             "name": "Application process",
             "sessionID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5",
             "number": 4,
             "ID": 4,
             "visible": true,
             "systemID": "123145476132864",
             "type": -18,
             "state": 0,
             "cpuUsage": 0,
             "cpuTime": 0.006769,
             "preemptive": false,
             "session": {   
                      "type": "remote",
                      "userName": "Designer",
                      "machineName": "iMac27caroline",
                      "systemUserName": "Caroline Briaud",
                      "IPAddress": "192.168.18.18",
                      "hostType": "mac",
                      "creationDateTime": "2017-09-22T12:46:39Z",
                      "state": "postponed",
                      "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
                       }
           },...
    ]
}

Um eine der Listen festzulegen, übergeben Sie den Parameter Optionen und wählen eine der folgenden Konstanten unter dem Thema 4D Umgebung:

Konstante	Typ	Wert	Kommentar
Processes only	Lange Ganzzahl	1	Gibt nur die Prozessliste zurück
Sessions only	Lange Ganzzahl	2	Gibt nur die Liste Benutzersitzung zurück

Bei Ausführung von 4D im remote oder lokalen Modus gibt Get process activity nur die Prozessliste zurück. Der Parameter Optionen ist hier ohne Bedeutung.

Liste der Sitzungen

Die Eigenschaft "sessions" enthält eine Collection von Objekten mit allen laufenden Benutzersitzungen auf dem Server. Hierzu ein Beispiel:

Jedes Objekt Sitzung enthält folgende Eigenschaften:

Name der Eigenschaft	Typ	Beschreibung
type	Text (num)	Sitzungstyp. Mögliche Werte: "remote", "storedProcedure", "web", "rest"
userName	Text	Benutzername
machineName	Text	Name des angemeldeten Rechners
systemUserName	Text	Name der auf dem angemeldeten Rechner geöffneten Systemsitzung
IPAddress	Text	IP Adresse des angemeldeten Rechners
hostType	Text (num)	Hosttyp. Mögliche Werte: "windows", "mac", "browser"
creationDateTime	Datum ISO 8601	Datum und Zeit der Verbindung auf dem angemeldeten Rechner
state	Text (num)	Sitzungsstatus. Mögliche Werte: "active", "postponed", "sleeping"
ID	Text	Sitzung UUID
persistentID	Text	Persistente ID der Sitzung

Liste der Prozesse

Die Eigenschaft "process" enthält eine Collection von Objekten mit allen laufenden Prozessen auf dem Server.

Jedes Objekt Prozess enthält folgende Eigenschaften:

Name der Eigenschaft

Typ

Beschreibung

name

Text

Prozessname

sessionID

Text

Session UUID

number

Lange Ganzzahl

Prozessnummer

Lange Ganzzahl

Einmalige ID des Prozesses

visible

Boolean

Wahr wenn sichtbar, sonst falsch

systemID

Text

ID für den Benutzerprozess, 4D Prozess oder wartenden Prozess

type

Lange Ganzzahl

Typ des laufenden Prozesses. Sie können eine der folgenden Konstanten unter dem Thema Prozesstypen verwenden:

Konstante	Wert	Kommentar
HTTP Log flusher	-58
Logger process	-57
HTTP Listener	-56
HTTP Worker pool server	-55
SQL Listener	-54
SQL Net Session manager	-53
SQL Worker pool server	-52
DB4D Listener	-51
DB4D Mirror	-50
DB4D Cron	-49
DB4D Worker pool user	-48
DB4D Garbage collector	-47
DB4D Flush cache	-46
DB4D Index builder	-45
ServerNet Session manager	-44
ServerNet Listener	-43
Worker pool spare	-42
Worker pool in use	-41
Other internal process	-40
Main 4D process	-39
SOAP process	-33
Web server spare process	-32
Client manager process	-31
Compiler process	-29
Monitor process	-26
Internal timer process	-25
SQL Method execution process	-24
MSC process	-22
Restore Process	-21
Log file process	-20
Backup process	-19
Internal 4D server process	-18
Method editor macro process	-17
On exit process	-16
Server interface process	-15
Execute on client process	-14
Web server process	-13
Web process on 4D remote	-12
Other 4D process	-10
External task	-9
Event manager	-8
Apple event manager	-7
Serial Port Manager	-6
Indexing process	-5
Cache manager	-4
Web process with no context	-3
Design process	-2
Main process	-1
None	0
Execute on server process	1
Created from menu command	2
Created from execution dialog	3
Other user process	4
Worker process	5	Worker Prozess, vom Benutzer gestartet

state

Lange Ganzzahl

Aktueller Status (siehe Konstantenliste Prozesstatus)

cpuUsage

Zahl

Diesem Prozess (zwischen 0 und 1) gewidmete Zeit (in Prozent)

cpuTime

Zahl

Laufende Zeit (Sekunden)

preemptive

Boolean

Wahr wenn er preemptive läuft, sonst falsch

session

Objekt

Spezifische Sitzung, in welcher der Prozess läuft. Undefiniert, wenn der Parameter Processes only übergeben ist.

url

Text

URL mit Pfad und Parametern (falls vorhanden) von Web (-3) und SOAP (-33) Prozessen, die auf dem Web Server laufen. Wird nicht für andere Prozesstypen zurückgegeben.

Beispiel

Die Collection aller Benutzersitzungen erhalten:

  //Zur Ausführung auf dem Server

 

 C_OBJECT($o)

 C_LONGINT($i)

 

 $o:=Get process activity //Prozess- und Session-Informationen abrufen

 For($i;0;($o.processes.length)-1) //Iterieren Sie über die Collection "processes".

    $processName:=$o.processes[$i].name

    $userName:=String($o.processes[$i].session.userName) // Einfacher Zugriff auf userName

  //Verwendung von String, da das Session-Objekt undefiniert sein könnte

 End for

Siehe auch

PROCESS PROPERTIES
WEB Get server info