PROCESS PROPERTIES

Home

4D v16.3

PROCESS PROPERTIES


PROCESS PROPERTIES ( Prozessnr ; Prozessname ; Prozesstatus ; Prozesszeit {; ProzModus {; EinmaligeID {; Ursprung}}} )

Parameter	Typ	Beschreibung
Prozessnr	Lange Ganzzahl	Prozessnummer
Prozessname	String	Prozessname
Prozesstatus	Lange Ganzzahl	Prozesstatus
Prozesszeit	Lange Ganzzahl	Vom Prozess angehäufte Zeit in Ticks
ProzModus	Boolean, Lange Ganzzahl	Wenn Boolean: Sichtbar (TRUE) oder ausgeblendet (FALSE) Wenn Lange Ganzzahl (bit Feld): bit 0 = Sichtbarkeit, bit 1 = Preemptive Ausführung
EinmaligeID	Lange Ganzzahl	Einmalige Prozessnummer
Ursprung	Lange Ganzzahl	Ursprung des Prozesses

Beschreibung

Der Befehl PROCESS PROPERTIES gibt verschiedene Informationen zum Prozess mit der in Prozessnr übergebenen Nummer zurück.

Nach dem Aufruf:

gibt Prozessname den Namen des Prozesses zurück. Automatisch erzeugte Prozesse erhalten folgenden Namen:
- “P_” gefolgt von einer Zahl, wenn der Prozess über das Dialogfenster Methode ausführen erzeugt wurde und die Option Neuer Prozess markiert ist.
- “M_” oder “ML_” gefolgt von einer Zahl, wenn der Prozess in der Anwendungsumgebung erzeugt wird und die Eigenschaft Starte Neuen Prozess markiert ist.
- “Web Process#” gefolgt von einer UUID, wenn der Prozess vom Web Server gestartet wurde.
- Wurde der Prozess abgebrochen (und sein “Platz” noch nicht neu vergeben), wird der Prozessname weiter zurückgegeben. Um festzustellen, ob ein Prozess abgebrochen wurde, prüfen Sie, ob Prozesstatus=-1 ist (siehe unten).

Prozesstatus gibt den Zustand des Prozesses beim Aufruf zurück. Der Parameter kann den Wert einer vordefinierten Konstante unter dem Thema Prozesstatus zurückgeben:

Konstante Typ Wert

Aborted Lange Ganzzahl -1
Delayed Lange Ganzzahl 1
Does not exist Lange Ganzzahl -100
Executing Lange Ganzzahl 0
Hidden modal dialog Lange Ganzzahl 6
Paused Lange Ganzzahl 5
Waiting for input output Lange Ganzzahl 3
Waiting for internal flag Lange Ganzzahl 4
Waiting for user event Lange Ganzzahl 2

Prozesszeit gibt die ausgeführte Zeit seit dem Start des Prozesses in Ticks zurück. 1 Tick = 1/60 Sekunde.
ProzModus ist optional und kann eine Variable vom Typ Boolean oder Lange Ganzzahl sein:
- Beim Typ Boolean gibt er True zurück, wenn der Prozess sichtbar ist, False wenn er ausgeblendet ist.
- Beim Typ Lange Ganzzahl enthält er nach Ausführen der Methode ein Bit Feld, wo die beiden ersten Bits gesetzt sind:
  - Bit 0 gibt die Eigenschaft Sichtbarkeit zurück: Es wird auf 1 gesetzt, wenn der Prozess sichtbar ist, und auf 0, wenn er ausgeblendet ist.
  - Bit 1 gibt die Eigenschaft preemptive Modus zurück: Es wird auf 1 gesetzt, wenn der Prozess im preemptive Modus läuft, und auf 0, wenn er im kooperativen Modus läuft.
    Hinweis: Diese Eigenschaft ist nur in 4D Anwendungen in 64-bit hilfreich, wo Prozesse preemptive oder kooperativ laufen können. Weitere Informationen dazu finden Sie im Abschnitt Preemptive 4D Prozesse.
EinmaligeID ist optional. Geben Sie den Parameter an, wird die einmalige Prozessnummer zurückgegeben. Jedem Prozess wird eine Prozessnummer sowie pro Arbeitssitzung eine einmalige Prozessnummer zugewiesen. Mit dieser Nummer können Sie zwischen zwei Prozessen bzw. zwei Prozessitzungen unterscheiden. Sie entspricht der Prozessnummer, die während der Arbeitssitzung von 4D gestartet wurde.

Ursprung ist optional. Geben Sie den Parameter an, wird ein Wert zurückgegeben, der den Ursprung des Prozesses beschreibt. 4D bietet unter dem Thema Prozesstypen folgende vordefinierten Konstanten:

Konstante	Typ	Wert	Kommentar
Apple event manager	Lange Ganzzahl	-7
Backup process	Lange Ganzzahl	-19
Cache manager	Lange Ganzzahl	-4
Client manager process	Lange Ganzzahl	-31
Created from execution dialog	Lange Ganzzahl	3
Created from menu command	Lange Ganzzahl	2
Design process	Lange Ganzzahl	-2
Event manager	Lange Ganzzahl	-8
Execute on client process	Lange Ganzzahl	-14
Execute on server process	Lange Ganzzahl	1
External task	Lange Ganzzahl	-9
Indexing process	Lange Ganzzahl	-5
Internal 4D server process	Lange Ganzzahl	-18
Internal timer process	Lange Ganzzahl	-25
Log file process	Lange Ganzzahl	-20
Main process	Lange Ganzzahl	-1
Method editor macro process	Lange Ganzzahl	-17
Monitor process	Lange Ganzzahl	-26
MSC process	Lange Ganzzahl	-22
None	Lange Ganzzahl	0
On exit process	Lange Ganzzahl	-16
Other 4D process	Lange Ganzzahl	-10
Other user process	Lange Ganzzahl	4
Restore Process	Lange Ganzzahl	-21
Serial Port Manager	Lange Ganzzahl	-6
Server interface process	Lange Ganzzahl	-15
SQL Method execution process	Lange Ganzzahl	-24
Web process on 4D remote	Lange Ganzzahl	-12
Web process with no context	Lange Ganzzahl	-3
Web server process	Lange Ganzzahl	-13
Worker process	Lange Ganzzahl	5	Worker Prozess, vom Benutzer gestartet

Hinweis: 4D’s interne Prozesse geben einen negativen Wert, die vom Benutzer erzeugten Prozesse einen positiven Wert zurück.

Ist der Prozess nicht vorhanden, bedeutet das, dass Sie im Parameter Prozessnr einen Wert übergeben haben, der nicht im Bereich zwischen 1 und der Anzahl vorhandener Prozesse (Count tasks) liegt. PROCESS PROPERTIES lässt die Parameter der Variablen dann unverändert.

Beispiel 1

Folgendes Beispiel gibt Name, Status und beanspruchte Zeit in den Variablen vName, vState, und vTimeSpent für den aktuellen Prozess zurück:

 C_TEXT(vName) ` Initialisiere die Variablen

 C_LONGINT(vState)

 C_LONGINT(vTime)

 PROCESS PROPERTIES(Current process;vName;vState;vTimeSpent)

Beispiel 2

Siehe Beispiel zur Datenbankmethode On Exit

Beispiel 3

Die Sichtbarkeit und den Ausführungsmodus für den aktuellen Prozess abfragen:

 C_TEXT(vName)

 C_LONGINT(vState)

 C_LONGINT(vTime)

 C_LONGINT(vFlags)

 C_BOOLEAN(isVisible)

 C_BOOLEAN(isPreemptive)

 PROCESS PROPERTIES(Current process;vName;vState;vTime;vFlags)

 isVisible:=vFlags?? 0 //wahr, wenn sichtbar

 isPreemptive:=vFlags?? 1 //wahr, wenn preemptive

Siehe auch

Count tasks
Preemptive 4D Prozesse
Process state