CONS-Ereignisse
Als Entwickler und Objektdesigner definieren Sie CONS (Konsole) Ereignisse, um den Inhalt der von der Konsole (dem Zielsystem) zurückgegebenen Meldungen, Nachrichtenwarteschlangen etc. zu überwachen. Beispielsweise prüfen sie mit einer bestimmten Häufigkeit und optional zu bestimmten Zeitpunkten, ob eine bestimmte Zeichenfolge in den Meldungen vorhanden ist. Wenn die Bedingungen, die Sie auf der Seite Ereignis-Script definieren, erfüllt sind, löst das CONS-Ereignis die Aktionen aus, die Sie auf seiner Seite Ereignis-Script definieren. Diese Aktionen sind in der Regel die Ausführung weiterer Objekte. CONS-Ereignisse befinden sich im Status Sleeping, solange die Frequenz- und Zeitbedingungen nicht erfüllt sind, und wechseln zu In Prüfung wenn sie zutreffen.
Sie können die folgenden Funktionen der Automation Engine Scriptsprache verwenden, um relevante Daten für das Ereignisobjekt abzurufen:
Dieses Thema beinhaltet Folgendes:
Konsolenereignisobjekte überwachen den Output und Meldungen, die von den folgenden Agenten zurückgegeben werden:
-
BS2000
Konsolen-Output
Voraussetzung: Installieren Sie das Dienstprogramm UCXEB2xU für die Konsole, die parallel zum BS2000-Agenten laufen soll.
-
z/OS
Konsolen-Output. Unterstützung mehrerer Konsolen - MCS.
-
OS/400
Nachrichtenwarteschlange
-
SAP-Ereignisse
-
XI
Kommunikationskanäle (Zustandsänderungen)
-
Der Ereignisanzeige von Windows
Treffen bestimmte Bedingungen wie z. B. die Ereignis-ID oder der Meldungsfilter zu, so werden die Script-Statements und -Funktionen der Seite Ereignis-Script ausgeführt.
Beachten Sie, dass die Angaben beim Meldungsfilter immer mit einem Platzhalterzeichen beginnen müssen.
Definieren Sie die Eigenschaften des Konsolenereignisses auf zwei Seiten:
- Konsolenereignis, siehe Anleitungen unten.
-
Dies ist der Kern eines jeden Ereignisobjektes. Geben Sie die zu verarbeitenden Statements an, sobald die definierten Bedingungen erfüllt sind.
Abschnitt Konsolenereignis
Die Comboboxen Agent und Agententyp sind für alle Agenten gleich.
-
Führen Sie im Agent eine der folgenden Aktionen aus:
- Wählen Sie einen Eintrag aus der Liste aus.
- Klicken Sie auf das Ordnersymbol, um das Dialogfeld Agenten auswählen zu öffnen und nach dem gewünschten Ordner zu suchen.
-
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.
Für die ersten beiden Optionen wird der Agententyp automatisch ausgewählt und kann nicht bearbeitet werden.
Je nachdem, welchen Agenten Sie ausgewählt haben, variieren die übrigen Felder in diesem Abschnitt.
-
In der Tabelle Ereignisse definieren Sie die Bedingungen, die der überwachte Konsolen-Output erfüllen soll, damit die Aktionen auf der Seite Ereignis-Script ausgelöst werden. Weitere Informationen finden Sie in den untenstehenden Ereignisbedingungen. Die folgenden Platzhalterzeichen können verwendet werden:
- * (beliebig viele Zeichen)
- ? (ein bestimmtes Zeichen)
Geben Sie die Bedingungen an:
-
BS2000
Geben Sie in der Tabelle Ereignisse die Zeichenfolge ein, nach der das Ereignis suchen soll. -
OS/390
-
Systemname
Filter für den benutzerdefinierten Systemnamen, mit dem verschiedene Instanzen des Betriebssystems in einem Komplex unterschieden werden können.
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
Zeichenfolge, nach der gesucht werden soll.
Um den Konsolen-Output (Multiple Console Support - MCS) in z/OS zu überwachen, installieren Sie den Ereignis-Monitor UCXEMxx und starten Sie ihn mit einem entsprechenden Eintrag in der INI-Datei des z/OS-Agenten.
-
-
OS/400
In OS/400 können Sie Nachrichtenwarteschlangen überwachen. Sie definieren die Queue in der INI-Datei des OS/400-Agenten.'
Erlaubte Dringlichkeitswerte: 0 bis 999 -
SAP
Das Konsolenereignis für SAP unterscheidet verschiedene Datenquellen:-
ABAP Event History
-
Event 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.
-
-
XBP 3.0 wird benötigt, um SAP-Ereignisse über den Ereignistyp „Konsole“ zu überwachen.
Die verwendete XBP-Schnittstellenversion ist in den SAPVerbindung (CONN) einzustellen.
-
Der Agent fragt das SAP-System periodisch nach eingetretenen SAP-Ereignissen ab und meldet sie den aktiven Konsolenereignissen.
Der Administrator kann das Intervall in der Variable UC_HOSTCHAR_DEFAULT mit dem Key JOB_CHECKINTERVAL einstellen. Siehe UC_HOSTCHAR_DEFAULT - Host-Charakteristik.
-
Ab Version 8.00A verwendet SAP die XBP-Schnittstelle.
Dies bedeutet, dass die SAP-Kriterienprofile angepasst werden müssen, um sicherzustellen, dass die ausgewählten ausgelösten Ereignisse im Ereignisverlauf protokolliert werden. Ansonsten kann das Konsolenereignis nicht reagieren.
-
Legen Sie mit der Transaktion SM64 ein Kriterienprofil für den Ereignisverlauf an.
-
Die Script-Funktion GET_EVENT_INFO liefert Ihnen nähere Informationen zum SAP-Ereignis.
-
XI-Kommunikationskanäle
-
Login-Objekt, das die Benutzerdaten für das XI-Objekt enthält.
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.
Das Login-Objekt übersteuert die Daten, die im Objekt Verbindung (CONN) angegeben wurden.
-
In Kanal, Partner und Service spezifizieren Sie den Ereignisfilter. Das Platzhalterzeichen „*“ kann verwendet werden.
-
Zustand
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 GET_EVENT_INFO Script-Funktion auf der Seite Ereignis-Script verwenden, um zusätzliche Informationen über den XI-Kommunikationskanal bereitzustellen. Siehe GET_CONSOLE, GET_EVENT_INFO.
-
-
Java Event History
-
Ereignistyp
Filter für den Typ des SAP Java Scheduler-Ereignisses.
Der Inhalt dieser Liste wird aus der UC_SAP_XJBP_EVENTTYPES-Variablen ermittelt, die in Mandant 0 verfügbar ist. Das Variablenobjekt wird mit allen möglichen Ereignistypen ausgeliefert und sollte nicht verändert werden.
-
Ereignisparameter
Filter für den Parameter des SAP Java Scheduler-Ereignisses.
Sie können die Platzhalterzeichen „*“ (beliebige Anzahl von Zeichen) und „?“ (genau ein Zeichen) verwenden.
-
Ereignis Zusatzparameter
Filter für zusätzliche Parameter des SAP Java Scheduler-Ereignisses.
Als Platzhalterzeichen können die Zeichen „*“ und „?“ verwendet werden. „?“ steht für genau ein, „*“ für beliebig viele Zeichen.
-
Beachten Sie Folgendes:
-
-
Windows
In Windows überwachen Sie die Ereignisanzeige von Windows. Um auf bestimmte Meldungen zu reagieren, analysieren Sie zunächst die Ereignisanzeige. Die Ereignisdetails liefern die erforderlichen Angaben. Sie können sie mit einem Doppelklick öffnen.In Microsoft Windows bestehen Meldungstexte 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 Nachrichtenteile durchsucht werden. Weitere Informationen zur Abfrage des Meldungstextes finden Sie hier GET_WIN_EVENT.
-
Typ
Protokoll, das überwacht werden soll.
-
Quelle
Quelle des Windows-Ereignisses.
-
Kategorie
Definiert durch die Kategorie, die das Ereignis protokolliert hat. Fasst Ereignisse der gleichen Kategorie zusammen.
Erlaubte Zeichen: Numerisch.
Geben Sie 0 ein, wenn Sie nicht nach Kategorie filtern möchten.
-
Event ID
Geben Sie 0 ein, wenn Sie nicht nach Event ID filtern möchten.
-
Typ
-
Benutzer
Benutzer, dem das Windows-Ereignis zugeordnet ist.
-
Meldungsfilter
Zeichenfolge, nach der gesucht werden soll.
-
Abschnitt „Zeitpunkt Parameter“
Unter Frequenz geben Sie an, wie oft das Ereignisobjekt aktiviert werden soll:
-
Wiederholt
Es wird periodisch aktiviert, abhängig von den Einstellungen, die Sie unten festlegen.
-
Bis zum ersten Treffer
Es wird solange aktiviert, bis die gesetzten Bedingungen zutreffen.
Abschnitt „Zeit- und Datumsbedingungen“
Diese Bedingungen werden immer geprüft. 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.
-
Auf der Seite Seite „Ereignis-Script“ definieren Sie die Aktionen, die das Ereignis auslösen wird.
-
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 Perspektive Process Monitoring 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 somit automatisch zu vorgegebenen Zeiten und/oder Intervallen auszuführen.
-
Ereignisobjekte in Workflows einfügen (siehe Gestaltung von 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 Event 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 Perspektive Process Monitoring zu.
Sie können aktive Ereignisse wie folgt stoppen:
- Ereignis abbrechen
Status: Abend/manueller Abbruch - Ereignis beenden
Status: Ended_OK - Ereignis unterbrechen
Ereignis bleibt aktiv, wird aber vorübergehend deaktiviert
Weitere Informationen finden Sie unter Mit Aufgaben arbeiten, insbesondere unter Stoppen und Unterbrechen.
- Ereignis abbrechen
Siehe auch: