Konsolenereignisobjekte (CONS)

Konsolenereignisse, Ereignisobjekte
{"URL":["/*.*/awa/pa_view_EVNT_CONS"],"heroDescriptionIdentifier":"ice_CONS_events","customCards":[{"id":"ice_CONS_events_def_exec_mon","title":"Defining Console Events","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_Event_DefiningCONS.htm","languages":["en-us"]},{"id":"ice_attributes_eventobject","title":"Event Object Attributes","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_Event_Attributes.htm","languages":["en-us"]},{"id":"ice_Cons_attributes_event","title":"Console Event Attributes","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_Event_Attributes_Console.htm","languages":["en-us"]},{"id":"ice_executemonitor_event","title":"Activating Events","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_event.htm","languages":["en-us"]},{"id":"ice_events_process_page","title":"Event Process","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_Process_Event.htm","languages":["en-us"]},{"id":"ice_eventexecute","title":"Executing Events","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Executions/obj_ExecEvents.htm","languages":["en-us"]},{"id":"ice_Object_AnalyzeLastExecution","title":"Analyzing the Event Execution Using Gen AI","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WkgWithAnalyzeExecData.htm","languages":["en-us"]},{"id":"ice_eventmonitor","title":"Monitoring Events","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/ProcMonitoring/PM_MonitoringEvents.htm","languages":["en-us"]},{"id":"ice_working_with_objects","title":"Working with Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WorkingWithOverview.htm","languages":["en-us"]},{"id":"ice_ExecutingObjects","title":"Executing Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Executions/obj_Executing_overview.htm","languages":["en-us"]},{"id":"ice_AWIs_CommonFunctions","title":"Common Functions","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/CommonFunctions/CF_OverviewOfChapter.htm","languages":["en-us"]},{"id":"ice_UnderstandingPA","title":"Understanding the Process Assembly Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/ProcessAssembly.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

Als Entwickler und Objektdesigner definieren Sie Konsolenereignisse (CONS), um den Inhalt der von der Konsole (dem Zielsystem) zurückgegebenen Meldungen, Meldungs-Queues usw. zu überwachen. Verwenden Sie Konsolenereignisse, um zu überprüfen, ob ein bestimmter String in den Meldungen vorhanden ist, in bestimmten Intervallen und optional zu bestimmten Daten oder Uhrzeiten. Wenn die Bedingungen, die Sie auf der Seite Ereignis definieren, erfüllt sind, löst das Konsolenereignis die Aktionen aus, die Sie auf seiner Seite Ereignis-Prozess definieren. Diese Aktionen sind in der Regel die Ausführung weiterer Objekte. Konsolenereignisse befinden sich im Status Sleeping, solange Häufigkeit und Zeitbedingungen nicht erfüllt sind. Der Status ändert sich in Überprüfung, wenn die Bedingungen erfüllt sind.

Überwachte Agenten

Konsolenereignisobjekte überwachen die Ausgabe und Meldungen, die von den folgenden Agenten zurückgegeben werden:

  • BS2000

    Konsolen-Ausgabe

    Voraussetzung: Installieren Sie das Dienstprogramm UCXEB2xU für die Konsole, das parallel zum BS2000-Agenten laufen soll.

  • z/OS

    Konsolen-Ausgabe. Unterstützung mehrerer Konsolen - MCS.

  • OS/400

    Meldungsqueue

  • SAP-Ereignisse

    • ABAP Event History

    • XI-Kommunikationskanäle (Statusänderungen)

    • Java Event History

  • Der Ereignisanzeige von Windows

Funktionen

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

Diese Seite beinhaltet Folgendes:

Konsolenereignisse definieren

Auf der hier beschriebenen Seite Konsolenereignis definieren Sie, was das CONS-Ereignisobjekt überprüfen soll. Auf der Seite Seite "Ereignisobjekt-Prozess" definieren Sie die Aktionen, die ausgelöst werden, wenn die Bedingungen erfüllt sind.

So definieren Sie CONSOLE-Ereignisobjekte:

  1. Auswahl des zu überwachenden Ereignisses.

    Im Abschnitt Konsolenereignis geben Sie die Eigenschaften ein, die das Ereignis identifizieren, das Sie mit diesem Objekt überwachen möchten.

    1. Geben Sie die Agenten- und Quelldetails der zu überwachenden Ereignisse an.

      Führen Sie im Agent eine der folgenden Aktionen aus:

      • Wählen Sie einen Eintrag aus der Liste aus.

      • Geben Sie entweder den Namen des Agenten ein oder geben Sie eine Variable ein, die den Namen des Agenten abruft, und wählen Sie den entsprechenden Agententyp aus.

        Verwenden Sie diese Option, wenn der Agent nicht dem aktuellen Mandanten, sondern dem Mandanten 0 zugeordnet ist und daher hier nicht aufgeführt ist.

      Je nachdem, welchen Agenten Sie ausgewählt haben, variieren die übrigen Felder in diesem Abschnitt.

      Weitere Informationen finden Sie hier:

    2. In der Tabelle Ereignisse geben Sie die Bedingungen an, die die überwachte Konsolen-Ausgabe erfüllen soll, damit die Aktionen auf der Seite Ereignis-Prozess ausgelöst werden.

      Zulässige Platzhalterzeichen: * (eine beliebige Anzahl von Zeichen) und ? (ein bestimmtes Zeichen)

      Geben Sie je nach ausgewähltem Agenten die folgenden Parameter ein:

      • BS2000

        Geben Sie in der Tabelle Ereignisse den String ein, nach dem das Ereignis suchen soll.

      • OS/390

        • Systemname

          Filter für den benutzerdefinierten Systemnamen, mit dem verschiedene Instanzen des Betriebssystems in einem Komplex unterschieden werden

          Maximale Länge: 8 Zeichen.

        • Setzen Sie hier einen Filter für den OS Namen wie von IBM definiert. Derzeit ist es immer "MVS".

          Maximale Länge: 8 Zeichen.

        • Jobname

          Zu überwachende Jobs

          Maximale Länge: 32 Zeichen.

        • Meldungsfilter 

          String, nach dem gesucht werden soll

          Wichtig! Der String muss immer mit einem Platzhalterzeichen beginnen.

        Hinweis: Um die Konsolenausgabe in z/OS zu überwachen (Multiple Console Support - MCS), installieren Sie den Ereignis-Monitor UCXEMxx. Starten Sie ihn mit einem entsprechenden Eintrag in der INI-Datei des z/OS-Agenten.

      • OS/400

        In OS/400 können Sie Meldungsqueues überwachen. Sie definieren die Queue in der INI-Datei des OS/400-Agenten.

        Zulässige Schweregradwerte: 0 bis 999

      • SAP

        Das Konsolenereignis für SAP unterscheidet verschiedene Datenquellen:

        • ABAP Event History

          • Ereignis-ID

            Filter für den Namen des SAP-ABAP-Ereignisses.

          • Ereignisparameter

            Filter für den Parameter des SAP-ABAP-Ereignisses.

          • Event-Server

            Filter für den Batch-Server-Namen des SAP-ABAP-Ereignisses.

          • Hinweise:

          • Sie benötigen XBP 3.0, um SAP-Ereignisse zu überwachen. Geben Sie die verwendete Version der XBP-Schnittstelle in der SAP-Verbindung (CONN) an. Weitere Informationen finden Sie unter Überwachung von SAP-Ereignissen.

          • Der Agent fragt das SAP-System periodisch nach eingetretenen SAP-Ereignissen ab und meldet sie den aktiven Konsolenereignissen.

            Der Administrator kann das erforderliche Intervall mithilfe des Schlüssels JOB_CHECKINTERVAL in der Variablen UC_HOSTCHAR_DEFAULT definieren. Weitere Informationen finden Sie unter UC_HOSTCHAR_DEFAULT - Host-Charakteristika.

          • Legen Sie mit der Transaktion SM64 ein Kriterienprofil für die Event History an.

          • Die Script-Funktion GET_EVENT_INFO stellt zusätzliche Informationen über das SAP-Ereignis bereit. Weitere Informationen finden Sie unter GET_CONSOLE, GET_EVENT_INFO.

        • XI-Kommunikationskanäle

          • Login

            Objekt, das die Anmeldeinformationen für das XI-Objekt enthält
            Das Login-Objekt hat Vorrang vor den Daten, die im Verbindung (CONN) angegeben sind.

            Wichtig! Verwenden Sie unterschiedliche Login-Objekte für SAP- und XI-Systeme, wenn beide auf dem gleichen Agent installiert sind, da sonst der Login-Eintrag nicht eindeutig wäre.

          • In Kanal, Partner und Dienst spezifizieren Sie den Ereignisfilter.

            Zulässiges Platzhalterzeichen: *

          • Status

            Mögliche Werte: ERROR, OK, INACTIVE, UNKNOWN und UNREGISTERED

          • Aktivierungszustand

            Mögliche Werte: STARTED und STOPPED

          Die Filterliste beschreibt den Sollzustand eines oder mehrerer Kommunikationskanäle. Ein Ereignis wird für jeden Kommunikationskanal ausgelöst, der

          • beim Start des Ereignisobjektes nicht dem Sollzustand entspricht
          • in einen anderen Status wechselt (ob nominal oder anders)

          Nur wenn beim Start des Ereignisobjektes der Kommunikationskanal dem Sollzustand entspricht, wird kein Ereignis ausgelöst.

          Sie können die Script-Funktion GET_EVENT_INFO auf der Seite Ereignis-Prozess verwenden, um zusätzliche Informationen über den XI-Kommunikationskanal bereitzustellen. Weitere Informationen finden Sie unter GET_CONSOLE, GET_EVENT_INFO.

        • Java Event History

          • Ereignistyp

            Filter nach dem Typ des SAP Java Scheduler-Ereignisses
            Der Inhalt dieser Liste wird aus der Variablen UC_SAP_XJBP_EVENTTYPES abgerufen, die in Mandant 0 verfügbar ist. Das Variablen-Objekt wird mit allen möglichen Ereignistypen bereitgestellt. Ändern Sie dieses Variablenobjekt nicht. Weitere Informationen finden Sie unter UC_SAP_JXBP_EVENTTYPES - Ereignistypen des Java Schedulers in SAP.

          • Ereignisparameter

            Filter für den Parameter des SAP Java Scheduler-Ereignisses

            Zulässige Platzhalterzeichen: * (eine beliebige Anzahl von Zeichen) und ? (ein bestimmtes Zeichen)

          • Ereignis Zusatzparameter

            Filter für zusätzliche Parameter des SAP Java Scheduler-Ereignisses

            Zulässige Platzhalterzeichen: * (eine beliebige Anzahl von Zeichen) und ? (ein bestimmtes Zeichen)

      • Windows

        In Windows überwachen Sie die Ereignisanzeige von Windows.

        Um auf bestimmte Meldungen zu reagieren, analysieren Sie die Ereignisanzeige. Die Ereignisdetails liefern die erforderlichen Angaben. Doppelklicken Sie auf die Einträge, um sie zu öffnen.

        Meldungstexte bestehen in Microsoft Windows aus statischen und variablen Teilen. Das Ereignis liefert nur die variablen Teile der Meldung. Wenn Sie einen Meldungsfilter verwenden, reagiert das Ereignis nur, wenn variable Meldungsteile durchsucht werden. Weitere Informationen finden Sie unter GET_WIN_EVENT.

        • Typ

          Zu überwachendes Log

        • Quelle

          Quelle des Windows-Ereignisses

        • Kategorie

          Definiert durch die Kategorie, die das Ereignis protokolliert hat
          Kombiniert Ereignisse desselben Kategoriewerts.

          Zulässige Zeichen: Numerisch.

          Geben Sie 0 ein, wenn Sie nicht nach Kategorie filtern möchten.

        • Ereignis-ID

          Geben Sie 0 ein, wenn Sie nicht nach Ereignis-ID filtern möchten.

        • Typ

          Typ des zu überwachenden Windows-Ereignisses

        • Benutzer

          Benutzer, dem das Windows-Ereignis zugeordnet ist

        • Meldungsfilter 

          String, nach dem in der Ausgabe gesucht werden soll.

  2. Unter Häufigkeit definieren Sie, wie oft das Ereignisobjekt aktiviert werden soll:

    • Wiederholt

      Aktiviert das Ereignisobjekt regelmäßig, abhängig von der unten definierten Einstellung

    • Bis zum ersten Treffer

      Aktiviert das Ereignisobjekt, bis die angegebenen Bedingungen zutreffen

  3. Legen Sie hier fest, wann das Ereignisobjekt aktiviert werden soll.

    Die Zeit- und Datumsbedingungen sind immer aktiviert. Ein Ereignis wird nur in einem der folgenden Fälle ausgelöst:

    • Mindestens eine der Bedingungen ist erfüllt.
    • Hier wurde keine Bedingung definiert.

    Auch die Zeitzone, die dem Ereignis zugeordnet ist, wird berücksichtigt. Eine Aktivierung von Ereignissen mit Angabe eines logischen Datums ergibt daher keinen Sinn.

    Siehe Tabellen auf Seiten.

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

Aktivieren/Ausführen und Überwachen eines Konsolenereignisobjekts

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:

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:

Ü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:

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:

Siehe auch: