cciNodeCompletionCallback

Hierbei handelt es sich um eine Funktion, die als Callback registriert werden kann und aufgerufen wird, sobald ein Knoten die Verarbeitung einer Nachricht abgeschlossen hat und die Steuerung wieder an seinen vorgeschalteten Knoten übergibt. Wenn der Benutzerexitstatus aktiv ist, wird sie für jede Nachricht aufgerufen, die innerhalb der Ausführungsgruppe weitergegeben wird, in der der Callback registriert wurde. Der Callback wird durch die Bereitstellung eines Zeigers auf die Funktion als Feld iFpNodeCompletionCallback des CCI_UE_VFT-Structs registriert, das an cciRegisterUserExit übergeben wird.

Wenn der Knoten auf Grund einer nicht verarbeiteten Ausnahmebedingung beendet wurde, kehrt er mit dem Ursachencode (reasonCode) CCI_EXCEPTION zurück, und die Einzelangaben zu dieser Ausnahmebedingung können durch den Aufruf von cciGetLastExceptionData bezogen werden.

Wenn der Knoten normal beendet wurde (mit einer Verarbeitung einer Ausnahmebedingung am Catch- oder Fehlerterminal), kehrt er mit dem Ursachencode (reasonCode) CCI_SUCCESS zurück.
Anmerkung: In diesem Fall liefert der Aufruf von cciGetLastExceptionData unvorhersehbare Ergebnisse.

Syntax

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

Parameter

userContext (Eingabe)
Hierbei handelt es sich um einen Wert, der an die Funktion cciRegisterUserExit übergeben wurde.
message
Dies ist eine interne Kennung für das weitergegebene Nachrichtenobjekt. Der Benutzerexitcode darf diese Baumstruktur nicht aktualisieren.
localEnvironment
Dies ist eine interne Kennung für das weitergegebene Objekt der lokalen Umgebung.
exceptionList
Dies ist eine interne Kennung für das weitergegebene Ausnahmelistenobjekt.
environment
Dies ist eine interne Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
connection
Die interne Kennung für das Verbindungsobjekt zwischen den beiden Knoten. Sie kann beispielsweise in Aufrufen von cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName und cciGetTargetTerminalName verwendet werden. Diese interne Kennung ist nur für die Dauer dieses Aufrufs der Benutzerexitfunktion gültig.
reasonCode
Gibt an, ob der Knoten normal (CCI_SUCCESS) oder auf Grund einer nicht verarbeiteten Ausnahmebedingung (CCI_EXCEPTION) beendet wurde. Wenn der Knoten auf Grund einer nicht verarbeiteten Ausnahmebedingung beendet wurde, können die Einzelangaben zu dieser Ausnahmebedingung durch den Aufruf von cciGetLastExceptionData bezogen werden. Wenn der Knoten normal beendet wurde (mit einer Verarbeitung einer Ausnahmebedingung am Catch- oder Fehlerterminal), ist die Auswirkung des Aufrufs 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 entwickeln
Zugehörige Tasks
Benutzerexit entwickeln
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as35940_