Angeben von EP-Adapter- und Dispatcherinformationen
Sie geben in Ihrer Ereignisbindung Informationen an, die steuern, wie CICS von der Ereignisbindung generierte Ereignisse ausgibt.
Informationen zu diesem Vorgang
Vorgehensweise
- Klicken Sie im Ereignisbindungseditor auf die Registerkarte Adapter
und wählen Sie die Option Einen hier definierten Adapter verwenden aus,
um die für diese Ereignisbindung zu verwendende EP-Adapterkonfiguration, die Parameter für den EP-Adapter und
eventuell erforderliche erweiterte Informationen anzugeben.
Sie können auch auswählen, ob Sie eine vordefinierte EPADAPTER-Ressource oder EPADAPTERSET-Ressource verwenden möchten. Weitere Informationen zu einer vordefinierten EPADAPTER-Ressource finden Sie im Abschnitt EP-Adapterkonfigurationseditor. Weitere Informationen zu einer vordefinierten EPADAPTERSET-Ressource finden Sie im Abschnitt EP-Adaptergruppeneditor.
Wenn Sie eine vordefinierte EPADAPTER- oder EPADAPTERSET-Ressource angeben, geben Sie den Namen im Feld Name an oder klicken Sie auf Auswählen, um eine Ressource auszuwählen. Weitere Informationen zum Auswählen von Adapterressourcen finden Sie in den Abschnitten Auswählen einer EP-Adapterressource und Auswählen einer EP-Adaptergruppenressource.
- Optional: Sie können eine oder mehr Ereignisspezifikationen in dieser Ereignisbindung exportieren.
- Wählen Sie den Typ des EP-Adapters in der Liste Adapter aus. Sie können folgende EP-Adaptertypen angeben:
- IBM® MQ Queue
- Gibt Ereignisse an eine IBM MQ-Nachrichtenwarteschlange im XML-Format zur Verarbeitung durch IBM Operational Decision Manager oder IBM Business Monitor oder in einem binären CICS Flattened Event(CFE)-Format zur direkten Verarbeitung durch IBM MQ aus.
- Für eine zuverlässige Ereignisausgabe und -zustellung kann der IBM MQ Queue-EP-Adapter mit der IBM MQ-Funktionalität für persistente Nachrichtenwarteschlangen kombiniert werden.
- Transaktionsstart
- Gibt Ereignisse in eine benannte CICS-Transaktion aus. Die Daten werden in einem containerbasierten Ereignisformat an die Transaktion übergeben. Sie können das CICS-System zum Ausführen der Transaktion angeben. Sie können eine vorhandene Transaktion verwenden, wenn die Ereignisdaten nicht erforderlich sind. Der EP-Adapter für den Transaktionsstart bietet keine Unterstützung für die zuverlässige Ausgabe von Ereignissen.
- Warteschlange für temporären Speicher
- Gibt Ereignisse an eine benannte CICS TS-Warteschlange in einem der folgenden XML-Formate aus: Common Base Event, Common Base Event REST, Decision Server Insights Event oder WebSphere Business Events. Die Ausgabe kann auch in einem anderen Format als XML (CFE) erfolgen. Verwenden Sie diesen EP-Adapter, um zu überprüfen, ob die richtigen Ereignisse mit den richtigen Daten erfasst werden, und um Ereignisse an einen Konsumenten auszugeben, der aus einer Warteschlange für temporären Speicher liest.
- Für eine zuverlässige Ereignisausgabe setzen synchrone transaktionsorientierte Ereignisse eine wiederherstellbare Warteschlange für temporären Speicher voraus; synchrone nicht transaktionsorientierte Ereignisse benötigen eine nicht wiederherstellbare Warteschlange. Ob Warteschlangen für temporären Speicher wiederherstellbar sind, hängt von den Einstellungen eines übereinstimmenden TSMODEL ab; Warteschlangen für temporären Speicher sind nur wiederherstellbar, wenn ein übereinstimmendes TSMODEL vorhanden ist. Wenn Sie den Adapter "Warteschlange für temporären Speicher" für synchrone transaktionsorientierte Ereignisse verwenden, können Sie keinen DELETEQ TS-Befehl für die Ereigniswarteschlange für temporären Speicher in der Arbeitseinheit aufrufen, die das Ereignis erfasst.
- TD Queue
- Gibt Ereignisse an eine benannte CICS-Warteschlange mit transienten Daten in einem der folgenden Formate aus: Common Base Event, Common Base Event REST, CICS Flattened Event (CFE), Decision Server Insights Event und WebSphere Business Event. Verwenden Sie beim Entwickeln und Testen von Ereignisspezifikationen diesen EP-Adapter, um zu überprüfen, ob die richtigen Ereignisse mit den richtigen Daten erfasst werden, und um Ereignisse an einen Konsumenten auszugeben, der aus einer Warteschlange mit transienten Daten liest.
- Bei einer synchronen Ereignisausgabe muss die TD-Warteschlange eine wiederherstellbare partitionsinterne Warteschlange für transaktionsorientierte Ereignisse und entweder eine nicht wiederherstellbare partitionsinterne Warteschlange oder eine partitionsübergreifende Warteschlange für nicht transaktionsorientierte Ereignisse sein. Der Adapter der Warteschlange mit transienten Daten kann zum Testen, für die Fehlerbehebung und für die Produktion verwendet werden.
- Benutzerdefiniert (vom Benutzer geschrieben)
- Gibt Ereignisse in einem beliebigen Format aus, das Sie benötigen. Ein benutzerdefinierter EP-Adapter ist ein CICS-Programm, das Sie schreiben, um eine Kombination aus Formatierung und Routing eines Ereignisses bereitzustellen, die nicht von den im Lieferumfang enthaltenen EP-Adaptern unterstützt wird. Der benutzerdefinierte EP-Adapter darf keine andere Verarbeitung ausführen, wie z. B. die Verarbeitung des Ereignisses.
- Für eine zuverlässige Ereignisausgabe muss der benutzerdefinierte EP-Adapter den Wiederherstellbarkeitsanforderungen des Ereignisses entsprechen. Prüfen Sie in der Dokumentation zu Ihrem benutzerdefinierten EP-Adapter, ob er transaktionsorientierte oder nicht transaktionsorientierte synchrone Ereignisse unterstützt.
- HTTP
- Gibt Ereignisse unter Verwendung von HTTP POST im XML-Format an einen HTTP 1.1-konformen Server aus, damit sie von Produkten wie z. B. IBM Operational Decision Manager oder IBM Business Monitor verarbeitet werden können. Der HTTP-EP-Adapter für den Transaktionsstart bietet keine Unterstützung für die zuverlässige Ausgabe von Transaktionsereignissen.
- Geben Sie die Optionen für den ausgewählten EP-Adaptertyp an:
- Geben Sie die folgenden Optionen für den IBM MQ Queue-EP-Adapter an:
- Geben Sie den Warteschlangennamen der IBM MQ-Warteschlange an, in die Ereignisse eingereiht werden, die von dieser Ereignisbindung ausgegeben wurden. Sie müssen einen Warteschlangennamen angeben.
- Geben Sie an, ob Nachrichten persistent sind. Wählen Sie einen der folgenden Werte in der Liste Persistent aus.
- Nein
- Nachrichten, die vom IBM MQ Queue-EP-Adapter in die Warteschlange eingereiht werden, sind nicht persistent.
- Ja
- Nachrichten, die vom IBM MQ Queue-EP-Adapter in die Warteschlange eingereiht werden, sind persistent.
- Warteschlangenstandardwert
- In die Warteschlange eingereihte Nachrichten übernehmen die Standardpersistenz der benannten Warteschlange.
- Geben Sie die Nachrichtenpriorität an. Sie können entweder Warteschlangenstandardwert auswählen oder für die IBM MQ-Nachrichtenpriorität einen Wert von 0 bis 9 im Feld Priorität eingeben.
- Geben Sie die Ablaufzeit ein. Sie können entweder Nie ablaufen auswählen oder einen Wert für das Ablaufen der IBM MQ-Nachrichten im Feld Ablaufzeit eingeben. Diese Zeit wird in Zehntelsekunden ausgedrückt. Eine Nachricht kommt dann für das Löschen infrage, wenn sie vor Ablauf dieser Frist nicht aus der Zielwarteschlange entfernt wurde.
- Geben Sie ein Datenformat für das Ereignis an. Wählen Sie einen der folgenden Werte aus der
Liste Datenformat aus:
- CICS Flattened Event (binär)
- Die Ereignisdaten liegen in einem anderen Format als XML vor.
- Common Base Event (XML)
- Die Nachrichten werden in dem Common Base Event-Format in die Warteschlange eingereiht, das für IBM Business Monitor erforderlich ist.
- WebSphere Business Events (XML)
- Die Nachrichten werden in dem XML-Format in die Warteschlange eingereiht, das für Decision Server Events-Komponente von IBM Operational Decision Manager erforderlich ist.
- Decision Server Insights Event (XML)
- Die Nachrichten werden in dem XML-Format in die Warteschlange eingereiht, das für Decision Server Insights-Komponente von IBM Operational Decision Manager erforderlich ist. Die Ereignisdaten liegen im XML-Format vor.
- Geben Sie die folgenden Optionen für den EP-Adapter für den Transaktionsstart
an:
- Geben Sie die Transaktions-ID der CICS-Anwendung an, die als ein Ergebnis der Ereignisse ausgeführt wird. Sie müssen eine Transaktions-ID angeben.
- Geben Sie eine Transaktions-Benutzer-ID an. Die Transaktion, die vom EP-Adapter für den Transaktionsstart gestartet wird, wird unter Verwendung dieser Benutzer-ID ausgeführt.
- Geben Sie die System-ID an, die nur für den Transaktions-EP-Adapter verfügbar ist. Die EP-Adaptertransaktion wird auf dem CICS-System mit dieser System-ID ausgeführt.
- Geben Sie die folgenden Optionen für den EP-Adapter der Warteschlange mit temporärem Speicher
an:
- Geben Sie den Namen der CICS-Warteschlange an. Sie müssen einen Warteschlangennamen angeben.
- Wenn Ihre Zielwarteschlange eine ferne Warteschlange ist, geben Sie die System-ID an.
- Wählen Sie bei Bedarf die Option Temporären Hilfsspeicher verwenden aus.
- Geben Sie ein Datenformat für das Ereignis an. Wählen Sie einen der folgenden Werte aus der
Liste Datenformat aus:
- CICS Flattened Event (binär)
- Die Ereignisdaten liegen in einem anderen Format als XML vor.
- Common Base Event (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- Common Base Event-REST (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- WebSphere Business Events (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- Decision Server Insights Event (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- Geben Sie die folgenden Optionen für den EP-Adapter der Warteschlange mit transienten Daten
an:
- Geben Sie den Namen der CICS-Warteschlange an. Sie müssen einen Warteschlangennamen angeben.
- Wenn Ihre Zielwarteschlange eine ferne Warteschlange ist, geben Sie die System-ID an.
- Geben Sie ein Datenformat für das Ereignis an. Wählen Sie einen der folgenden Werte aus der
Liste Datenformat aus:
- CICS Flattened Event (binär)
- Die Ereignisdaten liegen in einem anderen Format als XML vor.
- Common Base Event (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- Common Base Event-REST (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- WebSphere Business Events (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- Decision Server Insights Event (XML)
- Die Ereignisdaten liegen im XML-Format vor.
- Geben Sie die folgenden Optionen für einen angepassten (benutzerdefinierten) EP-Adapter an:
- Machen Sie eine der folgenden Angaben:
- Beim asynchronen Ausgabemodus: die Transaktions-ID Ihrer benutzerdefinierten CICS-Anwendung, die das Ereignis formatiert, weiterleitet und ausgibt. Sie müssen eine Transaktions-ID für die asynchrone Ausgabe durch den angepassten EP-Adapter angeben.
- Beim synchronen Ausgabemodus: den Namen Ihres benutzerdefinierten CICS-Anwendungsprogramms, das das Ereignis formatiert, weiterleitet und ausgibt. Sie müssen eine Programm-ID für die synchrone Ausgabe durch den angepassten EP-Adapter angeben.
- Schreiben Sie die zu übergebenden Daten in den angepassten EP-Adapter. Der angepasste EP-Adapter verarbeitet diese Daten.
- Machen Sie eine der folgenden Angaben:
- Geben Sie die folgenden Optionen für den HTTP-EP-Adapter an:
- Geben Sie eine Ressource der Kategorie 'URIMAP' an. Dies ist der Name einer URIMAP-Ressource, die die Verbindung zu dem HTTP 1.1-konformen Server darstellt.
- Geben Sie ein Datenformat für das Ereignis an. Wählen Sie einen der folgenden Werte aus der
Liste Datenformat aus:
- Common Base Event (XML)
- Die Ereignisse werden an einen HTTP 1.1-konformen Server gesendet, und zwar in dem Common Base Event-Format, das von jedem Produkt verarbeitet werden kann, das Common Event Infrastructure unterstützt.
- Common Base Event-REST (XML)
- Die Ereignisse werden an einen HTTP 1.1-konformen Server gesendet, und zwar in dem XML-Format, das für IBM Business Monitor erforderlich ist.
- WebSphere Business Events (XML)
- Die Ereignisse werden an einen HTTP 1.1-konformen Server gesendet, und zwar in dem XML-Format, das für Decision Server Events-Komponente von IBM Operational Decision Manager erforderlich ist.
- Decision Server Insights Event (XML)
- Die Ereignisse werden in dem XML-Format an einen HTTP 1.1-konformen Server gesendet, das für Decision Server Insights-Komponente von IBM Operational Decision Manager erforderlich ist.
- Geben Sie die folgenden Optionen für den IBM MQ Queue-EP-Adapter an:
- Optional: Geben Sie alle erforderlichen erweiterten Dispatcheroptionen an. Diese Optionen richten sich an fortgeschrittene Benutzer und steuern, wie der EP-Adapter
in einem CICS-System ausgeführt wird.
Anmerkung: Es ist normalerweise effizienter, wenn CICS den EP-Adapter unter dem Dispatcher-Thread ausführt. Es kann jedoch sein, dass der EP-Adapter als separate Transaktion ausgeführt werden muss. Beispielsweise wenn Sie ihn unter einer bestimmten Benutzer-ID ausführen müssen, die über eine Schreibberechtigung für die IBM MQ-Warteschlange verfügt, oder wenn Sie die Anzahl der gleichzeitig ausgeführten EP-Adaptertasks unter Verwendung der TRANCLASS-Einstellungen steuern möchten.
- Geben Sie den Ausgabemodus an. Sie können ASYNC oder SYNC angeben, um festzulegen,
wie Ereignisse ausgegeben werden sollen. Geben Sie den synchronen Ausgabemodus
für eine zuverlässige Ereignisausgabe an.
Beim synchronen Ausgabemodus gibt der IBM MQ Queue-EP-Adapter folgende Ereignisse aus:
- Transaktionsorientierte Ereignisse unter Verwendung der Option MQPMO_SYNCPOINT. IBM MQ-Nachrichten können in der Arbeitseinheit für die Erfassungstransaktion wiederhergestellt werden.
- Nicht transaktionsorientierte Ereignisse unter Verwendung der Option MQPMO_NO_SYNCPOINT.
Beim asynchronen Ausgabemodus gibt der IBM MQ Queue-EP-Adapter die Ereignisse unter Verwendung der Option MQPMO_NO_SYNCPOINT aus.
Hinweise:- Bei synchronen Ereignissen (zuverlässige Ereignisausgabe) benötigt die Anwendung, die die Ereignisse erfasst, eine Schreibberechtigung für den Ereignisausgabetransport. Bei asynchronen Ereignissen benötigt der EP-Adapter die Schreibberechtigung.
- Durch Angabe von NONTRANS für den HTTP-EP-Adapter wird die Erfassungstransaktion in eine Webanwendung umgewandelt, die möglicherweise entsprechend rekonfiguriert werden muss.
- Legen Sie das DTIMOUT-Attribut der Transaktionsdefinition für jede Transaktion fest, die potenziell synchrone Ereignisse durch den HTTP-EP-Adapter ausgeben könnte.
- Geben Sie die Zuteilungspriorität an. Sie können für die Priorität Normal oder Hoch angeben,
um zu steuern, wie der Ereignisdispatcher die Ereignisse verarbeitet, die zu dieser Ereignisbindung gehören. Ereignisse mit hoher Priorität werden ausgegeben, sobald sie abhängig von der Einstellung von
Ereignisse sind transaktionsorientiert verfügbar sind.
Ereignisse mit normaler Priorität werden ausgegeben, sobald sie abhängig von der Einstellung von
Ereignisse sind transaktionsorientiert verfügbar sind,
aber erst nach eventuell ausstehenden Ereignissen hoher Priorität.
Anmerkung: Diese Option gilt nicht für den synchronen Ausgabemodus.
- Geben Sie die Transaktions-ID und die Benutzer-ID an. Der Adapter wird mit der angegebenen Transaktions-ID und Benutzer-ID initialisiert. Die Transaktions-ID ist nicht für den angepassten EP-Adaptertyp relevant,
da die Einstellung stattdessen im Abschnitt "Adapter" erfolgt. Abhängig von den Einstellungen der Transaktions-ID und Benutzer-ID
wird die EP-Dispatcher-Task entweder gestartet oder stellt eine
Verbindung zum EP-Adapterprogramm her.
Wenn sich die IBM MQ-Warteschlange, die Warteschlange mit transienten Daten, die Warteschlange mit temporärem Speicher oder die Transaktion, die Sie starten möchten, auf einem fernen System befindet, finden Sie unter Sicherheit für übergreifende Kommunikation Informationen zu den entsprechenden Sicherheitseinstellungen.
Tabelle 1. Transaktions-ID und Benutzer-ID für den IBM MQ Queue-EP-Adapter, den EP-Adapter der Warteschlange mit transienten Daten, den EP-Adapter der Warteschlange mit temporärem Speicher und den EP-Adapter für den Transaktionsstart Transaktions-ID ist angegeben Benutzer-ID ist angegeben Kontext-Benutzer-ID verwenden EP-Adapter ist EP-Adapter wird ausgeführt mit EP-Adapter-Transaktions-ID ist x x Angeschlossen Angegebene Benutzer-ID Angegebene Transaktions-ID x x Angeschlossen Kontext-Benutzer-ID Angegebene Transaktions-ID x Angeschlossen Angegebene Benutzer-ID CEPQ für den IBM MQ Queue-EP-Adapter CEPR für den EP-Adapter der Warteschlange mit transienten Daten
CEPT für EP-Adapter der Warteschlange mit temporärem Speicher
CEPS für EP-Adapter für den Transaktionsstartx Angeschlossen Kontext-Benutzer-ID CEPQ für den IBM MQ-EP-Adapter CEPR für den EP-Adapter der Warteschlange mit transienten Daten
CEPT für EP-Adapter der Warteschlange mit temporärem Speicher
CEPS für EP-Adapter für den Transaktionsstartx Angeschlossen CICS-Standard-Benutzer-ID Angegebene Transaktions-ID Verbunden Benutzer-ID der CICS-Region Nicht zutreffend Tabelle 2. Transaktions-ID und Benutzer-ID für HTTP-EP-Adapter Transaktions-ID ist angegeben Benutzer-ID ist angegeben Kontext-Benutzer-ID verwenden EP-Adapter ist EP-Adapter wird ausgeführt mit Transaktions-ID des EP-Adapters ist x x Angeschlossen Angegebene Benutzer-ID Angegebene Transaktions-ID x x Angeschlossen Kontext-Benutzer-ID Angegebene Transaktions-ID x Angeschlossen Angegebene Benutzer-ID CEPH x Angeschlossen Kontext-Benutzer-ID CEPH x Angeschlossen CICS-Standard-Benutzer-ID Angegebene Transaktions-ID Angeschlossen CICS-Standard-Benutzer-ID CEPH Beim angepassten (benutzerdefinierten) EP-Adapter, der über eine Transaktions-ID und einen asynchronen Ausgabemodus verfügt, stellt die EP-Dispatcher-Task immer eine Verbindung zu diesem Adapter her - mit der angegebenen Benutzer-ID, der Kontext-Benutzer-ID oder der CICS-Standard-Benutzer-ID.Anmerkung: Diese zwei Optionen gelten nicht für den synchronen Emissionsmodus. - Geben Sie an, ob die Ereignisse transaktionsorientiert sind. Wählen Sie das Kontrollkästchen Ereignisse sind transaktionsorientiert
aus, wenn CICS Ereignisse nur dann erfassen soll,
wenn die dem Ereignis zugeordnete, geschäftsbezogene Arbeitseinheit (Unit of Work, UOW)
erfolgreich ausgeführt wird.
Anmerkung: Prüfen Sie sorgfältig, ob Ereignisse, die aus nicht wiederherstellbaren Aktionen erfasst werden, als transaktionsorientiert angegeben werden sollen. Beispiel: Wenn Sie ein transaktionsorientiertes Ereignis aus einem Befehl WEB SEND erfassen und die Arbeitseinheit wird zurückgesetzt, wird zwar das Ereignis zurückgesetzt, aber der Befehl WEB SEND hat unter Umständen bewirkt, dass eine HTTP-Nachricht gesendet wurde.
Inaktivieren Sie das Kontrollkästchen Ereignisse sind transaktionsorientiert, wenn CICS die Ereignisse, die zu dieser Ereignisbindung gehören, außerhalb einer Transaktion verarbeiten soll. Ereignisse werden bei ihrer Generierung ausgegeben.
- Geben Sie den Ausgabemodus an. Sie können ASYNC oder SYNC angeben, um festzulegen,
wie Ereignisse ausgegeben werden sollen. Geben Sie den synchronen Ausgabemodus
für eine zuverlässige Ereignisausgabe an.
Beim synchronen Ausgabemodus gibt der IBM MQ Queue-EP-Adapter folgende Ereignisse aus: