:ATTACH_SYNC

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

Wichtig! :ATTACH_SYNC betrifft nicht 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 zu 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ückgabecode < 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.

Zuordnung eines Sync-Objekts zum direkten Nachfolger im Workflow

Ordnen 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 zuordnen, darf es nicht mehr als einen Nachfolger geben.
• Die Option Zur Laufzeit generieren muss in der Aufgabe aktiviert sein, die das Script-Statement enthält.
• Die Aufgabe muss bereits aktiviert sein und eine eigene RunID haben.

Syntax

:ATTACH_SYNC [Object type,] [RunID], Sync object, [Start action], [Abend action], [End action], Other, [NEXT_OBJECT]

Parameter

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

• Object type
  (Optional) Kurzbezeichnung des Typs des ausführbaren Objekts, an das das Sync-Objekt angehängt werden soll
  Hinweis: Das Objekt kann nur durch die RunID identifiziert werden.

• RunID
  (Optional) RunID der Aufgabe, an die das Sync-Objekt angehängt 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 object
  Name des Sync-Objekts, mit dem die Aufgabe synchronisiert werden soll
  Format: Script-Literal oder Script-Variable

• Start action
  (Optional) Aktion, die ausgeführt werden soll, wenn die Aufgabe beginnt
  Format: Script-Literal oder Script-Variable

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

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

• Other
  Behandlung der Aufgabe, wenn die Start-Aktion nicht verarbeitet werden kann
  Format: Script-Literal oder Script-Variable
  Erlaubte Werte:

  • A
    Abgebrochen (Abend)
  • W
    Warten
  • S
    Überspringen

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

Hinweis: Die Aktionen Start, Ende und Abgebrochen 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 zugeordnet.

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

Siehe auch: