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

RESTART_UC_OBJECT

Script-Funktion: Wiederholt die Durchführung einer Aufgabe.

Syntax

RESTART_UC_OBJECT (Object Name, Reference RunID, [Restart Point], [Flags], [Queue])

Syntax	Beschreibung/Format
Objektname	Name des Objektes. Format: Script-Literal, Script-Variable oder Script-Funktion
Referenz-RunID	RunID, auf die sich der Wiederanlauf bezieht, oder das Schlüsselwort LAST für die letzte Durchführung der Aufgabe. Format: Script-Literal, Zahl, Script-Variable oder Script-Funktion Die Wiederholung einer Aufgabe, die selbst ein Wiederanlauf war, ist nicht erlaubt. Die Nachvollziehbarkeit der Aktivitäten wäre dadurch nicht gewährleistet. Deshalb muss sich die RunID auf eine Original-Durchführung beziehen. Bei LAST wird die letzte Original-Durchführung verwendet.
Wiederanlauf-Punkt	Stelle im Script, ab der die Verarbeitung wiederholt werden soll. Format: AE-Name, Script-Literal, Zahl, Script-Variable Die Angabe dieses Parameters ist natürlich nur möglich, wenn Sie in der Aufgabe, die wiederholt werden soll, im Script Wiederanlaufpunkte mit :RESTART gesetzt haben. Verwenden Sie diesen Parameter nicht, so wird das gesamte Script durchgeführt.
Flags	Anweisungen für die Durchführung der Aufgabe. Format: Script-Literal oder Script-Variable Erlaubte Werte: "GEN_JCL" = Die generierte JCL im Aktivierungsreport ausgeben. "ORIGINAL_SCRIPT" = Das Original-Script im Aktivierungsreport ausgeben. "VAR_MOD" = Veränderung von Variablen im Aktivierungsreport ausgeben. "ATT_MOD" = Veränderung von Attributen im Aktivierungsreport ausgeben. "ATT_DIALOG" = Attributdialog aktivieren. "MAN_RELEASE" = Auf manuelle Freigabe warten. "KEEP_STARTTYPE" = Starttyp beibehalten. "ONLY_ABENDED" = Nur die untergeordneten Aufgaben, die abgebrochen sind, wiederholen. Es können mehrere Flags, durch Komma getrennt, angegeben werden. Wenn Sie diese namentlich angeben und keine Script-Variable verwenden, muss der gesamte Ausdruck in Hochkommata stehen. Die erlaubte Werte entsprechen den Optionen, die auch beim manuellen Wiederanlauf im Dialog"Ausführen..." vorhanden sind.
Queue	Angabe eines bestimmten Queue-Objektes, das für den Wiederanlauf der Aufgabe verwendet werden soll. Erfolgt keine Queue-Angabe, wird die Aufgabe automatisch in der Mandanten-Queue (CLIENT_QUEUE) neu gestartet.

Rückgabewert
"0" - Der Wiederanlauf der Aufgabe war erfolgreich. "20628" - Das Objekt existiert nicht. "7014" - Die Referenz-RunID existiert nicht. "20346" - Der Wiederanlauf-Punkt existiert nicht. "20380" - Script-Prozessierung der Wiederanlauf-Durchführung wurde durch das Sprachmittel :EXIT beendet. "20385" - Beim Objekt handelt es sich um einen Schedule. "7015" - Der Wiederanlauf einer Wiederanlaufdurchführung ist nicht erlaubt

Rückgabewert

"0" - Der Wiederanlauf der Aufgabe war erfolgreich.
"20628" - Das Objekt existiert nicht.
"7014" - Die Referenz-RunID existiert nicht.
"20346" - Der Wiederanlauf-Punkt existiert nicht.
"20380" - Script-Prozessierung der Wiederanlauf-Durchführung wurde durch das Sprachmittel :EXIT beendet.
"20385" - Beim Objekt handelt es sich um einen Schedule.
"7015" - Der Wiederanlauf einer Wiederanlaufdurchführung ist nicht erlaubt

Anmerkungen

Mit der Script-Funktion kann ein Wiederanlauf einer Aufgabe durchgeführt werden.

Beachten Sie, dass sich eine Aufgabe auch selbst wiederholen kann, wenn die Script-Funktion im Post-Script aufgerufen wird. Dabei kann es jedoch zu einer Endlosschleife kommen!

Wenn Sie eine der vier Testoptionen als Flags wählen ("GEN_JCL", "ORIGINAL_SCRIPT", "VAR_MOD" oder "ATT_MOD"), wird der Job mit :STOP beendet. Grund dafür ist der Standardwert "N" (=Nein), der als Antwort auf die Frage "Soll die Aufgabe gestartet werden?" angegeben wird.

Um einen Restart erfolgreich mit allen oder einer der vier Testoptionen als Flags auszuführen, nutzen Sie anstelle des Scripts das UserInterface, beschrieben im Kapitel "Ausführen mit Optionen".

Der Script-Funktion wird mit dem Parameter Referenz-RunID die RunID der Aufgabe übergeben, deren Durchführung wiederholt werden soll. Es kann auch das Schlüsselwort LAST verwendet werden, um die letzte Durchführung einer Aufgabe erneut zu starten.

Optional kann ein Wiederanlauf-Punkt benannt werden, der bei der erneuten Durchführung der Aufgabe berücksichtigt werden soll. Die Aufgabe wird gestartet, aber die Verarbeitung des Scriptes beginnt erst ab dieser Stelle. Die Flags sind ebenfalls optional und beeinflussen die Durchführung der Aufgabe.

Mit der Script-Anweisung :ON_ERROR legen Sie die Reaktion auf Fehler fest. Wie bisher können Sie sie mit den Script-Funktionen zur Fehlerbehandlung analysieren. Das Script wird weiter prozessiert. Es besteht aber auch die Möglichkeit, die Prozessierung des Scripts abzubrechen.

Das Script-Sprachmittel bewirkt, dass die offenen Transaktionen des Scripts in die Datenbank geschrieben werden.

Beispiele

Im Beispiel soll die letzte Durchführung eines Jobs wiederholt werden. Die generierte JCL und die Veränderung von Variablen werden im Aktivierungsprotokoll ausgegeben. Der Job wartet im Aktivitätenfenster auf eine manuelle Freigabe.

:SET &RET# = RESTART_UC_OBJECT ("JOBS.SYSTEM.CHECK",LAST,,"GEN_JCL,VAR_MOD,MAN_RELEASE")

Siehe auch:

Script-Sprachmittel	Beschreibung
:GENERATE	Steuert die Behandlung von Script-Zeilen bei der Prozessierung eines Scripts.
:ON_ERROR	Legt die Reaktion auf bestimmte Fehler bzw. Meldungen von Script-Sprachmitteln fest.
:RESTART	Setzt Wiederanlauf-Punkte in einem aktivierbaren Objekt.
SYS_ACT_RESTART	Ermittelt, ob eine Aufgabe im Wiederanlauf-Modus aktiviert wurde.
SYS_ACT_RESTART_ME_NR	Liefert die laufende Nummer (RunID) des im Wiederanlauf-Modus aktivierten Objektes.
SYS_LAST_RESTART_POINT	Liefert die Bezeichnung des vorangegangenen Wiederanlauf-Punktes im Script.
SYS_LAST_RESTART_TEXT	Liefert den Text des vorangegangenen Wiederanlauf-Punktes im Script.
SYS_RESTART_POINT	Liefert den Wiederanlauf-Punkt, mit dem das Objekt ausgeführt wird.

Script-Sprachmittel - Objekte aktivieren

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