<<

Inhaltsverzeichnis

Suchen

>>

 

SET_SYNCHRONIZED

 

 

Funktion

 

 

Syntax:

SET_SYNCHRONIZED(<Variablennummer>,<Alter Wert>,<Neuer Wert>)

 

<Variablennummer>

= <NUM-AUSDRUCK>

<Alter Wert>

= <NUM-AUSDRUCK>

<Neuer Wert>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

Synchronisation von Threads.

 

Unter Java laufen Makros, die über einen Timer gestartet werden, als eigener Thread parallel zur gerade laufenden Verarbeitung ab. Dateizugriffe und Zugriffe auf gemeinsam benutzte Variablen müssen deshalb synchronisiert werden.

 

Mit den Funktionen SET_SYNCHRONIZED und ADD_SYNCHRONIZED werden 10 Integer-Variablen (<Variablennummer> = 0,...,9) zur Verfügung gestellt, über die die Synchronisation erfolgen kann. Beim Programmstart werden alle Variablen auf 0 gesetzt.

 

Die Funktion SET_SYNCHRONIZED prüft, ob die Variable <Variablennummer> den Wert <Alter Wert> hat. Falls ja, wird der Wert der Variablen auf <Neuer Wert> geändert und die Funktion liefert als Ergebnis 1. Hat die Variable <Variablennummer> nicht den Wert <Alter Wert>, so wird der Wert der Variablen nicht verändert und SET_SYNCHRONIZED liefert als Ergebnis -1.

 

Ist <Variablennummer> < 0 oder > 9, so liefert SET_SYNCHRONIZED als Ergebnis -2. 

 

<Variablennummer>, <Alter Wert> und <Neuer Wert> müssen ganzzahlige Werte enthalten.

 

SET_SYNCHRONIZED ist 'thread safe'. Dies bedeutet, dass sichergestellt ist, dass immer nur ein Thread auf die Variablen zugreifen kann und deshalb der Wert der Variablen immer wohl definiert ist.

 

Parameter:

Variablennummer

Nummer der Variablen (0,...,9)

Alter Wert

Alter Wert der Variablen

Neuer Wert

Neuer Wert der Variablen

 

Beispiel:

ON TIMER MACRO LESEN.TERMIN

...

Makro LESEN.TERMIN:

/* Prüfen, ob Variable 2 von 0 auf 1 gesetzt werden kann

IF SET_SYNCHRONIZED(2,0,1) = -1

THEN /* Ein anderer Thread hat die Variable auf 1 gesetzt und ist mit

     /* der Verarbeitung noch nicht fertig

     /* ... Fehlermeldung ausgeben oder warten und Zugriff erneut versuchen

ELSE ... Termin aus Datei TERMINE lesen ...

     /* Variable wieder auf 0 zurücksetzen

     IF SET_SYNCHRONIZED(2,1,0) = -1

     THEN /* Zurücksetzen ist nicht möglich. Es muss sich dann um

          /* einen Programmierfehler handeln, da ein anderer Thread

          /* die Variable inzwischen auf einen anderen Wert gesetzt hat.

     ENDIF

ENDIF

 

Siehe auch:

ADD_SYNCHRONIZED

SYNCHRONIZED

START_THREAD