FILE-Ereignisse

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:

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

Diese Seite beinhaltet Folgendes:

FILE-Ereignisobjekte definieren

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 "Ereignis-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).

    • File

      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 bei FILE-Ereignissen während der 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 Agentenspezifisch 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 "Ereignis-Prozess" definieren Sie die Aktionen, die das Ereignis auslösen wird.

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

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.

Führen Sie Ereignisobjekte wie folgt aus:

  • Fügen Sie Ereignisobjekte in Schedules (JSCH) ein, um sie automatisch zu vorgegebenen Zeiten und/oder Intervallen auszuführen.

  • Ereignisobjekte in Workflows einfügen (siehe Workflows (JOBP)).

  • Ereignisobjekte manuell ausführen, neu starten oder stoppen. Weitere Informationen finden Sie unter Ereignisse ausführen.

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 Objekt- und Aufgabendetails anzeigen.

Überwachen Sie das Ereignis

Sie können das Ereignis sofort nach der Ausführung des Objekts überwachen. Klicken Sie mit der rechten Maustaste auf das Objekt und wählen Sie Überwachen, In Process Monitoring anzeigen und öffnen Sie die vorgefilterte Liste der Aufgaben, um die Aufgabe anzuzeigen. Verfolgen Sie den Fortschritt der Aufgabe und greifen Sie auf Reports und statistische Informationen in der Process Monitoring-Perspektive zu.

Sie können aktive Ereignisse wie folgt stoppen:

  • Das Ereignis abbrechen
    Status: Abgebrochen/manuell abgebrochen
  • Das Ereignis beenden
    Status: Ended_OK
  • Das Ereignis unterbrechen
    Das Ereignis bleibt aktiv, ist aber vorübergehend deaktiviert

Weitere Informationen finden Sie unter Mit Aufgaben arbeiten, insbesondere unter Stoppen und Unterbrechen.

Verzögerungen bei FILE-Ereignissen während der Ereignisausführung

Umfangreiche I/O-Vorgänge und bestimmte Vorgehensweisen bei der Konfiguration von FILE-Ereignisobjekten können sich auf die Geschwindigkeit Ihres Systems auswirken. Zum 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

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.

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 dessen, 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.

Prüfungen der Gültigkeitszeit

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

Siehe auch: