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 Neustartpunkte angeben und Flags setzen, um Anweisungen für die Ausführung der Aufgabe zu geben.

Hinweis: Diese Script-Anweisung 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-Prozess verwenden, kann sich eine Aufgabe wiederholen und eine Endlosschleife verursachen.

Syntax

RESTART_UC_OBJECT (Objektname, Referenz-RUN#, [Neustartpunkt], [Flags], [Queue])

Parameter

• RESTART_UC_OBJECT
  Wiederholt die Ausführung einer Aufgabe

• Objektname
  Name der zu wiederholenden Aufgabe

• Referenz-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.

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

• Flags
  (Optional) Durch Kommata getrennte 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.
  Zulässige 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 Process Monitoring-Perspektive
  • 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
  Neustartpunkt existiert nicht
• 20380
  Die Script-Verarbeitung in der neu gestarteten Ausführung wurde durch eine :EXIT-Anweisung beendet
• 20385
  Objekt ist ein Schedule-Objekt
• 20628
  Objekt existiert nicht

Tipp: Verwenden Sie die Script-Anweisung :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: