Registerkarte "Filtern"

Über die Registerkarte Filtern im Ereignisbindungseditor können Sie Kriterien - sogenannte Vergleichselemente - für die Erfassung von Ereignissen definieren. Wenn Sie keine Vergleichselemente angeben, werden jedes Mal Ereignisse ausgegeben, wenn der ausgewählte Erfassungspunkt im CICS-Zielsystem ausgeführt wird.

Jedes Vergleichselement besteht aus Informationen, die das Vergleichselement, einen Operator und einen Wert angeben. Sie können beliebig viele Vergleichselemente festlegen, um die Situation anzugeben, in der dieser Erfassungspunkt ein Ereignis ausgeben soll. Die drei Arten von Vergleichselementen, die Sie angeben können, sind Kontext, Ereignisoptionen und Anwendungsdaten.

Einige Erfassungspunkte haben ein primäres Vergleichselement. Für ein primäres Vergleichselement wählen Sie Ist gleich als Einstellung für den Operator aus und Sie geben einen Wert an, um Leistungsprobleme zu vermeiden, wenn Sie weitere Erfassungsspezifikationen an einem Erfassungspunkt hinzufügen.

Anmerkung: Die CICS-Modulnamen können sich ändern; verwenden Sie deshalb in Ihren Erfassungsspezifikationen keine Filter, die DFH*-Modulnamen enthalten. Der Ereignisbindungseditor überprüft die Benutzereingabe beim Codieren der Namen der meisten DFH*-Module im aktuellen Programmfilter. Die Benutzer können nur DFH£*, DFH0*, DFHW2FI, DFHW2TS, DFHMQBP0, DFHMQBP3 oder DFHECID codieren. Darüber hinaus können DFHMIRR und DFHMIRS für das LINK PROGRAM-Anwendungsereignis codiert werden.
Eine Abbildung der Registerkarte "Filtern".

Kontext

Die Vergleichselemente in der Erfassungsspezifikation werden verwendet, um anhand des Kontexts des Erfassungspunkts zu filtern.

Jeder Erfassungspunkt hat Kontextelemente, für die Sie Vergleichselemente angeben können. Ein Beispiel ist die Transaktions-ID. Alle verfügbaren Kontextvergleichselemente werden in der Registerkarte Filtern angezeigt. Kontextvergleichselemente sind optional; allerdings geben Sie normalerweise die Transaktions-ID oder das aktuelle Programm an, um Ereignisse von einer bestimmten Anwendung auszugeben.

Der Kontextbereich wird verwendet, um Filteroptionen für Ereignisse festzulegen. Abhängig von anderen Informationen, die Sie im Ereignisbindungseditor angeben, finden möglicherweise nicht alle Felder Anwendung; die verfügbaren Kontextvergleichselemente hängen vom Erfassungspunkt ab. Sie können folgende Vergleichselemente angeben: Transaktions-ID, aktuelles Programm und Benutzer-ID.

Transaktions-ID
Operatoroptionen für alle Erfassungspunkte:
  • Alle
  • Ist gleich
  • Ist nicht gleich
  • Beginnt nicht mit
  • Beginnt mit
Zusätzliche Optionen für Anwendungserfassungspunkte:
  • Kleiner als
  • Nicht kleiner als
  • Größer als
  • Nicht größer als
Aktuelles Programm
Operatoroptionen für alle Erfassungspunkte:
  • Alle
  • Ist gleich
  • Ist nicht gleich
  • Beginnt nicht mit
  • Beginnt mit
  • Kleiner als
  • Nicht kleiner als
  • Größer als
  • Nicht größer als
Benutzer-ID
Operatoroptionen für alle Erfassungspunkte:
  • Alle
  • Ist gleich
  • Ist nicht gleich
  • Beginnt nicht mit
  • Beginnt mit
Zusätzliche Optionen für Anwendungserfassungspunkte:
  • Kleiner als
  • Nicht kleiner als
  • Größer als
  • Nicht größer als
Antwortcode
Operatoroptionen:
  • Alle
  • Ist gleich
Für den Ist-gleich-Operator stehen folgende Werte zur Verfügung:
  • OK
  • Nicht OK

Ereignisoptionen

Die Vergleichselemente in der Erfassungsspezifikation werden verwendet, um anhand der Werte von Ereignisoptionen für einen CICS-Befehl oder ein Systemereignis zu filtern.

Jeder Erfassungspunkt kann Ereignisoptionen haben, für die Sie Vergleichselemente angeben können. Einige Befehle haben keine Ereignisoptionen. Ereignisoptionen entsprechen den Optionen für einen bestimmten CICS EXEC-Befehl oder ein Systemereignis. Ein Beispiel für den SEND MAP-Befehl ist der MAP-Name. Ein Beispiel für das DB2-Verbindungsstatusereignis ist der FROM_CONNECTST-Status. Alle verfügbaren festen Datenwerte für den Erfassungspunkt werden in der Registerkarte Filtern angezeigt. Das Format der Ereignisoptionen ist CICS bekannt.

Name
Der Name der Erfassungsspezifikation.
Operator
Operatoroptionen für alle Erfassungspunkte:
  • Alle
  • Ist gleich
  • Ist nicht gleich
  • Beginnt nicht mit
  • Beginnt mit
Zusätzliche Optionen für Anwendungserfassungspunkte:
  • Alle
  • Ist gleich
  • Ist nicht gleich
  • Beginnt nicht mit
  • Beginnt mit
Zusätzliche Optionen für Systemerfassungspunkte:
  • Übersteigt den Wert
  • Unterschreitet den Wert
Wert
Der Wert, den Sie für das Vergleichselement angeben.
Die Begrenzungen bei Vergleichselementen für Anwendungsbefehlsoptionen variieren abhängig von der CICS-API. Beispielsweise besteht die TRANSID aus vier Zeichen; CHANNEL enthält 16 Zeichen. Der Ereignisbindungseditor wird für jeden Typ dynamisch angepasst und zeigt eine Nachricht an, wenn der Vergleichselementwert zu lang oder zu kurz ist.

Weitere Informationen zu Ereignisoptionen für CICS-API-Aufrufe finden Sie im Abschnitt Anwendungsereignisse in der Produktdokumentation zu CICS TS V5.4.0.

Weitere Informationen zu Ereignisoptionen für Systemereignisse finden Sie in den Abschnitten Systemereignisse in der Produktdokumentation zu CICS TS V5.4.0 und Registerkarte "Informationsquellen".

Anwendungsdaten

Die Vergleichselemente in der Erfassungsspezifikation werden verwendet, um nach Anwendungsdaten zu filtern, die in einem CICS-Befehl angegeben sind.

Anmerkung: Sie können keine Anwendungsdaten hinzufügen, wenn ein Erfassungspunkt DELETEQ TD oder DELETEQ TS für eine Erfassungsspezifikation definiert ist.

Anwendungserfassungspunkte können Datenwerte variabler Länge haben, für die Sie Vergleichselemente angeben können. Die Anwendungsdaten entsprechen den Optionen für einen bestimmten CICS EXEC-Befehl. Ein Beispiel für den SEND MAP-Befehl ist das FROM-Feld. Alle verfügbaren variablen Datenwerte für den CICS EXEC-Befehl für diesen Erfassungspunkt werden in der Registerkarte Filtern angezeigt.

Anwendungsdaten-Vergleichselemente werden von CICS in der angegebenen Reihenfolge verarbeitet; das heißt, zunächst wird das erste Vergleichselement verarbeitet, gefolgt vom zweiten Vergleichselement usw.

Anwendungsdaten werden für Speicherbereiche wie COMMAREAs oder Container verwendet, die als Optionen an CICS-Befehle übergeben werden. Das Format dieser Bereiche ist CICS nicht bekannt, aber Ihrem Anwendungsprogramm. In der Regel verfügen Sie über eine Quellensprachenbeschreibung, die Sie importieren können, um das Format zu beschreiben.
Anmerkung: Systemereignisse verwenden keine Anwendungsdaten.
Position
Der Wert des Felds "Position" hängt vom CICS-API-Aufruf ab.
Beispiele:
  • Bei dem Befehl EXEC CICS WRITE FILE(EXMPCAT) sind FROM und RIDFLD die Optionen für das Feld "Position".
  • Bei dem Befehl EXEC CICS INVOKE SERVICE(name) sind CHANNEL und SCOPE die Optionen für das Feld "Position".
Container
Gibt einen CICS-Kanalcontainer an. Das Containerfeld kann nur ausgewählt werden, wenn für die Anwendungsdaten ein Kanal angegeben ist. In allen anderen Fällen ist das Feld inaktiviert.
Versatz
Gibt die Entfernung von dem Punkt an, an dem die Daten beginnen. Versatz 0 ist der Anfang des Felds.
Länge
Die Länge des Felds in Byte. Eine Länge von 0 bedeutet, dass anhand des gesamten Datenbereichs oder Containers gefiltert werden soll. Dies ist nützlich, wenn z. B. anhand des Inhalts eines Containers unabhängig von seiner Länge gefiltert wird.
Operator
Operatoroptionen:
  • Alle
  • Ist vorhanden
  • Ist gleich
  • Ist nicht gleich
  • Ist nicht vorhanden
  • Beginnt mit
  • Beginnt nicht mit
  • Kleiner als
  • Nicht kleiner als
  • Größer als
  • Nicht größer als
Wert
Der Wert, den Sie für das Vergleichselement angeben.
Die Länge hängt vom Datentyp ab; zum Beispiel beträgt die maximale Länge für den Typ Zeichen 255 Zeichen, während die maximale Länge für den Typ Halbwort ohne Vorzeichen 5 Zeichen beträgt - mit einem Wert im Bereich von 0 bis 65535.