New process

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.

Im Parameter Stapel können Sie die Größe des Stapelspeichers angeben. Im Stapelspeicher werden Methodenaufrufe, lokale Variablen, Parameter in Unterroutinen und gestapelte Datensatze angehäuft. 

• Übergeben Sie in Stapel den Wert 0 für eine standardmäßige Stapelgröße, die für die meisten Anwendungen passt (empfohlene Einstellung)
• In bestimmten Fällen wollen Sie lieber einen eigenen Wert verwenden. Sie müssen ihn in Bytes angeben. Sie sollten mindestens 64.000 Bytes zuweisen. Bei sehr langen, verschachtelten Methoden weisen Sie 512.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 empfehlen 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 4D Server bestimmt ist.

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 übergeben für die Prozessmethode einen oder mehrere Param Parameter. Sie können die Parameter genauso wie für eine Unterroutine übergeben (siehe Abschnitt Parameter in Methoden ). Sobald die Ausführung im Kontext des neuen Prozesses startet, erhält die Prozessmethode die Parameterwerte in $1, $2, etc.
Beachten Sie, dass Sie Arrays nicht als Parameter in einer Methode übergeben können. Auch beim Übergeben von Ausdrücken mit Zeigern müssen Sie auf zusätzliche Gegebenheiten achten:

• Zeiger auf Tabellen und Felder sind erlaubt,
• Zeiger auf Variablen, insbesondere lokale und Prozessvariablen werden nicht empfohlen, da diese Variablen im Moment, wo die Prozessmethode darauf zugreift, undefiniert sein können.
• Übergeben Sie einen Parameter vom Typ Objekt, erstellt 4D in diesem Fall eine Kopie des Objekts im Zielprozess.

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:

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:

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:

Die Objektmethode der Schaltfläche bAddCustomers lautet dann:

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.