:ATTACH_SYNC

Verwenden Sie die Script-Anweisung :ATTACH_SYNC, um ein Sync-Objekt an eine bereits aktivierte Aufgabe anzuhängen. Diese Script-Anweisung weist das Sync-Objekt temporär nur für die aktuelle Ausführung zu.

Wichtig! :ATTACH_SYNC betrifft keine Script-Objekte. Script-Objekte sind nach der Generierungsphase vollständig, und der Synchronisationsprozess findet zu einem späteren Zeitpunkt statt.

Sync-Objekt einer aktuellen Aufgabe zuweisen

Löschen Sie die RunID in den Parametern oder geben Sie die RunID der aktuellen Aufgabe an, um das Sync-Objekt der aktuellen Aufgabe zuzuweisen.

Mehr Informationen:

• Generierung zum Aktivierungszeitpunkt oder zur Laufzeit
• Sync (SYNC)
• Seite "Sync"

Sync-Objekt einer anderen Aufgabe zuweisen

Geben Sie die RunID als Parameter von :ATTACH_SYNC an, um das Sync-Objekt einer anderen Aufgabe zuzuweisen als der Aufgabe, die das Script enthält.

Wichtig! Ordnen Sie ein Sync-Objekt nur dann einer anderen, bereits aktivierten Aufgabe zu, wenn die Aufgabe einen der folgenden Status hat:

• Die Aufgabe ist noch nicht gestartet (Systemrückgabewert < 1540)
• Die Aufgabe befindet sich in einem Wartezustand (Systemrückgabewert zwischen 1600 und 1700)

Jeder andere Taskstatus führt zu einem Laufzeitfehler und das Script wird abgebrochen.

Zuweisung eines Sync-Objekts an den direkten Nachfolger im Workflow

Weisen Sie mit dem NEXT_OBJECT-Parameter das Sync-Objekt dem Nachfolger der Aufgabe im Workflow zu, um die weitere Verarbeitung zu beeinflussen.

Hinweise:

• Wenn Sie mit :ATTACH_SYNC ein Sync-Objekt einem Nachfolger zuweisen, darf es nicht mehr als einen Nachfolger geben.
• Die Option Aufgabe generieren zur: Laufzeit muss in der Aufgabe aktiviert sein, die die Script-Anweisung enthält.
• Die Aufgabe muss bereits aktiviert sein und eine eigene RunID haben.

Syntax

: ATTACH_SYNC [Objekttyp,] [RunID], Sync-Objekt, [Startaktion], [Abbruchaktion], [Endaktion], Weitere, [NEXT_OBJECT]

Parameter

• :ATTACH_SYNC
  Fügt ein Sync-Objekt zu einer aktivierten Aufgabe hinzu

• Objekttyp
  (Optional) Kurze Bezeichnung für den Typ des ausführbaren Objekts, um das Sync-Objekt zu verknüpfen
  Hinweis: Das Objekt kann allein durch die RunID identifiziert werden.

• RunID
  (Optional) RunID der Aufgabe, an die das Sync-Objekt angefügt werden soll
  Format: Script-Literal, Script-Variable oder Zahl
  Hinweise:

  • Wenn Sie keine RunID angeben, wird das Sync-Objekt an das aktuelle Objekt angehängt.
  • Fügen Sie das Komma ein, auch wenn Sie die RunID weglassen.

• Sync-Objekt
  Name des Sync-Objekts, mit dem die Aufgabe synchronisiert werden soll
  : Script-Literal oder Script-Variable

• Startaktion
  (Optional) Aktion, die durchgeführt werden soll, wenn die Aufgabe startet
  Format: Script-Literal oder Script-Variable

• Abbruchaktion
  (Optional)Aktion, die durchgeführt werden soll, wenn die Aufgabe abnormal endet
  Format: Script-Literal oder Script-Variable

• Endaktion
  (Optional) Aktion, die durchgeführt werden soll, wenn die Aufgabe endet
  Format: Script-Literal oder Script-Variable

• Weitere
  Aufgabenverarbeitung, wenn die Startaktion nicht verarbeitet werden kann
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • A
    Abnormales Ende (Abbruch)
  • W
    Warten
  • S
    Überspringen

• NEXT_OBJECT
  (Optional) Weist das Sync-Objekt dem direkten Nachfolger in einem Workflow zu
  Format: Script-Literal oder Script-Variable

Hinweis: Die Aktionen Start, End und Abend werden im Sync-Objekt definiert. Weitere Informationen finden Sie unter Sync (SYNC).

Beispiele

Das folgende Script fügt ein Sync-Objekt (SYSTEM_0001_EXCLUSIVE_SYNC) zu einem Job namens ARCHIVE01 hinzu. Wenn die Start-Aktion nicht ausgeführt werden kann, endet der Job anormal.

:SET &RUNNR# = GET_UC_OBJECT_NR(ARCHIVE01)
:ATTACH_SYNC &RUNNR#,"SYSTEM_0001_EXCLUSIVE_SYNC","USE","RELEASE","RELEASE","A"

Im folgenden Beispiel wird das Sync-Objekt der direkt nachfolgenden Aufgabe im Workflow zugewiesen.

:ATTACH_SYNC ,"SYSTEM_0001_EXCLUSIVE.SYNC","USE","RELEASE","RELEASE","A","NEXT_OBJECT"

Siehe auch: