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 Feld iFpNodeCompletionCallback des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wird.

Wenn der Knoten aufgrund einer nicht behandelten Ausnahme beendet wird, wird er mit dem Ursachencode (reasonCode) CCI_EXCEPTION zurückgegeben, und die Einzelangaben zu der Ausnahmebedingung können durch Aufruf von cciGetLastExceptionData abgefragt werden.

Wenn der Knoten normal beendet wird (einschließlich Verarbeitung einer Ausnahmebedingung am Catch- oder Fehlerterminal) wird er mit einem Ursachencode (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 Änderungen, die am Eingabestammelement im Knoten vorgenommen werden.
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), 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){
…
…
}
Zugehörige Konzepte
Benutzerexits
Zugehörige Tasks
Benutzerexit entwickeln
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:30:03

as35940_