Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte aktivieren > ROLLBACK_UC_OBJECT

ROLLBACK_UC_OBJECT

Scriptfunktion: Rollback einer bestimmten Aufgabe durchführen.

Syntax

ROLLBACK_UC_OBJECT(RunID)
ROLLBACK_UC_OBJECT([Workflow RunID], RunID2)

Syntax	Beschreibung/Format
RunID	RunID jener Aufgabe, für die das Rollback gestartet werden soll. Format: Script-Variable, Zahl ohne Hochkommata oder Script-Literal
RunID2	RunID der Aufgabe, bis zu der das Rollback innerhalb des Workflows durchgeführt werden soll. Format: Script-Variable, Zahl ohne Hochkommata oder Script-Literal Wird dieser Parameter angegeben, so ist der erste Parameter optional. Um den Workflow bis zum START-Objekt zurückzurollen, ist für RunID2 das Schlüsselwort START (ohne Hochkommata) zu verwenden. In diesem Fall ist die Workflow-RunID unbedingt erforderlich!
Workflow-RunID	RunID des Workflows, in welchem das Rollback bis zur Aufgabe RunID2 durchgeführt werden soll. Format: Script-Variable, Zahl ohne Hochkommata oder Script-Literal

Syntax

Beschreibung/Format

RunID

RunID jener Aufgabe, für die das Rollback gestartet werden soll.
Format: Script-Variable, Zahl ohne Hochkommata oder Script-Literal

RunID2

RunID der Aufgabe, bis zu der das Rollback innerhalb des Workflows durchgeführt werden soll.
Format: Script-Variable, Zahl ohne Hochkommata oder Script-Literal

Wird dieser Parameter angegeben, so ist der erste Parameter optional.

Um den Workflow bis zum START-Objekt zurückzurollen, ist für RunID2 das Schlüsselwort START (ohne Hochkommata) zu verwenden. In diesem Fall ist die Workflow-RunID unbedingt erforderlich!

Workflow-RunID

RunID des Workflows, in welchem das Rollback bis zur Aufgabe RunID2 durchgeführt werden soll.
Format: Script-Variable, Zahl ohne Hochkommata oder Script-Literal

Rückgabewert
11121 - Aufgabe mit der angegebenen RunID konnte nicht gefunden werden. 12108 - Rollback für Aufgabe nicht möglich. Rollback ist im Objekt nicht aktiviert. 12107 - Rollback für Aufgabe auf Grund des Status nicht möglich. 20282 - Laufzeitfehler: Objekt nicht gefunden.

Kommentare

Das Sprachmittel führt die Rollback-Aktionen der angegebenen Aufgabe durch. Welche Aktionen dabei durchgeführt werden, hängt von der Rollback-Definition im Objekt ab (Registerkarte Rollback).

Das Rollback kann nur für bereits abgeschlossene Workflow-Aufgaben gestartet werden, für welche diese Funktionalität aktiviert wurde.

Handelt es sich bei der angegebenen Aufgabe um einen Workflow, so wird das Rollback auch für alle untergeordneten Aufgaben durchgeführt.

Sie haben außerdem die Möglichkeit, das Rollback nur bis zu einer bestimmten Aufgabe innerhalb eines Workflows durchzuführen. Verwenden Sie dazu die RunID dieser Workflow-Aufgabe für den zweiten Parameter RunID2. Beim ersten Parameter kann die RunID des Workflows angegeben werden, in welchem die Aufgabe läuft. Diese Angabe ist aber optional.
Um den Workflow bis zum START-Objekt zurückzurollen, ist für RunID2 das Schlüsselwort START zu verwenden. In diesem Fall ist die Workflow-RunID unbedingt anzugeben!

Genaue Informationen zur Durchführung von Backup und Rollback finden Sie im entsprechenden Dokument dazu.

Beispiele

Folgendes Beispiel aktiviert einen Job und überprüft dessen Rückgabewert. Endet die Aufgabe nicht normal, so wird deren Rollback gestartet.

:SET &ACT# = ACTIVATE_UC_OBJECT(JOBS.TEST,WAIT)
:SET &RET# = GET_UC_OBJECT_STATUS(, &ACT#, "RETCODE")

:IF &RET# > 0
: SET &RB# = ROLLBACK_UC_OBJECT(&ACT#)
:ENDIF

Siehe auch:

Script-Sprachmittel - Datensequenzen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support