FORECAST_OBJECT

Verwenden Sie die Script-Funktion FORECAST_OBJECT, um eine Prognose für ein Objekt zu erstellen. Sie können eine Prognose der erwarteten Laufzeit für jedes ausführbare Objekt erstellen. Diese Script-Funktion erzeugt die gleiche Art der Objektprognose, die Sie manuell über das Kontextmenü im Automic Web Interface erstellen können.

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

Tipp: Verwenden Sie die Script-Funktion FORECAST_TASK, um Objektprognosen der laufenden Aufgaben zu erstellen.

Syntax

FORECAST_OBJECT (Objektname, Titel, [Datumsformat:]Datum, [Zeitformat;]Startzeit [,Registrierungen] [,Gruppen_ERT])

Parameter

• Objektname
  Name des Objekts
  Format: Script-Literal oder Script-Variable

• Titel
  Name der Prognose in Großbuchstaben ohne Leerzeichen
  Format: Script-Literal oder Script-Variable
  Wichtig! Verwenden Sie einen Namen, der noch nicht benutzt wird.

• Datumsformat
  (Optional) Datumsformat für das Startdatum der Prognose
  Format: YYMMDD oder YYYYMMDD
  Weitere Informationen über Datumsformate finden Sie unter Datums-, Zeit- und Periodenformate in Scripts.

• Datum
  Logisches Startdatum im Format YYMMDD oder YYYYMMDD
  Format: Script-Literal oder Script-Variable

• Zeitformat
  (Optional) Zeitformat für die Startzeit der Prognose
  Format: HHMMSS
  Weitere Informationen zu Zeitformaten finden Sie unter Datums-, Zeit- und Periodenformate in Scripts.

• Zeit
  Startzeit der Aufgabe im Format HHMMSS
  Format: Script-Literal oder Script-Variable

• Registrierungen
  (Optional) Berücksichtigt oder ignoriert Registrierungen für Aufgabengruppen
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • Y
    Berücksichtigt Registrierungen
  • N (Standard)
    Ignoriert Registrierungen

• Gruppen_ERT
  Erwartete Laufzeit (ERT) für Gruppen
  Hinweis: Dieser Parameter gilt nur, wenn Registrierungen auf N gesetzt ist.
  Zulässige Werte:

  • 0
    Verwendet das ERT der Gruppe (Standardwert)
  • 1 bis 7199
    Festwert in Sekunden

Hinweis: Wenn Sie ein Datums- oder Zeitformat angeben, fügen Sie ein Trennzeichen (: oder ;) zwischen Datumsformat und Datum sowie Zeitformat und Uhrzeit ein.

Rückgabewert

Die Funktion FORECAST_OBJECT gibt eine 16-stellige Zahl mit führenden Nullen zurück. Die Funktion liefert den Wert 0000000000000000 nach erfolgreicher Prognoseerstellung.

Beispiele

Das folgende Script erstellt eine Prognose für einen FileTransfer und gibt Datums- und Zeitformate an.

: SET &RET# = FORECAST_OBJECT ( "C70.WINDOWS" , "FORECAST_FT_C70.WINDOWS" , "MM/DD/YY:11/03/03" , "HH:MM;12:30" )

Das folgende Beispiel erstellt eine Prognose für einen Job, der in einer Gruppe ausgeführt wird. Anstatt den ERT dieser Gruppe zu verwenden, verwendet die Prognose einen Festwert von 60 Sekunden.

: SET &RET# = FORECAST_OBJECT ( "T91.REM.03" , "FORECAST_T91.REM.03" , "MM/DD/YY:11/07/03" , "200000" , "Y" ,60)

Siehe auch: