Exportieren von Ereignisspezifikationen aus einer Richtlinie

Wenn eine Richtlinienregelaktion ein Ereignis ausgeben soll, können Sie Ereignisspezifikationen für dieses Ereignis als Schema oder Copybook exportieren, um sie woanders zu verwenden.

Vorbereitende Schritte

Es muss eine CICS-Regel, deren Regelaktion als Ereignis ausgeben definiert ist, vorhanden sein. Die Anweisungen finden Sie im Abschnitt Erstellen und Bereitstellen einer Richtlinie in einem CICS-Bundleprojekt.

Informationen zu diesem Vorgang

Die exportierten Dateien enthalten das Format der Ereignisdaten. Dies ist hilfreich für die Verarbeitung der erfassten Daten mit Ihren Programmen oder Datenverarbeitungsengines.

Das Datenformat, das von Ihrem ausgewählten Ereignisverarbeitungsadapter oder von einem Ereignisverarbeitungsadapter in Ihrer ausgewählten Ereignisverarbeitungsadaptergruppe angegeben wird, bestimmt, ob es sich bei der exportierten Datei um ein Schema oder um ein Copybook handelt:
  • Bei einem XML-Format, wie z. B. Common Base Event, Common Base Event REST, Decision Server Insights Event oder WebSphere Business Events, ist die exportierte Datei eine XML-Schemadefinitionsdatei (.xsd). Die folgenden Adapter können Ereignisse im XML-Zeichenformat ausgeben:
    • HTTP-Adapter
    • Adapter für Warteschlange mit transienten Daten
    • Adapter für Warteschlange mit temporärem Speicher
    • IBM® MQ Queue-Adapter
  • Bei einem Nicht-XML-Format, wie z. B. dem CICS Flattened Event-Format, ist die exportierte Datei eine COBOL-Copybook-Datei (.cpy). Die folgenden Adapter können Ereignisse im CICS Flattened Event-Format ausgeben:
    • Adapter für Warteschlange mit transienten Daten
    • Adapter für Warteschlange mit temporärem Speicher
    • IBM MQ Queue-Adapter
Anmerkung: Sie können keine Ereignisspezifikationen für einen Transaktionsstartadapter oder einen angepassten Adapter exportieren.

Vorgehensweise

  1. Navigieren Sie auf der Registerkarte Regeln des Richtliniendefinitionseditors zum Abschnitt "Aktion".
    Registerkarte Aktion auf der Registerkarte Regeln des Richtliniendefinitionseditors
  2. Stellen Sie sicher, dass Ereignis ausgeben mit einem angegebenen EP-Adapter (Ereignisverarbeitungsadapter) oder einer angegebenen EP-Adaptergruppe ausgewählt ist.
  3. Klicken Sie auf Ereignisspezifikationen exportieren.
  4. In den folgenden Fällen werden Sie aufgefordert, einen Adapter oder eine Adaptergruppe auszuwählen:
    • In Ihrem Arbeitsbereich weisen mehrere Ereignisverarbeitungsadapter denselben Namen wie der angegebene Adapter oder ein Adapter in der angegebenen Ereignisverarbeitungsadaptergruppe auf.
      Das Fenster EP-Adapter wählen
    • In Ihrem Arbeitsbereich weisen mehrere Ereignisverarbeitungsadaptergruppen den angegebenen Adaptergruppennamen auf.
      Das Fenster EP-Adaptergruppe wählen
  5. Stellen Sie im Fenster Ereignisspezifikationen für Regel exportieren sicher, dass die korrekten Informationen in den entsprechenden Feldern angegeben sind: Das Fenster Ereignisspezifikationen für Regel exportieren
    Exportieren
    Die Richtlinienregel, für die Sie Ereignisspezifikationen exportieren möchten.
    In Verzeichnis
    Das lokale Verzeichnis, in dem die exportierten Ereignisspezifikationen gespeichert werden sollen.
    Datenformat

    Das in Ihrem Ereignisverarbeitungsadapter angegebene Datenformat oder der Ereignisverarbeitungsadapter in Ihrer Ereignisverarbeitungsadaptergruppe.

    Dieses Feld wird angezeigt, wenn CICS Explorer das Datenformat nicht bestimmen kann, da sich der Ereignisverarbeitungsadapter, die Ereignisverarbeitungsadaptergruppe oder ein Ereignisverarbeitungsadapter innerhalb der Ereignisverarbeitungsadaptergruppe nicht in Ihrem Arbeitsbereich befindet.

    Anmerkung: Stellen Sie sicher, dass die Datenformatinformationen mit den in Ihren Ereignisverarbeitungsadaptern angegebenen übereinstimmen. Andernfalls kann ein Fehler auftreten, wenn Sie die exportierten Dateien zur Datenverarbeitung verwenden.
    Version

    Die Version der CICS-Region, die das Ereignis ausgibt. Dabei handelt es sich um die Region, in der die Richtlinie implementiert wird.

    Dieses Feld wird angezeigt, wenn sich die Richtlinienregel auf CICS TS 5.3 und früher bezieht.

  6. Klicken Sie auf OK.
  7. Wenn im angegebenen Verzeichnis bereits eine exportierte Ereignisspezifikation mit demselben Namen vorhanden ist, werden Sie gefragt, ob die vorhandene Datei überschrieben oder der Export abgebrochen werden soll.

Ergebnisse

Eine oder mehr Dateien werden im angegebenen Verzeichnis für die Richtlinienregel erstellt. In den Beispielen in der folgenden Tabelle werden Dateien angezeigt, die für unterschiedliche Ereignisse ohne angegebene Ereignisnamen erstellt werden.

Wenn ein Ereignisname angegeben wurde, wird er als Präfix des exportierten Dateinamens verwendet. Wenn also im ersten Beispiel der Ereignisname event_name angegeben wurde, erhält die Ausgabedatei den Namen event_name_dsie_CICS_54.xsd. Die Anweisungen zum Definieren von Ereignisnamen finden Sie im Abschnitt Erstellen und Bereitstellen einer Richtlinie in einem CICS-Bundleprojekt.
Tabelle 1. Exportierte Ereignisspezifikationsdateien für verschiedene Ereignisse
Ereignisverarbeitungsadapter und Adaptergruppen Richtlinienregel Version Datenformat Exportierte Ereignisspezifikationen
IBM MQ Queue-Adapter Eine Systemregel für einen offenen Dateistatus V54 Das Decision Server Insights Event-Format (XML) Eine XML-Schemadatei mit dem Namen fileEnable_rule_dsie_CICS_54.xsd, die Sie im Tool IBM Operational Decision Manager Insight Designer zum Definieren eines Ereignisses verwenden können.
TD- oder TS-Queue-Adapter Eine Speicheranforderungstaskregel V51-53 Das Common Base Events REST-Format (XML) Eine XML-Schemadatei mit dem Namen cics_policy_event_payload_cbe_CICS_51-53.xsd die Sie in IBM Business Monitor importieren können, um ein eingehendes Ereignis zu definieren.
V54 Eine XML-Schemadatei mit dem Namen task_rules_payload_cbe_CICS_54.xsd, die Sie in IBM Business Monitor importieren können, um ein eingehendes Ereignis zu definieren.
IBM MQ Queue-Adapter Eine Systemregel für einen offenen Dateistatus V54 Das CICS Flattened Event-Format Ein COBOL-Copybook mit dem Namen DFHMPFEO_CICS_54.cpy, das Sie zum Verarbeiten von Daten in Ihren eigenen Ereigniskonsumentenprogrammen verwenden können.
Eine Ereignisverarbeitungsadaptergruppe, die Folgendes aufweist:
  • einen TD- oder TS-Queue-Adapter (CICS Flattened Event-Format)
  • einen IBM MQ Queue-Adapter (WebSphere Business Events-(XML)-Format)
Eine Systemregel für einen offenen Dateistatus V54

CICS Flattened Event-Format WebSphere Business Events-(XML)-Format

Zwei Dateien mit dem Namen DFHMPFEO_CICS_54.cpy bzw. fileEnable_rule_wbe_CICS_54.xsd, die Sie in Ihren Programmen und im Tool IBM Operational Decision Manager Event Designer verwenden können.