cciTransactionEventCallback

Hierbei handelt es sich um eine Funktion, die als Callback registriert werden kann und aufgerufen wird, sobald eine Transaktion des Nachrichtenflusses beendet wird. Wenn der Benutzerexitstatus aktiv ist, wird sie für jede Transaktion des Nachrichtenflusses innerhalb der Ausführungsgruppe aufgerufen, in der der Callback registriert wurde. Der Callback wird durch die Bereitstellung eines Zeigers auf die Funktion im Feld iFpTransactionEventCallback des CCI_UE_VFT-Structs registriert, das an cciRegisterUserExit übergeben wird.

Syntax

typedef void (*cciTransactionEventCallback) (
                                 CciDataContext* userContext,
                                 CciTransactionEventType type,
                                 CciMessage* environment,
                                 CciNode* inputNode);

Parameter

userContext (Eingabe)
Hierbei handelt es sich um einen Wert, der an die Funktion cciRegisterUserExit übergeben wurde.
type
Beschreibt das aufgetretene Ereignis. Mögliche Werte:
  • CCI_TRANSACTION_EVENT_COMMIT

    Eine Transaktion wurde erfolgreich festgeschrieben.

  • CCI_TRANSACTION_EVENT_ROLLBACK

    Eine Transaktion wurde rückgängig gemacht.

Wenn die Transaktion auf Grund einer nicht verarbeiteten Ausnahmebedingung rückgängig gemacht wurde, können die Einzelangaben zu dieser Ausnahmebedingung durch den Aufruf von cciGetLastExceptionData bezogen werden.
environment
Dies ist eine interne Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss. Diese Baumstruktur kann zwar vom Benutzerexit aktualisiert werden, ihr Inhalt wird jedoch nach der Rückkehr aus dieser Funktion gelöscht, so dass alle Aktualisierungen verloren gehen.
inputNode
Dies ist eine interne Kennung für den Empfangsknoten, der die Eingabenachricht liest, durch die die Transaktion ausgelöst wurde. Sie kann für Aufrufe von Funktionen wie beispielsweise cciGetNodeName, cciGetNodeType und cniGetBrokerInfo verwendet werden.

Rückgabewerte

None (Keinen)

Beispiel

void myTransactionEventCallback(
                     CciDataContext* userContext,
                     CciTransactionEventType type,
                     CciMessage* environment,
                     CciNode* inputNode){
…
…
}
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
as35960_