Eine Semaphore ist ein Flag, das auf Arbeitsstationen oder in Prozessen auf einer Arbeitsstation bekannt ist. Eine Semaphore ist entweder vorhanden oder nicht vorhanden. Die Methoden, die ein Benutzer einsetzt, können testen, ob eine Semaphore vorhanden ist. Eine Semaphore lässt sich nur von der Arbeitsstation oder dem Prozess entfernen, welche(r) sie erstellt hat. Methoden können durch Erstellen und Testen von Semaphoren mit den Arbeitsstationen kommunizieren.
Sie verwenden Semaphoren nicht, um den Zugriff auf Datensätze zu verwalten. Das erledigen 4D und 4D Server automatisch. Sie setzen Semaphoren ein, damit nicht mehrere Benutzer gleichzeitig dieselbe Operation ausführen können.

Die Funktion Semaphore gibt TRUE zurück und führt nichts aus, wenn Semaphorenname vorhanden ist. Ist Semaphorenname nicht vorhanden, legt Semaphore die Semaphore an und gibt FALSE zurück. Eine Semaphore kann immer nur ein Benutzer gleichzeitig erstellen. Wird FALSE zurückgegeben, heißt das einerseits, dass die Semaphore nicht vorhanden war, andererseits aber auch, dass die Semaphore bereits für den Prozess gesetzt wurde, der sie aufgerufen hat.
Semaphore gibt FALSE zurück, wenn keine Semaphore gesetzt wurde bzw. wenn die Semaphore bereits im selben Prozess existiert, in dem der Aufruf erfolgt.
Der Name für eine Semaphore ist auf 255 Zeichen begrenzt, inkl. dem vorangestellten Zeichen $. Längere Namen werden abgeschnitten. Beachten Sie, dass Groß- und Kleinbuchschreibung berücksichtigt wird. Das Programm unterscheidet also zwischen MeineSemaphore und meinesemaphore.

Mit dem optionalen Parameter ZähleTick geben Sie eine Wartezeit in Ticks an, wenn Semaphorenname bereits gesetzt wurde. In diesem Fall wartet die Funktion entweder, bis die Semaphore freigegeben oder die Wartezeit abgelaufen ist und gibt erst dann True zurück.

Es gibt zwei Arten von Semaphoren:

• Lokale Semaphoren werden nur von den Prozessen auf derselben Arbeitsstation und nur von dieser erkannt. Sie werden mit einem vorangestellten Dollarzeichen gekennzeichnet, z.B. $MeineSemaphore. Mit lokalen Semaphoren steuern Sie Operationen zwischen Prozessen, die auf einer Arbeitsstation ausgeführt werden. Eine lokale Semaphore kann z.B. den Zugriff auf ein Interprozess-Array steuern, das sich alle Prozesse einer Arbeitsstation oder im 4D Einzelplatzbetrieb teilen.
• Globale Semaphoren sind für alle Benutzer und für alle Prozesse zugänglich. Mit globalen Semaphoren verwalten Sie Operationen zwischen Benutzern einer Datenbank im Mehrplatzbetrieb.

Globale und lokale Semaphoren funktionieren nach derselben Logik. Der Unterschied liegt in ihrer Reichweite. Im Client/Server Modus werden globale Semaphoren von allen Prozessen auf allen Clients und Servern gemeinsam genutzt. Eine lokale Semaphore wird nur von Prozessen auf dem Rechner genutzt, wo sie erzeugt wurde.
In 4D haben globale und lokale Semaphoren dieselbe Reichweite, da es nur einen Benutzer gibt. Wird die Datenbank jedoch in beiden Setups verwendet, stellen Sie sicher, dass - je nachdem, was ausgeführt werden soll - globale oder lokale Semaphoren verwendet werden.

Hinweis: Wir empfehlen, zum Verwalten lokaler Aspekte für den Client einer Anwendung, wie z.B. die Oberfläche oder ein Array mit Interprozessvariablen, lokale Semaphoren zu verwenden. Verwenden Sie dafür globale Semaphoren, verursacht das nicht nur unnötigen Austausch über das Netzwerk, sondern kann auch andere Client-Rechner beeinträchtigen. Über eine lokale Semaphore können Sie solche unerwünschten Nebenwirkungen vermeiden.

Hier eine typische Anweisung zum Verwenden einer Semaphore:

In diesem Beispiel wollen Sie verhindern, dass zwei Benutzer gleichzeitig die Preise in einer Produktetabelle global aktualisieren können. Schreiben Sie dazu folgende Methode:

Folgendes Beispiel verwendet eine lokale Semaphore. Sie wollen in einer Datenbank mit mehreren Prozessen eine To-do Liste aufrechterhalten. Sie soll in einem Interprozess-Array und nicht in einer Tabelle verwaltet werden. Über eine Semaphore verhindern Sie den gleichzeitigen Zugriff. Für diesen Fall benötigen Sie nur eine lokale Semaphore, da nur ein Arbeitsplatz mit der To-Do Liste arbeitet.

Das Interprozess-Array wird in der Startup Methode initialisiert:

Mit dieser Methode fügen Sie Einträge in die To-do Liste ein:

Obige Methode können Sie von jedem Prozess aus aufrufen.

Diese Methode ermöglicht, eine Methode bei vorhandener Semaphore nicht auszuführen; die Methode informiert die aufrufende Methode mit Fehlernummer und Text.

Syntax: