WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cciNodeCompletionCallback

Die Funktion 'cciNodeCompletionCallback' kann als Callback registriert werden und wird aufgerufen, wenn ein Knoten mit dem Verarbeiten einer Nachricht fertig ist und die Steuerung an den vorgelagerten Knoten übergibt.

Die Funktion 'cciNodeCompletionCallback' wird für jede Nachricht aufgerufen, die innerhalb der Ausführungsgruppe, in welcher der Callback registriert wurde, weitergegeben wird, wenn der Benutzerexitstatus aktiv ist. Der Callback wird registriert, indem ein Zeiger auf die Funktion als iFpNodeCompletionCallback-Feld des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wurde.

Wenn der Knoten aufgrund einer nicht bearbeiteten Ausnahme abgeschlossen wird, wird er mit reasonCode von 'CCI_EXCEPTION' zurückgegeben, und die Details dieser Ausnahme können durch Aufrufen von cciGetLastExceptionData abgefragt werden.

Wenn der Knoten normal abgeschlossen wird (einschließlich Bearbeiten einer Ausnahme beim Catch- oder Fehlerterminal (Failure)), wird er mit reasonCode 'CCI_SUCCESS' zurückgegeben. In diesem Fall gibt das Aufrufen von cciGetLastExceptionData unvorhersehbare Ergebnisse zurück.

Syntax

typedef void (*cciNodeCompletionCallback)   (
                                 CciDataContext* userContext,
                                 CciMessage*        message,
                                 CciMessage*     localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage*     environment,
                                 CciConnection*  connection,
                                 int             reasonCode);

Parameter

userContext (Eingabe)
Der Wert, der an die Funktion cciRegisterUserExit übergeben wird.
message
Eine Kennung für das aktuelle Nachrichtenobjekt. Die aktuelle Nachricht ist die Nachricht, die an den Knoten weitergegeben wird, plus eine oder mehrere der folgenden Änderungen:
  • Änderungen, die am Eingabestammelement im Knoten vorgenommen werden
  • Änderungen, die während des vorherigen Weitergabe-Callbacks über einen Benutzerexit vorgenommen werden
  • Änderungen, die während des vollständigen Callbacks des nachgeordneten Knotens über einen Benutzerexit vorgenommen werden; z. B. Output-Knoten, Compute-Knoten mit einem Rechenmodus, der auf Locale Umgebung, Ausnahme oder Ausnahme und lokale Umgebung gesetzt ist oder Request-Knoten mit einer Position für Ausgabedaten, die auf Lokale Umgebung gesetzt ist.

Der Benutzerexitcode darf die Transportheader oder Eigenschaftselemente in der Nachrichtenbaumstruktur nicht aktualisieren. Die Aktualisierung der Nachricht kann die Leistung beeinträchtigen. Änderungen, die während dieses Callbacks vorgenommen werden, sind nur sichtbar, wenn der vorgeschaltete Knoten nicht veranlasst, dass eine neue Nachricht erstellt wird.

localEnvironment
Eine Kennung für das Objekt der lokalen Umgebung, das weitergegeben wird.
exceptionList
Eine Kennung für das Objekt der Ausnahmeliste, das weitergegeben wird.
environment
Eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
connection
Eine Kennung für das Verbindungsobjekt zwischen den beiden Knoten. Die Kennung kann beispielsweise in Aufrufen für cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName und cciGetTargetTerminalName verwendet werden. Diese Kennung ist nur für die Dauer dieser Instanz der Benutzerexitfunktion gültig.
reasonCode
Ein Ursachencode, der anzeigt, ob der Knoten normal (CCI_SUCCESS) oder aufgrund einer nicht bearbeiteten Ausnahme (CCI_EXCEPTION) beendet wird. Wenn der Knoten aufgrund einer nicht bearbeiteten Ausnahme abgeschlossen wird, können Sie die Details dieser Ausnahme durch das Aufrufen von cciGetLastExceptionData abfragen. Wenn der Knoten normal abgeschlossen wird (einschließlich Bearbeiten einer Ausnahme beim Catch- oder Fehlerterminal (Failure)), ist die Auswirkung des Aufrufens von cciGetLastExceptionData ungewiss.

Rückgabewerte

Keine.

Beispiel

void myNodeCompletionCallback(
                                 CciDataContext* userContext,
                                 CciMessage*        message,
                                 CciMessage*     localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage*     environment,
                                 CciConnection*  connection
                                 int             reasonCode){
…
…
}
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:08


ReferenzthemaReferenzthema | Version 8.0.0.5 | as35940_