cciInputMessageCallback

Hier handelt es sich um eine Funktion, die als Callback registriert werden kann und dann aufgerufen wird, wenn eine Nachricht von einem Empfangsknoten gelesen und bevor die Nachricht im Nachrichtenfluss weitergegeben wird. Sie wird für jede Eingabenachricht aufgerufen, die innerhalb der Ausführungsgruppe, in welcher der Callback registriert wurde, gelesen wird, wenn der Benutzerexitstatus aktiv ist. Der Callback wird registriert, indem ein Zeiger auf die Funktion als iFpInputMessageCallback-Feld des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wurde.

Syntax

typedef void (*cciInputMessageCallback)     ( 
                                 CciDataContext*  userContext,
                                 CciMessage*        message,
                                 CciMessage*      localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage*      environment,
                                 CciMessageOrigin messageOrigin,
                                 CciNode*         inputNode);

Parameter

userContext (Eingabe)
Dies ist der Wert, der an die Funktion cciRegisterUserExit übergeben wurde.
message
Dies ist eine Kennung für das Nachrichtenobjekt. Der Benutzerexitcode darf diese Baumstruktur nicht aktualisieren.
localEnvironment
Dies ist eine Kennung für das Objekt der lokalen Umgebung.
exceptionList
Dies ist eine Kennung für das Ausnahmelistenobjekt.
environment
Dies ist eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
messageOrigin
Abhängig vom Typ des Empfangsknotens stammt die Nachricht möglicherweise von einem Bitstrom (CCI_MESSAGE_ORIGIN_BITSTREAM) oder einer Baumstruktur (CCI_MESSAGE_ORIGIN_TREE). Der Benutzerexit kann deshalb auf einen davon zugreifen, ohne eine Verarbeitung durch den Parser auszulösen. Beispiel: Im Fall des MQEmpfangknotens können Sie sicher auf den Bitstrom zugreifen und im Fall des JMS-Empfangsknotens sicher auf die Baumstruktur. Auf den Bitstrom kann durch Aufrufen von cniBufferPointer, cniBufferSize oder cniBufferByte zugegriffen werden. Auf die Baumstruktur kann durch Aufrufen von cniRootElement und unter Verwendung der herkömmlichen Syntaxelementnavigationsfunktionen (z. B. cniFirstChild) zugegriffen werden.
Anmerkung: Obwohl dieser Parameter den Benutzerexit darauf hinweist, auf was sicher zugegriffen werden kann, ohne eine Verarbeitung durch den Parser auszulösen, ist es möglich, dass der Code des Benutzerexits diesen Hinweis ignoriert und die Parse-Ablaufsteuerung effektiv ändert.
inputNode
Dies ist eine Kennung für den Empfangsknoten, der diese Eingabenachricht liest. Sie kann zur Durchführung von Aufrufen von Funktionen wie z. B. cciGetNodeName, cciGetNodeType und cniGetBrokerInfo verwendet werden.

Rückgabewerte

Keine.

Beispiel

void myInputMessageCallback(
                      CciDataContext*  userContext,
                      CciMessage*        message,
                      CciMessage*      localEnvironment,
                      CciMessage* exceptionList,
                      CciMessage*      environment,
                      CciMessageOrigin messageOrigin,
                      CciNode*         inputNode){
…
…
}
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
as35950_