<<

Inhaltsverzeichnis

Suchen

>>

 

ADD_SYNCHRONIZED

 

 

Funktion

 

 

Syntax:

ADD_SYNCHRONIZED(<Variablennummer>,<Liegt im Bereich von>,<Liegt im Bereich bis>,<Erhöhen um>)

 

<Variablennummer>

= <NUM-AUSDRUCK>

<Liegt im Bereich von>

= <NUM-AUSDRUCK>

<Liegt im Bereich bis>

= <NUM-AUSDRUCK>

<Erhöhen um>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

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 ADD_SYNCHRONIZED prüft, ob der Wert der Variablen <Variablennummer> im Bereich von <Liegt im Bereich von> bis <Liegt im Bereich bis> liegt (<Liegt im Bereich von> <= Wert der Variablen <= <Liegt im Bereich bis>). Falls ja, wird <Erhöhen um> zum Wert der Variablen dazuaddiert und die Funktion liefert als Ergebnis 1.

 

Liegt der Wert der Variablen <Variablennummer> nicht im Bereich von <Liegt im Bereich von> bis <Liegt im Bereich bis>, so wird der Wert der Variablen nicht verändert und ADD_SYNCHRONIZED liefert als Ergebnis -1.

 

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

 

<Variablennummer>, <Liegt im Bereich von>, <Liegt im Bereich bis> und <ADD> müssen ganzzahlige Werte enthalten.

 

ADD_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)

Liegt im Bereich von

Minimaler Wert

Liegt im Bereich bis

Maximaler Wert

Erhöhen um

Erhöhungswert (kann auch negativ sein)

 

Beispiel:

ON TIMER MACRO LESEN.TERMIN

...

Makro LESEN.TERMIN:

/* Prüfen, ob Variable 2 den Wert 0 oder 1 hat.

/* Falls ja, Wert um 5 erhöhen

IF ADD_SYNCHRONIZED(2,0,1,5) = -1

THEN /*... Zugriff nicht möglich

ELSE ... Termin aus Datei TERMINE lesen

         /* Variablenwert wieder um 5 verringern

        IF ADD_SYNCHRONIZED(2,5,6,-5) = -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:

SET_SYNCHRONIZED

SYNCHRONIZED

START_THREAD