Startbares Objekt: Ausführen

Mit dem Modul können Objekte einmalig sowie wiederholend aktiviert werden. Durch unterschiedliche Modi kann sich das Modul direkt nach der Anktivierung beenden oder noch vorhandene PromptSets bestätigen oder auf die Beendigung des aktivierten Objektes warten und optional auch noch einen ausgewählten Report anzeigen.

Bezeichnung

Name

util.Activate

Aliase

Activate, RunnableExecute

Konfiguration

Gruppe: Optionen

Objektname (object)

Name des auszuführenden Objektes

Alias (alias)

Der Alias für das auszuführende Objekt

Reporttyp (report-type)

Definiert den Reporttyp, der geholt werden soll

Mögliche Werte: Aktivierungsreport (ACT), Mandanten-Report (CLNT), Laufzeit-Report (LOG), SYSLST-Report für BS2000-Jobs (LST), Objekt-Report (OBJ), Agent-Report (PLOG), Post-Script-Report (POST), Interner Report (PP), Jobreport (REP), Script-Report (REV0), JCL-Report (REV1), Objektzugriffsreport (REV2)

Modus (mode)

Definiert den Ausführungsmodus, d.h. was nach dem Start des Jobs zu tun ist. Das Modul kann sich direkt nach der Aktivierung beenden oder auf das Ende der Aufgabe warten oder auf das Ende warten und einen ausgewählten Report ausgeben.

Mögliche Werte: Direkt beenden (exit), Promptset abwarten (promptset), Auf den Job warten (wait), Report holen (report)

Logisches Datum (logical-date)

Definiert das logische Datum, dass an das auszuführende Objekt weitergereicht wird

Parameter-Datei (instance-parameter)

Datei mit den Parametern

Prompt-Puffer Datei (prompt-buffer)

Eine Datei mit einer Liste von Variablen, die an das ausgeführte Objekte weiter gereicht wird, um PromptSet-Werte zu setzen

Übernehme den Return-Code (use-retcode)

ist die Option gesetzt wird der Return-Code des Jobs für das Programm verwendet

Verwende den Status-Code für den Rückgabewert (use-status-code)

Ist die Option gesetzt, dann wird der Rückgabewert des Moduls durch den Status-Code des ausgeführten Objektes gesteuert. Nur wenn die Aktivität mit einem Status endet, der ANY_OK entpricht, wird das Modul mit dem Rückgabewert 0 beendet. Anderenfalls ist es 1.

Starttyp (start-type)

Definiert ob das Objekt einmalig oder wiederholend ausgeführt werden soll

Mögliche Werte: Einmalig (once), Wiederholend (recurring)

Start (period-start)

Definiert das Startdatum der Periode für die Ausführung des Objektes

Ende-Modus (period-end-mode)

Definiert, ob die Periode ein Ende hat oder nicht

Mögliche Werte: Niemals (never), Am (on), Nach (after)

Enddatum (period-end-date)

Die Ausführungen des Objekten enden am angegebenen Datum

Anzahl der Ausführungen (period-end-after)

Definiert die genaue Anzahl von Ausführungen, die durchgeführt werden soll

Beschreibung (period-description)

Eine optionale Beschreibung für die C_Period-Aufgabe

Modus (frequency-mode)

Definiert die Frequenz für die Ausführung innerhalb eines Tages

Mögliche Werte: Am (at), Intervall (interval), Nach dem vorherigen Lauf (after)

Intervall (frequency-interval)

Das Intervall in Stunden und Minuten

Zeit (frequency-time)

Das Objekt wird zur angegebenen Zeit ausgeführt

Erlaube eine Überlappung (frequency-overlap)

Ist die Option gesetzt kann die nächste Ausführung starten auch wenn die letzte noch nicht beendet ist

Startzeit (frequency-start)

Die Startzeit für das Intervall

Endzeit (frequency-end)

Die Endzeit für das Intervall

Initiale Startzeit anpassen (frequency-adjust-start-time)

Passt die erste Startzeit an ein Uhrzeit-Intervall an

Modus (days-mode)

Definiert die Variante für die Auswahl der Tage für die Ausführung

Mögliche Werte: Täglich (daily), Wöchentlich (weekly), Kalenderbedingung (calendar)

Tage (days-days)

Auswahl von Wochentagen für die Ausführung

Mögliche Werte: Montag (monday), Dienstag (tuesday), Mittwoch (wednesday), Donnerstag (thursday), Freitag (friday), Samstag (saturday), Sonntag (sunday)

Ausführungszeitpunkt (execute-at)

Ausführungszeit des Objekts

Kalenderregel (days-calendar-match)

Definiert die Weise, in der die Kalenderbedingungen zutreffen müssen.

Mögliche Werte: Alle (all), Keine (none), Eine (one)

Kalender-Keyword (days-calendars)

Eine Liste von Paaren aus einem Kalender-Objekt und einem Keyword

../../_images/util-activate-options.png

Beschreibung

Die Datei für die Prompt-Puffer Datei ist im CSV-Format mit einem Semikolon als Trennzeichen zwischen dem Variablennamen und dem Wert anzugeben, wie in dem folgenden Beispiel zu sehen.

variable1#;42
variable2#;best4Automic

Um einen mehrzeiligen Wert zu übergeben muss dieser in Anführungszeichen geschrieben werden.

variable1#;42
variable2#;"best4Automic Solution
die Ergänzung für AWA"

Um bei einer Checkbox mehrere Werte zu füllen, muss dieser in Anführungszeichen gesetzt und mit dem in dem PromptSet bei dem Parameter hinterlegten Trennzeichen getrennt werden.

variable1#;42
variable2#;"b4A;best4Automic;42"

Gleiches gilt für die Parameter-Datei.

Modi

Das Modul kann über die Option Modus (mode) das Verhalten beeinflussen wie bzw. ob das aktivierte Objekt beobachet werden soll.

  • Direkt beenden (exit): Nach der Aktivierung des Objektes beendet sich das odul sofort

  • Promptset abwarten (promptset): In diesem Fall wird geprüft, ob das Objekt in den Status „Warte auf Benutzereingabe“ kommt. In dem Fall werden die PromptSets mit den Vorgabewerten bestätigt. Sollte des zu aktivierende Objekt keine PromptSets haben, dann wird automatisch auf den Modus exit gewechselt. Anschließend beendet sich das Modul.

  • Auf den Job warten (wait): Nach der Aktivierung wird gewartet bis die Aufgabe beendet ist und danach beendet sich das Modul.

  • Report holen (report): Nach der Aktivierung wird gewartet bis die Aufgabe beendet ist und anschließend wird noch ein gewählter Report ausgegeben.