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

FORECAST_OBJECT

Script-Funktion: Erzeugt eine Prognose für das angegebene Objekt.

Syntax

FORECAST_OBJECT(Object Name, Title, Date, Start Time, [Registrations], [Group_ERT])

Syntax	Beschreibung/Format
Objektname	Name des Objektes Format: Script-Literal oder Script-Variable
Titel	Name der Prognose Format: Script-Literal oder Script-Variable
Datumsformat	Formatvorgabe für das Datum Standardwert: "YYMMDD" oder "YYYYMMDD"
: oder ;	Trennzeichen zwischen dem Datumsformat und Datum.
Datum	Logisches Startdatum im Format "JJMMTT" oder "JJJJMMTT" Format: Script-Literaloder Script-Variable Es ist möglich, das Datum in einem anderen Datumsformat anzugeben. Geben Sie dazu zuerst das gewünschte Datumsformat, ein Trennzeichen (: oder ;) und danach das Datum an. Die Angabe des Datumsformats ist optional.
Startzeit	Startzeitpunkt der Aufgabe im Format "HHMMSS". Format: Script-Literaloder Script-Variable Es ist möglich, die Zeit in einem anderen Zeitformat anzugeben. Geben Sie dazu zuerst das gewünschte Zeitformat, ein Trennzeichen (;) und danach die Zeit an. Die Angabe des Zeitformats ist optional.
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

Rückgabewert
"0" - Die Prognose konnte erfolgreich angelegt werden.

Anmerkungen

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

Ähnlich der manuellen Eingabe sind ein Name für die Prognose (in Großbuchstaben, ohne Leerzeichen!) sowie Startdatum- und -zeit anzugeben. Nutzen Sie die Möglichkeit für letztere ein Format Ihrer Wahl zu definieren. 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.

Der Rückgabewert dieser Funktion ist eine 16-stellige Zahl mit führenden Nullen. Nach erfolgreicher Prognoseerstellung wird der Wert "0000000000000000" zurückgeliefert.

Verwenden Sie Für die Erstellung einer Prognose von laufenden Aufgaben das Script-Sprachmittel FORECAST_TASK.

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

Beispiele

Die folgende Zeile erzeugt einen Forecast für einen FileTransfer unter der zusätzlichen Verwendung von Datums- und Zeitformaten.

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

Im zweiten Beispiel wird die Prognose für einen Job erstellt, der innerhalb einer Gruppe läuft. Dabei soll nicht die ERT von dieser Gruppe verwendet werden, sondern ein Fixwert 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:

Script-Sprachmittel	Beschreibung
AUTOFORECAST	Berechnet Prognosedaten für zukünftige Aktivitäten.
FORECAST_TASK	Erzeugt eine Prognose für die angegebene Aufgabe.

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