Benutzerexits nutzen

In diesem Abschnitt wird verdeutlicht, wie Ihre Nachrichtenflüsse von Benutzerexits profitieren können.

Lesen Sie doch zunächst den Abschnitt Benutzerexits.

Im folgenden angezeigten Diagramm wird der MQEmpfangsknoten als Beispiel verwendet, jedoch verfügen alle Empfangsknoten einschließlich benutzerdefinierter Knoten über diese Funktion.

Basisereignisse für Nachrichtenflüsse

Ereignis 1: Die Nachricht wird aus der Warteschlange der Eingabequelle genommen (wird in den Fluss eingelesen). Jedoch besteht bezüglich der Art und Weise, wie Benutzerexits aufgerufen werden, ein geringfügiger Unterschied zwischen integrierten Knoten und benutzerdefinierten Knoten. Bei integrierten Knoten wird der Benutzerexit aufgerufen, sobald die Daten aus der externen Quelle gelesen wurden. Bei benutzerdefinierten Knoten wird der Benutzerexit unmittelbar vor der Weitergabe der Nachricht durch den Knoten aufgerufen.

Ereignis 2: Die Nachricht wird an den Knoten zur Verarbeitung weitergegeben.

Ereignis 3: Die Verarbeitung im Knoten ist abgeschlossen.

Ereignis 4: Der Benutzerexit wird nach Abschluss der Transaktion aufgerufen, d. h., die Verarbeitung des Benutzerexits ist nicht Teil der Transaktion. Der Benutzerexit wird auch für den Fall aufgerufen, dass keine transaktionsorientierte Verarbeitung vom Fluss abgeschlossen wurde. Wenn für die Nachrichtenflusseigenschaft Festschreibungszähler ein Wert größer als 1 gesetzt wurde, besteht ein n:1-Verhältnis zwischen Ereignis 1 und Ereignis 4. Dieses Verhältnis gilt auch für Szenarios, die speziell für diesen bestimmten Empfangsknoten auftreten, z. B. wenn für einen MQEmpfangsknoten die Eigenschaft Festschreibung nach Nachrichtengruppe ausgewählt ist.

Mit Hilfe eines Benutzerexits kann eine beliebige Anzahl dieser Ereignisse überwacht werden. Für jedes dieser Ereignisse stehen dem Benutzerexit folgende Daten zur Verfügung. Falls nicht anders angegeben, besteht lediglich Lesezugriff.
  • Nachrichten aus Warteschlange entfernen:
    • Bitstrom
    • Empfangsknoten
    • Umgebungsbaumstruktur (Lese- und Schreibzugriff)
  • Nachricht wird an Knoten weitergegeben:
    • Nachrichtenbaumstruktur (Message)
    • Baumstruktur für lokale Umgebung (Lese-, Schreibzugriff)
    • Ausnahmeliste
    • Umgebungsbaumstruktur (Lese-, Schreibzugriff)
    • Ausgangsknoten
    • Zielknoten
  • Verarbeitung des Knotens abgeschlossen:
    • Nachrichtenbaumstruktur (Message)
    • Baumstruktur für lokale Umgebung (Lese- und Schreibzugriff)
    • Ausnahmeliste
    • Umgebungsbaumstruktur (Lese- und Schreibzugriff)
    • Knoten
    • Vorgelagerter Knoten
    • Ausnahme (falls vorhanden)
  • Ende der Transaktion:
    • Empfangsknoten
    • Ausnahme (falls vorhanden)
    • Umgebungsbaumstruktur (Lese- und Schreibzugriff)

Sie können mehrere Benutzerexits registrieren, die dann in einer definierten Reihenfolge aufgerufen werden (weitere Informationen finden Sie unter Befehl 'mqsichangeflowuserexits'). Wenn ein Benutzerexit Änderungen an einer Nachrichtenassembly vornimmt, sind diese Änderungen für die folgenden Benutzerexits sichtbar.

Beim Aufruf eines Benutzerexits können folgende Informationen abgefragt werden:
  • Nachrichtenflussdaten:
    • Nachrichtenflussname
    • Brokername
    • Warteschlangenmanager des Brokers
    • Name der Ausführungsgruppe
    • Eigenschaft 'Festschreibungszähler' des Nachrichtenflusses
    • Eigenschaft 'Festschreibungsintervall' des Nachrichtenflusses
    • Eigenschaft 'Koordinierte Transaktion' des Nachrichtenflusses
  • Knotendaten:
    • Knotenname
    • Knotentyp
    • Terminalname
    • Knoteneigenschaften
Der Knoten kann auch folgende Tasks ausführen:
  • In der Nachrichtenassembly navigieren und lesen (Message,LocalEnvironment,ExceptionList)
  • In der Umgebungsstruktur navigieren sowie lesen und schreiben.

Die Benutzerexits können auf dynamischer Basis registriert werden, d. h., die Konfiguration muss nicht erneut implementiert werden.

Zugehörige Konzepte
Benutzerexits
Zugehörige Tasks
Benutzerexit implementieren
Benutzerexit entwickeln
Zugehörige Verweise
Befehl 'mqsichangeflowuserexits'
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac02145_