Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte aktivieren > FORECAST_TASK

FORECAST_TASK

Script-Funktion: Erzeugt eine Prognose für die angegebene aktive Aufgabe.

Syntax

FORECAST_TASK(RunID,Title, [Registrations], [Group_ERT], [Days])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes. Format: Script-Literal oder Script-Variable
Titel	Name der Prognose. Format: Script-Literal oder Script-Variable
Vormerkungen	Einstellung, ob die Vormerkungen (bei Gruppen) berücksichtigt werden sollen. Format: Script-Literal oder Script-Variable Erlaubte Werte: "Y", "N" (Standardwert)
Gruppen_ERT	Erwartete Laufzeit (ERT) bei Gruppen. Wird verwendet, wenn die Vormerkungen auf 'N' gesetzt werden. Erlaubte Werte: "0" - ERT der Gruppe wird verwendet. (Standardwert) "1" bis "7199" - Fixwert in Sekunden
Tage	Anzahl der Tage, die maximal in die Zukunft gerechnet werden soll. Format: Zahl ohne Hochkommata, Script-Literal oder Script-Variable Standardwert: "1"

Rückgabewerte
"0" - Die Prognose konnte erfolgreich angelegt werden. "20463" - Laufzeitfehler in Objekt '&01' Zeile '&02': Ungültige Syntax in Bedingung.

Anmerkungen

Für jede laufende Aufgabe ist es möglich, eine Prognose über die Laufzeit zu erstellen. Dies kann einerseits im UserInterface selbst gemacht werden, indem über das Kontextmenü des Aktivitätenfensters der gleichnamige Befehl aufgerufen wird. Unter der Angabe bestimmter Kriterien wird für die Aufgabe eine Prognose angelegt. Die zweite Möglichkeit ist die Benützung dieser Script-Funktion.

Genauso wie bei der manuellen Eingabe ist ein Name für die Prognose (in Großbuchstaben, ohne Leerzeichen!) anzugeben. Für Aufgaben, die unter anderem einer Gruppe zugehörig sind, können die Parameter Vormerkungen und Gruppen_ERT nach Bedarf eingestellt werden. Beachten Sie, dass der Titel für die Prognose noch nicht existieren darf!

Verwenden Sie Für die Erstellung einer Prognose von Objekten das Script-Sprachmittel FORECAST_OBJECT.

Das Script-Sprachmittel bewirkt, dass die offenen Transaktionen des Scripts in die Datenbank geschrieben werden.

FORECAST_TASK funktioniert nur mit aktiven Aufgaben.

Beispiele

Die folgende Zeile erzeugt eine Prognose für einen FileTransfer.

:SET &RUNNR# = GET_UC_OBJECT_NR ("C70.WINDOWS")
:SET &RET# = FORECAST_TASK(&RUNNR#,"PROGNOSE_FT_C70.WINDOWS")

Im zweiten Beispiel wird die Prognose für einen Job erstellt, der innerhalb einer Gruppe läuft. Dabei soll nicht die ERT von dieser verwendet werden, sondern ein Fixwert von 60 Sekunden.

:SET &RUNNR# = GET_UC_OBJECT_NR ("T91.SALDO.03")
:SET &RET# = FORECAST_TASK(&RUNNR#,"PROGNOSE_T91.SALDO.03","N",60)

Siehe auch:

Script-Sprachmittel	Beschreibung
AUTOFORECAST	Berechnet Prognosedaten für zukünftige Aktivitäten.
FORECAST_OBJECT	Erzeugt eine Prognose für das angegebene Objekt.

Script-Sprachmittel - Objekte aktivieren

Prognose
Laufzeitermittlung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support