TOGGLE_OBJECT_STATUS

Verwenden Sie TOGGLE_OBJECT_STATUS, um die automatische Verarbeitung einer aktivierten Aufgabe anzuhalten oder zu starten. Mit der Script-Funktion können Sie die folgenden Aufgabentypen stoppen oder starten:

• Agentengruppe (HOSTG)
• Ereignis (EVNT)
• Jobgruppe (JOBG)
• Remote Task Manager (JOBQ)
• Periode (PERIOD)
• Schedule (JSCH)
• Workflow (JOBP)

Hinweis: Für diese Script-Funktion benötigen Sie die Berechtigung Zur Laufzeit ändern. Weitere Informationen finden Sie unter Automation Engine-Berechtigungen gewähren.

Syntax

TOGGLE_OBJECT_STATUS (RunID, Status[, ALL])

Parameter

• TOGGLE_OBJECT_STATUS
  Stoppt oder startet die automatische Verarbeitung einer aktivierten Aufgabe

• RunID
  RunID der zu stoppenden oder zu startenden aktivierten Aufgabe
  Format:AE-Name, Script-Literal oder Script-Variable

• Status
  Zu setzender Verarbeitungsstatus
  Format:AE-Name, Script-Literal oder Script-Variable
  Zulässige Werte:

  • STOP
    Stoppt die automatische Verarbeitung der Aufgabe
  • GO
    Startet die automatische Verarbeitung einer Aufgabe

• ALL
  (Optional, für Workflows, Jobgruppen, Perioden und Ablaufpläne) Schließt alle Aufgaben ein, die innerhalb der Aufgabe ausgeführt werden, die Sie stoppen oder starten
  Format:AE-Name, Script-Literal oder Script-Variable

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• 0
  Status wurde erfolgreich geändert
• 20444
  Es wurde ein ungültiger Status eingegeben; Sie können nur STOP oder GO verwenden.
• 20445
  Es wurde kein Objekt mit der angegebenen RunID gefunden

Beispiele

Das folgende Script ruft die RunID eines Ereignisses ab und stoppt das Ereignis.

:SET &RUNNR# = GET_UC_OBJECT_NR(DUMP.CONTROL)
:SET &RET# = TOGGLE_OBJECT_STATUS(&RUNNR#, "STOP")

Das folgende Script ruft die RunID eines Workflows ab und startet den Workflow und alle untergeordneten Aufgaben im Workflow.

:SET &RUNNR# = GET_UC_OBJECT_NR(MM.DAY)
:SET &RET# = TOGGLE_OBJECT_STATUS(&RUNNR#, "GO", ALL)

Siehe auch: