4D v14.3

New process

Home

 
4D v14.3
New process

New process 


 

New process ( Verfahren ; Stapel {; Name {; Parameter {; Parameter2 ; ... ; ParameterN}}}{; *} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Verfahren  String in Zu startende Methode
Stapel  Lange Ganzzahl in Größe des Stapelspeichers in Byte
Name  String in Name des erzeugten Prozesses
Parameter  Ausdruck in Parameter für die Methode
Operator in Einmaliger Prozess
Funktionsergebnis  Lange Ganzzahl in Prozessnummer des neu erstellten bzw. bereits laufenden Prozesses

Die Funktion New process startet auf demselben Rechner einen neuen Prozess und gibt seine Prozessnummer zurück. Diese Nummer ist zu einem bestimmten Zeitpunkt eindeutig. Ist der Prozess gelöscht, wird die Prozessnummer neu vergeben.

Konnte der Prozess nicht erstellt werden, z.B weil der Speicher dafür nicht ausreicht, gibt New process den Wert Null (0) zurück und es wird ein Fehler generiert. Sie können diesen Fehler über eine Fehlerverwaltungsmethode ausfindig machen, die ON ERR CALL einsetzt.

Methodenname ist der Name der Methode, die im Prozess gestartet werden soll.
Nachdem 4D den Kontext für den neuen Prozess bestimmt hat, beginnt es mit der Ausführung dieser Methode. Sie wird zur Prozessmethode.

Stapel gibt die Größe des Stapelspeichers in Bytes an. Im Stapelspeicher werden Methodenaufrufe, lokale Variablen, Parameter in Unterroutinen und gestapelte Datensatze angehäuft. Sie sollten dem Speicher mindestens 64 000 Bytes zuweisen. Bei sehr langen, verschachtelten Methoden weisen Sie 200 000 Bytes oder mehr zu. Wenn Sie zuwenig Speicher zuweisen, tritt die Fehlermeldung “Der Stapelspeicher ist voll” auf. Der angegebene Wert muss ein Vielfaches von 2 sein.

Hinweis: Der Stapelspeicher ist NICHT der Gesamtspeicher des Prozesses. Prozesse teilen den Speicher auf zwischen Datensätzen, Interprozessvariablen usw.. Prozessvariablen werden in einem Extraspeicher gespeichert. Der Stapelspeicher enthält verschiedene 4D Informationen; die Menge an Informationen richtet sich nach der Anzahl der eingebundenen Methodenaufrufe, die der Prozess verwendet, der Anzahl der geöffneten und wieder geschlossenen Formulare, sowie Anzahl und Größe der lokalen Variablen, die in jedem eingebetteten Methodenaufruf verwendet werden.

Hinweis für 64-bit 4D Server: Der Stapelspeicher für einen Prozess, der auf einem 64-bit 4D Server ausgeführt wird, benötigt mehr Speicher als ein 32-bit 4D Server (in etwa doppelt soviel). In Einklang mit den oben angegebenen Schätzungen emfehlen wir im Normalfall mindestens 128.000 Bytes, und 400.000 Bytes zum Verwalten einer anpassbaren Aufrufkette. Denken Sie daran, diesen Parameter zu prüfen, wenn Ihr Code zum Ausführen auf einem 64-bit Server dienen soll.

Den Namen des neuen Prozesses übergeben Sie in Prozessname. Dieser Name erscheint in der Prozessliste des Runtime Explorers.Er wird von dem Befehl PROCESS PROPERTIES zurückgegeben, wenn er auf diesen neuen Prozess angewendet wird. Geben Sie diesen Parameter nicht an, ist Prozessname ein leerer String. Soll der Prozess nur lokal gelten, stellen Sie das Dollarzeichen voran ($).

Wichtig: Beachten Sie, dass lokale Prozesse keinen Zugriff auf Daten im Client/Server-Betrieb haben sollten.

Sie können für die Prozessmethode Parameter übergeben, und zwar genauso wie für eine Unterroutine. Lediglich Ausdrücke vom Typ Zeiger und Arrays können Sie nicht übergeben. Sobald die Ausführung im Kontext des neuen Prozesses startet, erhält die Prozessmethode die Parameterwerte in $1, $2, etc.

Hinweis: Übergeben Sie Parameter in der Prozessmethode, müssen Sie auch Prozessname übergeben. In diesem Fall können Sie ihn nicht weglassen.

Geben Sie diesen Parameter an, erhält 4D die Anweisung, zuerst zu prüfen, ob bereits ein Prozess Prozessname vorhanden ist. Ist dies der Fall, startet 4D keinen neuen Prozess und gibt die Prozessnummer des Prozesses Prozessname zurück.

Wir gehen aus von der Projektmethode:

  ` ADD CUSTOMERS
 SET MENU BAR(1)
 Repeat
    ADD RECORD([Customers];*)
 Until(OK=0)

Fügen Sie diese Projektmethode über den Menüleisteneditor der Designumgebung in einem eigenen Menüeintrag hinzu, für den die Eigenschaft Starte Neuen Prozess aktiviert ist, startet 4D automatisch einen neuen Prozess, der mit dieser Methode läuft. Der Aufruf SET MENU BAR(1) fügt dem neuen Prozess eine Menüleiste hinzu. Ist kein Fenster vorhanden (das sie mit der Funktion Open window öffnen können), öffnet der Aufruf von ADD RECORD automatisch ein Fenster.

Damit Sie den Prozess Add Customers über eine Schaltfläche in einem eigenen Kontrollfeld starten können, schreiben Sie:

  ` Objektmethode für Schaltfläche bAddCustomers
 $vlProcessID:=New process("Add Customers";32*1024;"Kunden hinzufügen")

Die Schaltfläche führt dasselbe aus wie der eigene Menüeintrag.

Wollen Sie beim Auswählen des Menüeintrags oder Anklicken der Schaltfläche den Prozess starten (wenn er nicht vorhanden ist) oder nach vorne bringen (wenn er schon läuft), können Sie die Methode START ADD CUSTOMERS einrichten:

  ` START ADD CUSTOMERS
 $vlProcessID:=New process("Add Customers";64*1024;"Kunden hinzufügen";*)
 If($vlProcessID#0)
    BRING TO FRONT($vlProcessID)
 End if

Die Objektmethode der Schaltfläche bAddCustomers lautet dann:

  ` Objektmethode für Schaltfläche bAddCustomers
 START ADD CUSTOMERS

Im Menüleisteneditor ersetzen Sie die Methode ADD CUSTOMERS durch die Methode START ADD CUSTOMERS und deaktivieren die Eigenschaft Starte Neuen Prozess für den Menüeintrag.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Prozesse
Nummer: 317

 
GESCHICHTE 

Geändert: 4D 2004.3

 
SIEHE AUCH 

Einführung in Prozesse
Execute on server
Methoden
Projektmethoden
Variablen

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : New process ( 4D v11 SQL Release 6)