cciNodeCompletionCallback

Hier handelt es sich um eine Funktion, die als Callback registriert werden kann und dann aufgerufen wird, wenn ein Knoten mit dem Verarbeiten einer Nachricht fertig ist und die Kontrolle an den vorgelagerten Knoten übergibt. Sie 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 auf Grund einer nicht bearbeiteten Ausnahme abgeschlossen wurde, 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 wurde (einschließlich Bearbeiten einer Ausnahme beim Catch- oder Fehlerterminal) wird er mit reasonCode 'CCI_SUCCESS' zurückgegeben.
Anmerkung: 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)
Dies ist der Wert, der an die Funktion cciRegisterUserExit übergeben wurde.
message
Dies ist eine Kennung für das Nachrichtenobjekt, das weitergegeben wird. Der Benutzerexitcode darf diese Baumstruktur nicht aktualisieren.
localEnvironment
Dies ist eine Kennung für das Objekt der lokalen Umgebung, das weitergegeben wird.
exceptionList
Dies ist eine Kennung für das Ausnahmelistenobjekt, das weitergegeben wird.
environment
Dies ist eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
connection
Dies ist eine Kennung für das Verbindungsobjekt zwischen den beiden Knoten. Es kann beispielsweise in Aufrufen für cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName und cciGetTargetTerminalName verwendet werden. Diese Kennung ist nur während dieses Aufrufs der Benutzerexitfunktion gültig.
reasonCode
Hier wird angegeben, ob der Knoten normal (CCI_SUCCESS) oder auf Grund einer nicht bearbeiteten Ausnahme (CCI_EXCEPTION) beendet wurde. Wenn der Knoten auf Grund einer nicht bearbeiteten Ausnahme abgeschlossen wurde, können die Details dieser Ausnahme durch Aufrufen von cciGetLastExceptionData abgefragt werden. Wenn der Knoten normal abgeschlossen wurde (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 | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
as35940_