Hinzufügen einer Erfassungsspezifikation

Sie können einer Ereignisspezifikation Erfassungsspezifikationen hinzufügen, um Erfassungspunkte in CICS zu erstellen.

Informationen zu diesem Vorgang

Der Ereignisbindungseditor führt Sie durch den Prozess der Erstellung von ein oder mehr Erfassungsspezifikationen. Diese Spezifikationen geben die folgenden Elemente an:

  • Alle Punkte in einem Programm, die als Ereignis angesehen werden
  • Die Bedingungen, unter denen das jeweilige Ereignis als gültig angesehen wird
  • Art und Weise, wie die bei einem Erfassungspunkt zu erfassenden Daten in der Ereignisausgabedatenstruktur zugeordnet werden sollen

Beispielsweise können Sie angeben, dass ein READQ TS-Befehl (Lesen (READ) des temporären Speichers) ein potenzielles Ereignis ist. Anschließend bestimmen Sie die Bedingungen, unter denen das Ereignis ausgelöst wird, indem Sie Vergleichselemente hinzufügen, die für den Befehl verfügbar sind, den Sie abfangen wollen. Alle Vergleichselemente müssen WAHR sein, damit das Ereignis ausgelöst wird.

Sie können drei Arten von Vergleichselementen definieren:
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.

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.

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.

Zu den grundlegenden Ereignisbindungsinformationen, die der Fachanwender während der allgemeinen Definition der Ereignisbindung eingibt, gehört auch eine Ereignisspezifikation. Im Rahmen dieser Ereignisbindungsinformationen wurden auch Daten angegeben, von denen bekannt war, dass sie für die weitere Verarbeitung benötigt werden, aber es lagen kein Details über ihre Position vor. Sie geben Informationsquellen an, um diese Details bereitzustellen.

Der Ereignisbindungseditor hilft dabei, indem er auf der Registerkarte Informationsquellen eine Tabelle mit den Informationen anzeigt, die er zur Umsetzung der Geschäftsspezifikation benötigt. Die Tabelle zeigt die Geschäftsinformationen aus der Ereignisspezifikation. Für jedes Element in der Tabelle müssen Sie die Quelle der Informationen für diese Erfassungsspezifikation definieren.

Vorgehensweise

  1. Klicken Sie auf der Registerkarte Spezifikation auf eine Ereignisspezifikation. Das rechte Teilfenster zeigt die Details der hervorgehobenen Ereignisspezifikation.
  2. Klicken Sie auf Erfassungsspezifikation hinzufügen. Das Fenster Erfassungsspezifikation hinzufügen wird angezeigt.
  3. Geben Sie einen Namen für Ihre neue Erfassungsspezifikation ein. Die zulässigen Zeichen sind A-Z, a-z, 0-9 und _. Führende und eingebettete Leerzeichen sind nicht zulässig. Die Zeichenfolge darf nicht mit 0-9, _ oder mit der Folge "xml" beginnen (unabhängig davon, ob sie kleingeschrieben, großgeschrieben oder in Groß-/Kleinschreibung vorliegt - also z. B. "Xml" oder "xMl").
  4. Optional: Geben Sie eine Beschreibung für Ihre neue Erfassungsspezifikation ein.
  5. Klicken Sie auf OK. Eine neue Erfassungsspezifikation wird erstellt. Im rechten Editorteilfenster werden drei Registerkarten geöffnet: Erfassungspunkt, Filtern und Informationsquellen. Verwenden Sie jede Registerkarte, um Informationen anzugeben, die die neue Erfassungsspezifikation beschreiben.
  6. Klicken Sie auf die Registerkarte Erfassungspunkt. Führen Sie die folgenden Schritte aus, um Erfassungspunktinformationen hinzuzufügen:
    1. Wählen Sie den EXEC CICS-Befehl aus, für den Sie einen Erfassungspunkt hinzufügen wollen, oder wählen Sie Programminitialisierung in der Liste Erfassungspunkt aus. Programminitialisierung ist ein Erfassungspunkt, der zum Start eines CICS-Programms gehört.
    2. Klicken Sie auf Erfassen vor oder Erfassen nach. Sie können angeben, dass der Erfassungspunkt vor oder nach bestimmten EXEC CICS-Befehlen liegt. Diese Option ist bei einer Reihe dieser EXEC CICS-Befehle inaktiviert.
  7. Klicken Sie auf die Registerkarte Filtern. Führen Sie die folgenden Schritte aus, wenn Sie Informationen zu Vergleichselementen für die Erfassung hinzufügen wollen:
    1. Optional: Definieren Sie den Anwendungskontext für Ihre Erfassungsspezifikation. Die für den ausgewählten Erfassungspunkt verfügbaren Anwendungskontext-Vergleichselemente werden angezeigt. Wählen Sie eine Option für Operator aus und stellen Sie einen Wert bereit, um die Vergleichselemente anzugeben. Ein Operator Alle gibt an, dass ein Filtern anhand des zugehörigen Vergleichselements nicht möglich ist. Werte für Transaktions-ID, Aktuelles Programm und Benutzer-ID sind in Großbuchstaben anzugeben.
    2. Optional: Definieren Sie Anwendungsoptionen für Ihre Erfassungsspezifikation. Die für den ausgewählten Erfassungspunkt verfügbaren Anwendungsoptionen werden angezeigt. Wählen Sie eine Option für Operator aus und stellen Sie einen Wert bereit, um die Vergleichselemente anzugeben. Ein Operator Alle gibt an, dass ein Filtern anhand des zugehörigen Vergleichselements nicht möglich ist.

      Anwendungsoptionen, die primäre Vergleichselemente sein können, sind mit einem Stern (*) markiert. Sie müssen Ist gleich als Operator auswählen und einen Wert für das primäre Vergleichselement angeben, um die CICS-Leistung aufrechtzuerhalten. Beispiel: Geben Sie für einen PUT CONTAINER-Erfassungspunkt einen Wert für die verfügbare Anwendungsoption CONTAINER* an.

    3. Optional: Definieren Sie Anwendungsdaten für Ihre Erfassungsspezifikation. Klicken Sie auf Hinzufügen, um ein Anwendungsdaten-Vergleichselement hinzuzufügen. Das Fenster Vergleichselement für Anwendungsdaten wird angezeigt.

      Wählen Sie eine Option für Operator aus und geben Sie einen Wert für Ihr Vergleichselement ein. Ein Operator Alle gibt an, dass ein Filtern anhand des zugehörigen Vergleichselements nicht möglich ist.

      Definieren Sie die Variable, die Sie mit dem Vergleichselement testen wollen. Sie können entweder auf "Auswahl aus der importierten Sprachstruktur treffen" klicken und die Anweisungen im Abschnitt Auswählen von Variablen aus importiertem Quellcode befolgen oder Sie können die Optionen für Position und Typ auswählen und Ihre Variable unter Verwendung der aktiven Felder in der Anzeige weiter definieren. Nur die Felder, die für den ausgewählten Typ benötigt werden, sind aktiv. Beispiel: Wenn Sie den Typ Zeichen auswählen, sind nur die Felder Versatz, Länge und Codepage aktiv.

  8. Klicken Sie auf die Registerkarte Informationsquellen. Führen Sie die folgenden Schritte für jede Informationsquelle in der Tabelle aus, um die Informationsquelle einem verfügbaren Datenelement zuzuordnen. Die Tabelle enthält möglicherweise keine Informationsquellen, wenn bei dem Ereignis keine Geschäftsdaten erfasst werden sollen.

    Sie müssen keine Daten erfassen, wenn dies nicht erforderlich ist.

    1. Klicken Sie doppelt auf eine Informationsquelle oder wählen Sie sie aus und klicken auf Bearbeiten. Das Fenster Ereignisinformationsquelle wird angezeigt.
    2. Wählen Sie ein verfügbares Datenelement unter Kontext, Datenwerte oder Daten variabler Länge aus. Wenn Sie ein Datenelement variable Länge auswählen, haben Sie folgende Möglichkeiten. Sie können entweder auf "Auswahl aus der importierten Sprachstruktur treffen" klicken und die Anweisungen im Abschnitt Auswählen von Variablen aus importiertem Quellcode befolgen oder Sie können die Optionen für Position und Typ auswählen und Ihre Variable unter Verwendung der aktiven Felder in der Anzeige weiter definieren. Nur die Felder, die für den ausgewählten Typ benötigt werden, sind aktiv. Beispiel: Wenn Sie den Typ Zeichen auswählen, sind nur die Felder Versatz, Länge und Codepage aktiv.

      Die Informationsquelle muss nicht dieselbe Länge haben wie das ausgegebene Geschäftsinformationselement. CICS füllt den Wert bei Bedarf auf oder kürzt ihn.

Ergebnisse

Sie haben eine Erfassungsspezifikation erstellt. Sie können Erfassungsspezifikationen auch entfernen, indem Sie auf Erfassungsspezifikation entfernen auf der Registerkarte Erfassungspunkt klicken und dann zur Bestätigung auf Ja klicken.