RESTART_UC_OBJECT

Verwenden Sie die Script-Funktion RESTART_UC_OBJECT, um die Ausführung einer Aufgabe zu wiederholen. Diese Funktion startet eine bereits ausgeführte Aufgabe neu. Sie können optional Wiederanlaufpunkte angeben und Flags setzen, um Anweisungen für die Ausführung der Aufgabe zu geben.

Hinweis: Dieses Script-Statement bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.

Wichtig: Wenn Sie diese Script-Funktion auf der Seite Post-Skript verwenden, kann sich eine Aufgabe wiederholen und eine Endlosschleife verursachen.

Syntax

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

Parameter

• RESTART_UC_OBJECT
  Wiederholt die Ausführung einer Aufgabe

• Object Name
  Name der zu wiederholenden Aufgabe

• Reference RUN#
  RunID der zu wiederholenden Ausführung
  Format: Script-Literal, Zahl, Script-Variable oder Script-Funktion
  Verwenden Sie das Schlüsselwort LAST, wenn Sie die letzte Ausführung des Objekts wiederholen möchten.
  Hinweis: Sie können eine bereits neu gestartete Aufgabe nicht neu starten, daher muss sich die RunID auf eine Originalausführung und nicht auf einen Neustart beziehen.

• Restart Point
  (Optional) Punkt im Script, an dem die Ausführung neu gestartet werden soll
  Format: AE-Name, Script-Literal, Zahl oder Script-Variable
  Hinweis: Sie können diesen Parameter nur angeben, wenn Sie im Script Wiederanlaufpunkte definiert haben. Weitere Informationen finden Sie unter :RESTART. Wenn Sie keinen Wiederanlaufpunkt angeben, wird das gesamte Script verwendet.

• Flags
  (Optional) Kommagetrennte Anweisungen für die Ausführung
  Die Flags entsprechen den Testoptionen, wenn Sie eine Aufgabe manuell neu starten. Weitere Informationen finden Sie unter Aufgaben neu starten.
  Format: Script-Literal oder Script-Variable
  Hinweise:

  • Sie können mehrere Flags einfügen.
  • Wenn Sie die Flags benennen und keine Script-Variablen verwenden, schreiben Sie den gesamten Begriff in Anführungszeichen.
  Erlaubte Werte:
  • GEN_JCL
    Zeigt die generierte JCL im Aktivierungsreport an
  • ORIGINAL_SCRIPT
    Zeigt das Original-Script im Aktivierungsreport an
  • VAR_MOD
    Zeigt Änderungen an Variablen im Aktivierungsreport an
  • ATT_MOD
    Zeigt Änderungen an Attributen im Aktivierungsreport an
  • ATT_DIALOG
    Aktiviert den Attribut-Dialog
  • MAN_RELEASE
    Wartet auf manuelle Freigabe aus der Perspektive Process Monitoring
  • KEEP_STARTTYPE
    Behält den ursprünglichen Starttyp bei
  • ONLY_ABENDED
    Startet nur Child-Aufgaben neu, die abgebrochen wurden

• Queue
  Gibt ein Queue-Objekt an, das beim Neustart der Aufgabe verwendet werden soll
  Wenn Sie kein Queue-Objekt angeben, wird die Aufgabe in der Queue ausgeführt, die im Objekt definiert ist.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• 0
  Erfolgreicher Neustart
• 7014
  Referenz-RunID existiert nicht
• 7015
  Eine bereits neu gestartete Ausführung kann nicht neu gestartet werden
• 20346
  Wiederanlaufpunkt existiert nicht
• 20380
  Die Script-Verarbeitung in der neu gestarteten Ausführung wurde durch ein :EXIT-Statement beendet
• 20385
  Objekt ist ein Schedule-Objekt
• 20628
  Objekt existiert nicht

Tipp: Verwenden Sie das Script-Statement :ON_ERROR, um Maßnahmen zu definieren, die im Fehlerfall ergriffen werden sollen. Weitere Informationen finden Sie hier: Fehlerbehandlung in Scripts.

Beispiel

Das folgende Beispiel wiederholt die letzte Ausführung eines Jobs (JOBS.SYSTEM.CHECK). Die Script-Funktion enthält Parameter zur Ausgabe der generierten JCL und geänderten Variablen im Aktivierungsreport. Der letzte Parameter weist den Job an, in der Perspektive Process Monitoring zu warten, bis Sie den Job manuell freigeben.

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

Siehe auch: