cciTransactionEventCallback

Hier handelt es sich um eine Funktion, die als Callback registriert werden kann und dann aufgerufen wird, wenn eine Nachrichtenflusstransaktion endet. Sie wird für jede Nachrichtflusstransaktion innerhalb der Ausführungsgruppe aufgerufen, in welcher der Callback registriert wurde, wenn der Benutzerexitstatus aktiv ist. Der Callback wird registriert, indem ein Zeiger auf die Funktion im Feld iFpTransactionEventCallback des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wurde.

Syntax

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

Parameter

userContext (Eingabe)
Dies ist der Wert, der an die Funktion cciRegisterUserExit übergeben wurde.
type
Dies beschreibt das aufgetretene Ereignis. Mögliche Werte:
  • CCI_TRANSACTION_EVENT_COMMIT

    Eine Transaktion wurde erfolgreich festgeschrieben.

  • CCI_TRANSACTION_EVENT_ROLLBACK

    Eine Transaktion wurde zurückgesetzt.

Wenn die Transaktion aufgrund einer nicht bearbeiteten Ausnahme zurückgesetzt wurde, können die Details dieser Ausnahme durch Aufrufen von cciGetLastExceptionData abgefragt werden.
environment
Dies ist eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss. Obwohl der Benutzerexit diese Baumstruktur aktualisieren kann, wird sie nach der Rückgabe von dieser Funktion behoben, d. h. jegliche Aktualisierungen gehen verloren.
inputNode
Dies ist eine Kennung für den Empfangsknoten, der diese Eingabenachricht liest, welche die Transaktion ausgelöst hat. Sie kann zur Durchführung von Aufrufen von Funktionen wie z. B. 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
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

as35960_