SET_SYNC

Verwenden Sie die Script-Funktion SET_SYNC , um eine Aktion auszuführen, die in einem Sync-Objekt definiert ist. Die Aufgabe, die das Script enthält, ruft das Sync-Objekt auf und führt die Aktion aus, wenn die im Sync-Objekt festgelegte Bedingung erfüllt ist. Weitere Informationen finden Sie unter Sync (SYNC).

Hinweis: Sie benötigen Schreibzugriff (W) für das angegebene Sync-Objekt, um SET_SYNC auszuführen. Weitere Informationen finden Sie unter Automation Engine-Berechtigungen gewähren.

Syntax

SET_SYNC (Sync, Aktion)

Parameter

• SET_SYNC
  Führt eine in einem Sync-Objekt definierte Aktion aus

• Sync
  Name des Sync-Objekts
  Format: AE-Name, Script-Literal oder Script-Variable

• Aktion
  Auszuführende Aktion
  Format: AE-Name, Script-Literal oder Script-Variable

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Y
  Die Sync-Aktion wurde ausgeführt
• N
  Die Sync-Aktion konnte nicht ausgeführt werden

Ob eine Aktion ausgeführt werden kann, hängt von der Bedingung ab, die im Sync-Objekt angegeben ist. Eine Aktion kann nur ausgeführt werden, wenn eine bestimmte Bedingung erfüllt ist.

Beispiel

Ein Sync-Objekt mit dem Namen DB.STATUS enthält eine Aktion, die als EXCLUSIVE bezeichnet ist. Eine Aufgabe enthält das folgende Script, das versucht, die Aktion EXCLUSIVE auszuführen. Je nachdem, ob die Bedingung für die Aktion erfüllt ist, wird die Aktion ausgeführt. Das Script gibt eine Meldung über den Erfolg oder das Fehlschlagen der Ausführung der Aktion im Aktivierungsreport der Aufgabe aus.

: SET  &RET# = SET_SYNC ( "DB.STATUS" , "EXCLUSIVE" )
: IF  &RET# = "Y"
:    PRINT  "Sync-Bedingung EXCLUSIVE wurde gesetzt!"
: ELSE
:    PRINT  "Sync-Bedingung EXCLUSIVE wurde nicht gesetzt!"
: ENDIF

Siehe auch: