FILE-Ereignisobjekte

Als Entwickler und Objektdesigner definieren Sie FILE-Ereignisse, um dateibezogene Bedingungen zu überwachen. Wenn die Bedingungen erfüllt sind, löst das FILE-Ereignis die Aktionen aus, die Sie definieren. Diese Aktionen sind in der Regel die Ausführung weiterer Objekte. FILE-Ereignisse befinden sich im Status Sleeping, solange die Frequenz- und Zeitbedingungen nicht erfüllt sind, und wechseln zu In Prüfung, wenn sie zutreffen.

FILE-Ereignisse können die Größe oder Anzahl der Dateien in einem Verzeichnis, den von den Dateien belegten Speicherplatz und die Verfügbarkeit von Speicherplatz in bestimmten Zielsystemen überwachen. Wenn Sie ein FILE-Ereignis verwenden, können Sie beispielsweise überwachen, ob eine bestimmte Anzahl von Dateien über FTP in ein Verzeichnis übertragen wurde, unabhängig davon, ob die Größe einer Datei innerhalb eines bestimmten Zeitraums geändert wurde usw.

Sie können die folgenden Funktionen der Automation Engine scripting language verwenden, um relevante Daten für das Ereignisobjekt abzurufen:

• GET_CONSOLE, GET_EVENT_INFO
• GET_FILESYSTEM

Wichtig! Einige Agenten unterstützen nicht alle hier beschriebenen Optionen.

Diese Seite beinhaltet Folgendes:

Auf der hier beschriebenen Dateiereignis-Seite definieren Sie, was das FILE-Ereignis-Objekt überprüfen soll.

• WO

  In Dateiereignis > Pfad legen Sie fest, wo die zu überwachenden Dateien gespeichert werden.

• WAS

  In Dateiereignis > Prüfbedingung und Datei definieren Sie, was überwacht werden soll.

• WANN

  Unter Zeitparameter legen Sie fest, wie oft diese Bedingungen überprüft werden sollen. Dieser Abschnitt ist deaktiviert, wenn Sie Datei geändert oder Dateigröße stabil überwachen möchten. In diesem Thema wird erläutert, warum.

• Zusätzliche Zeitbedingungen

  In Zeit- und Datumsbedingungen können Sie die Zeitbedingungen fein abstimmen.

Auf der Seite Seite "Ereignisobjekt-Prozess" definieren Sie die Aktionen, die ausgelöst werden, wenn die Bedingungen erfüllt sind.

Datei-Ereignisobjekte definieren

1. Geben Sie im Abschnitt Dateiereignis Folgendes an:

   • Pfad

     Geben Sie das Laufwerk, den Pfad oder die Signatur der überwachten Datei(en) ein. Abhängig vom jeweiligen Zielsystem können Sie hier Dateien, Laufwerke, Volumes, Pfade, Generation Data Groups usw. angegeben.

     Zulässiges Platzhalterzeichen: *, ?

     Hinweise:

     • Da * und ? als Platzhalterzeichen verwendet werden, können Sie sie nicht verwenden, um Dateien anzugeben, in deren Namen sie enthalten sind.

     • (Windows) Die Platzhalterzeichen * und ? können nur für Dateinamen und NICHT für Verzeichnisse innerhalb des Pfads verwendet werden.

     • (Windows) Schließen Sie Pfadspezifikationen mit \* ab

       Beispiel: C:\AUTOMIC\*

     • Wenn Sie ein oder mehrere Datenträger angeben, verwenden Sie das Präfix VOL=

       Beispiel: VOL=ALG*1 gibt Informationen über alle Datenträger zurück, deren Name mit ALG beginnt und mit 1 endet.

     • (z/OS) Für Generation-Datengruppen verwenden Sie das Platzhalterzeichen * in eckigen Klammern. Weitere Informationen finden Sie unter Unterstützung von GDG (Generation Data Groups).

     Sie können den Pfad eingeben oder eine Variable verwenden. Weitere Informationen finden Sie unter Variablen/VARA-Objekte in Objekte und Scripts einfügen.

   • Prüfbedingung

     Wählen Sie aus, was überwacht werden soll. Durch die Auswahl wird festgelegt, welche Felder angezeigt und für die Dateneingabe verfügbar sind:

     • Dateigröße

       Der Agent rechnet bei der Prüfung die Dateigröße und den angegebenen Wert in Bytes um, damit er beide genau vergleichen kann.

     • Dateianzahl

       Verwenden Sie diese Option, um beispielsweise FileTransfers zu überwachen.

     • Belegter Speicher

       Für VMS: WINDOWS - und UNIX-Agenten.

       Aktivieren Sie das Kontrollkästchen Unterverzeichnisse einbeziehen, damit das System den verwendeten Speicherplatz im eingegebenen Pfad einschließlich der Dateien in den Unterverzeichnissen berechnet.

       Das Aktivieren dieses Kontrollkästchens kann sich auf die Leistung Ihres Systems auswirken.

     • Freier Speicher

       Für BS2000-Agenten

       Freier Speicher- bzw. Plattenplatz.

     • Zugewiesener Speicher

       Für z/OS-und Windows-Agenten

       Freier Speicherplatz von Volumes (z/OS) oder eines Laufwerkes (Windows).

   • Datei

     Verfügbar, wenn Sie Dateigröße oder Anzahl der Dateien in Prüfbedingung ausgewählt haben. Hier legen Sie fest, was überwacht werden soll:

     • Datei geändert

       Das FILE-Ereignis überprüft, wann die Datei erstellt wurde, und gibt den letzten Änderungszeitstempel an. Wenn die Datei vor dem Start des Ereignisses erstellt wurde und die tatsächliche Dateigröße mit dem zuvor angegebenen Wert übereinstimmt, wird die auf der Prozess-Seite definierte Aktion ausgelöst.

     • Dateigröße stabil

       Der Agent überprüft, ob sich die Größe der Datei im von Ihnen definierten Zeitrahmen geändert hat, unabhängig davon, wann sie erstellt wurde. Wenn die Dateigröße innerhalb dieses Zeitraums nicht geändert wurde, löst der Agent die Aktion aus.

     Wichtig! Wenn Sie Datei geändert oder Dateigröße stabil auswählen, wird der Abschnitt Zeitparameter deaktiviert. Sie können die Häufigkeit, mit der das Ereignis die Bedingung überprüft, nicht über die Benutzeroberfläche konfigurieren. Stattdessen bestimmt ein Mechanismus, der auf dem Agenten verfügbar ist, die Häufigkeit. Weitere Informationen finden Sie unter Verzögerungen während der FILE-Ereignisausführung.

   • Unterverzeichnisse einbeziehen

     Für VMS-, UNIX- und Windows-Agenten.

     Verwenden Sie Platzhalterzeichen oder Unterverzeichnisse, um eine Datei mehrmals zu finden. Wählen Sie für die spezifizierten Bedingungen Eine Datei muss zutreffen oder Alle Dateien müssen zutreffen aus.

     Das Aktivieren dieses Kontrollkästchens kann sich auf die Leistung Ihres Systems auswirken.

   • Vergleicher

     Wählen Sie den Operator aus, der für die Bewertung der Bedingungen verwendet werden soll.

   • Wert

     Legen Sie einen Wert fest, auf den sich die ausgewählte Prüfung und der Operator beziehen.

   • Einheit

     Wählen Sie die Einheit für die Messung des Wertes. Arbeitet das Zielsystem mit einer anderen Maßeinheit, wird entsprechend umgerechnet.

     Soll aber die Maßeinheit aus dem Zielsystem verwendet werden, beispielsweise PAM-Seiten im BS2000, muss Agenten spezifisch verwenden ausgewählt sein.

     Diese Liste ist nur verfügbar, wenn dies relevant ist.

2. Definieren Sie im Abschnitt Zeitparameter die Parameter für die Ereignisüberwachung:

   • Häufigkeit

     Geben Sie an, wie oft das FILE-Ereignisobjekt aktiviert werden soll, d. h. wie oft die von Ihnen definierten Bedingungen überprüft werden.

     Kurze Intervalle gewährleisten eine schnellere Ausführung, wirken sich jedoch auf die Systemleistung aus.

   • Zeitsteuerung

     Wenn Sie Häufigkeit: Wiederholt oder Wiederholen bis zur ersten Übereinstimmung ausgewählt haben, geben Sie an, wann das FILE-Ereignisobjekt aktiviert wird. Einige dieser Einstellungen können zur Laufzeit gelesen werden. Verwenden Sie Script-Elemente, um auf die Attribute dieses Objekts zuzugreifen.

   • Erste Prüfung

     Wenn Sie Häufigkeit: Wiederholt oder Wiederholen bis zur ersten Übereinstimmung ausgewählt haben, konfigurieren Sie, wann die Intervalle beginnen sollen:

     • Sofort bedeutet, dass das FILE-Ereignisobjekt unabhängig vom eingestellten Intervall zum ersten Mal bei seiner Aktivierung aktiv wird.

     • Nach dem ersten Intervall bedeutet, dass das FILE-Ereignisobjekt zum ersten Mal nach dem Ablauf des ersten Zeitintervalls aktiv wird.

   • Falls Startzeit später

     Wenn Sie Prüfhäufigkeit: um ausgewählt haben, geben Sie an, wann das Ereignis aktiviert werden soll:

     • Sofort aktivieren bedeutet, dass das FILE-Ereignis sofort aktiviert wird, wenn es nach der angegebenen Zeit gestartet wird.

     • Warten auf das nächste gültige Datum bedeutet, dass wenn das FILE-Ereignis nach dem angegebenen Zeitpunkt gestartet wird, es zum nächsten gültigen Datum aktiviert wird. Dabei werden die Kalender- und Zeitbedingungen berücksichtigt, die Sie im Abschnitt Zeit- und Datums Bedingungen angegeben haben.

3. Das FILE-Ereignisobjekt überprüft immer die Zeit- und Datumsbedingungen, die Sie im Abschnitt Zeit- und Datumsbedingungen angeben. Das Ereignis wird nur ausgelöst, wenn mindestens eine der hier angegebenen Bedingungen erfüllt ist oder keine Zeit-/Datumsbedingung definiert wurde.

   Das aktuelle Datum samt Uhrzeit dient als Referenz. Auch die Zeitzone, die dem Ereignis zugeordnet ist, wird berücksichtigt.

   Wichtig! Zeitangaben werden auf volle Minuten überprüft. Beispiel: eine Endzeit, die als 23:59 Uhr definiert ist, dauert bis 23:59:59. Das bedeutet, das Ereignis kann auch in diesen letzten 59 Sekunden ausgelöst werden.

4. Auf der Seite Seite "Ereignisobjekt-Prozess" definieren Sie die Aktionen, die das Ereignis auslösen wird.

Umfangreiche I/O-Vorgänge und bestimmte Vorgehensweisen bei der Konfiguration von FILE-Ereignisobjekten können sich auf die Geschwindigkeit Ihres Systems auswirken. Beispiel:

• Das Starten eines FILE-Ereignisses pro Minute, wenn dieses Ereignis ausgeführt wird, dauert fast eine Minute. In diesem Fall würde der Agent die I/O der Festplatte belegen.
• Wenn Sie ein Ereignis jede Minute überprüfen, dauert die Ausführung dieses Ereignisses länger als eine Minute. In dieser Situation würden sich die Ereignisausführungen überschneiden.
• Die Ausführung von FILE-Ereignissen hängt von der Anzahl der Dateien ab, die unterschiedlich sein kann, ebenso wie von der Geschwindigkeit des Dateisystems. Die Ausführungszeit der Ereignisse kann daher variieren und kann nicht prognostiziert werden.

Um in diesen Situationen negative Auswirkungen auf Ihr System zu vermeiden, haben die Windows-, UNIX-, BS2000- und OS400-Agenten folgende integrierte Schutzmechanismen:

• Adaptive Verzögerung
• Prüfungen der Ausführungsdauer
• Prüfungen der Gültigkeitszeit

Verzögerungen während der FILE-Ereignisausführung: adaptive Verzögerung

FILE-Ereignisse ermöglichen ein rekursives und häufiges Scannen von Verzeichnisstrukturen und die Überwachung einer großen Anzahl von Dateien. Statt in regulären, statischen Intervallen zu überprüfen, verwendet der Agent eine adaptive Verzögerung zwischen den Ausführungen von FILE-Ereignissen. Zu diesem Zweck berechnet der Agent, wann das Ereignis als nächstes ausgeführt wird. Zur Berechnung verwendet der Agent einen Algorithmus, der die aktuelle Ausführungszeit des Ereignisses und die Anzahl der gleichzeitig ausgeführten Ereignisse berücksichtigt.

Systemadministratoren können die Mindestwartezeit zwischen den Ausführungen von FILE-Ereignissen im Schlüssel EVENT_CHECKINTERVAL in der Variablen UC_HOSTCHAR_DEFAULT festlegen. Dies bedeutet, dass EVENT_CHECKINTERVAL kein Intervall, sondern eine Verzögerung ist.

Weitere Informationen finden Sie unter EVENT_CHECKINTERVAL.

Verzögerungen während der FILE-Ereignisausführung: Prüfungen der Ausführungsdauer

Die Verzögerung wird basierend auf dem Wert berechnet, der im Schlüssel EVENT_CHECKINTERVAL angegeben ist, und unter Berücksichtigung, wie lange die letzte Ausführung des FILE-Ereignisses gedauert hat:

• Wenn die Ausführung kürzer als der im Schlüssel angegebene Wert dauerte, ist die nächste Prüfverzögerung der Wert, der im Schlüssel definiert wurde.
• Wenn die Ausführung länger dauerte, ist die Verzögerung ein Vielfaches des Werts im Schlüssel EVENT_CHECKINTERVAL. Der Wert, den die Ausführung für die letzte Ausführung verwendet hat, wird mit der Anzahl der gleichzeitigen Ereignisse multipliziert.

Die maximale Verzögerung beträgt jedoch immer 10 Minuten.

Verzögerungen während der FILE-Ereignisausführung: Prüfungen der Gültigkeitsdauer

Bei serverbasierten FILE-Ereignissen bestimmt der Kalender, den Sie dem FILE-Ereignis zuweisen, die Gültigkeitsdauer des Ereignisses. Wenn das Ereignis außerhalb dieser Zeiten ausgelöst wird, wird die Überprüfungsverzögerung auf 10 Minuten gesetzt.

Bei agentenbasierten FILE-Ereignissen (z. B. Dateigröße stabil, Dateigröße geändert) wird die Prüfung im ursprünglichen Intervall außerhalb des Gültigkeitszeitfensters fortgesetzt.

Aktivieren/Ausführen und Überwachen des FILE-Ereignisobjekts

Führen Sie das Ereignisobjekt aus, um es zu aktivieren.

Die Ausführung von Ereignisobjekten löst die Ausführung anderer Objekte aus; diese können wiederum zur Ausführung weiterer Aufgaben führen. Die Aufgaben, die sich aus diesen Ausführungen ergeben, werden in der Process Monitoring-Perspektive auf den verschiedenen Listen der Ausführungen, die sich auf das Ereignisobjekt beziehen, angezeigt. Sie sind der Ereignisaufgabe untergeordnet und werden mit einem speziellen Tag-Typ namens !EVNT gekennzeichnet. Mit diesem Tag können Sie überprüfen, welche Ausführungen durch ein bestimmtes Ereignis ausgelöst wurden. Weitere Informationen finden Sie unter Ereignisse überwachen und Ausführungsdaten.

Ereignisse können in Schedules (JSCH) eingebunden werden und somit automatisch zu vordefinierten Terminen oder Intervallen ausgeführt werden. Ebenso können sie Teil von Workflows (JOBP) sein. Weitere Informationen finden Sie unter Übergeordnete Aufgaben (Parent).

Sie können Ereignisse auch manuell ausführen, neu starten oder stoppen. Die folgenden Themen beschreiben im Allgemeinen den Ausführungsprozess in Automic Automation und die ereignisspezifischen Merkmale:

• Ausführungsoptionen

• Ausführen von Objekten

• Ausführen von Ereignissen

Um zu überprüfen, wie oft das System das Ereignis geprüft hat, gehen Sie in den Abschnitt Anzahl überprüfen in den Objektdetails. Weitere Informationen finden Sie unter Anzeigen von Objekt- und Aufgabendetails.

Hinweis: Wenn ein Zeitereignis außerhalb der Zeit- und Datumsbedingungen aktiviert wird, wird es sofort aktiviert, nachdem das erste Zeitintervall verstrichen ist.

Überwachen Sie das Ereignis

Sie können das Objekt sofort nach seiner Ausführung überwachen. Klicken Sie mit der rechten Maustaste darauf, um Monitoring auszuwählen, um auf alle Monitoring-Optionen zuzugreifen:

• In Process Monitoring anzeigen

• Ausführungsdaten

• Verständnis von Reports

• Analysieren der letzten Ausführung ausführbarer Objekte

Über die Aufgabenliste in der Perspektive "Process Monitoring" können Sie auf alle Funktionen zugreifen, die für Ereignisaufgaben verfügbar sind, siehe Mit Aufgaben arbeiten. Für Ereignisaufgaben stehen die folgenden Optionen zum Anhalten zur Verfügung:

• Ereignis abbrechen

  Status: Abgebrochen/manuell abgebrochen

• Ereignis beenden

  Status: Ended_OK

• Ereignis unterbrechen

  Ereignis bleibt aktiv, wird aber vorübergehend deaktiviert

Verwandte Informationen:

• Aufgabenstatus

• Fehlerbehebung, Ursachenanalyse und Behebung

• Stoppen und Unterbrechen

Analysieren der letzten Ausführung des Ereignisses mit Gen AI

Nachdem Sie als Entwickler und Objektdesigner ein ausführbares Objekt konfiguriert haben, führen Sie es aus, um sicherzustellen, dass es wie erwartet funktioniert. Jedes Mal, wenn Sie das Objekt ausführen, wird eine runID generiert, die diese Ausführung identifiziert. Wenn die Ausführung fehlschlägt oder das Ergebnis nicht wie erwartet ausfällt, verwenden Sie die Reports und Ausführungslisten, um die Ursachen des Fehlers zu untersuchen.Gen AI von Automic Automation vereinfacht diesen Prozess erheblich. Sie können den Automation AI Assistant wie folgt öffnen:

• Klicken Sie in der Explorer-Liste in der Process Assembly-Perspektive mit der rechten Maustaste auf das Objekt, und wählen Sie Monitoring > letzte Ausführung analysieren aus.

• Klicken Sie auf der objektspezifischen Definitionsseite auf die Schaltfläche Letzte Ausführung analysieren.

Gen AI von Automic Automation durchforscht alle Reports und Protokolle, die für die letzte Ausführung des Objekts verfügbar sind, fasst das Geschehen zusammen, analysiert das Automatisierungsergebnis und stellt Vorschläge zur Lösung vorhandener oder potenzieller Probleme zur Verfügung. Es enthält auch einen Link zur Ausführung in der Ausführungsliste (Process Monitoring) und zum Report. Sie können eine Unterhaltung im Feld Ask Automation AI Assistant (Automation-AI-Assistenten fragen) am unteren Ende des Teilfensters beginnen.

Weitere Informationen finden Sie hier:

• Analysieren von Ausführungen mit Automation AI Assistant

• Analysieren von Berichten mit Automation AI Assistant

• Analysieren von Scripts mit Automation AI Assistant

• ASK_AI