DELETE_FORECAST

Verwenden Sie die Script-Funktion DELETE_FORECAST, um eine oder mehrere in der Automation Engine-Datenbank gespeicherte Prognosen zu löschen. Diese Script-Funktion löscht jede Art von Prognose:

• Autoprognose
• Objektprognosen
• Aufgabeprognosen

Syntax

DELETE_FORECAST (FC_TITLE [,DAYS] ,[FORCED])

Parameter

• DELETE_FORECAST
  Löscht eine oder mehrere Prognosen

• FC_TITLE
  Titel der zu löschenden Prognose
  Hinweis: Sie können * als Wildcardzeichen verwenden.
  Format: String
  Wichtig: DELETE_FORECAST verwendet den Titel der Prognosen und nicht den Objektnamen, um die zu löschenden Prognosen auszuwählen.

• DAYS
  (Optional) Alter (Startzeit) der Prognose
  Format: Zahl ohne Anführungszeichen, Script-Literal oder Script-Variable
  Standard: Keine Auswahl nach logischer Startzeit (Alter) der Prognose.
  Hinweis: Um das logische Startdatum der Prognose auf heute (todays_date) (23:59:59) zu setzen, geben Sie 0 als den Parameter DAYS ein.
  Tipp: Berücksichtigen Sie bei der Einstellung des DAYS-Parameters die Zeitzonenregeln. Weitere Informationen finden Sie unter Logisches Datum und reales Datum.

• FORCED
  (Optional) Löscht alle Prognosen ohne Überprüfung
  Hinweise:

  • Laufende Prognoseberechnungen werden mit undefinierten Fehlern gestoppt, wenn Sie diesen Parameter verwenden.
  • Ohne diesen Parameter prüft das System, ob die Prognose aktiv ist, und löscht nur gerade inaktive Prognosen.

Hinweis: The FC_TITLE  und DAYS werden logisch durch einen AND-Operator verknüpft. Die Script-Funktion löscht Prognosen mit dem angegebenen Titel, die am angegebenen Tag beginnen.

Rückgabewerte

• 0
  Die Prognosen wurden erfolgreich gelöscht
• Eine Zahl, die größer ist als 0
  Anzahl der Prognosen, die nicht gelöscht werden konnten.

Die Anzahl der gelöschten Prognosen wird in der Nachrichtennummer 20824 im Report des ausführbaren Objekts angezeigt, dass das Script aufruft.

Beispiele

Die folgenden Beispiele zeigen, wie Sie mit DELETE_FORECAST unterschiedliche Ergebnisse erzielen:

• : SET &ret# = DELETE_FORECAST ("*", ,)
  Löscht alle Prognosen, die derzeit nicht ausgeführt werden

• : SET &ret# = DELETE_FORECAST ("*")
  Löscht alle Prognosen mit Status ENDED_OK

• : SET &ret# = DELETE_FORECAST ("MyFC", , FORCED)
  Löscht alle Prognosen mit dem Titel MyFC und stoppt alle diese Prognosen, wenn sie derzeit ausgeführt werden

• : SET &ret# = DELETE_FORECAST ("FC_*", "2")
  Löscht alle Prognosen, deren Titel mit FC_ beginnt, die älter als zwei Tage sind und den Status ENDED_OK haben.

• : SET &ret# = DELETE_FORECAST ("FC_*", "2","FORCED") Löscht alle Prognosen, deren Titel mit FC_ beginnt, und die älter als zwei Tage sind

• : SET &ret# = DELETE_FORECAST ("FC_*",0, "FORCED"
  Löscht alle Prognosen, deren Titel mit FC_ beginnt, und deren logisches Startdatum heute (23:59:59) ist

• : SET &ret# = DELETE_FORECAST ("FC_*",0)
  Löscht alle Prognosen, deren Titel mit FC_ beginnt, deren logisches Startdatum heute ist, und die den Status ENDED_OK haben

Siehe auch: