WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cciInputMessageCallback

Die Funktion 'cciInputMessageCallback' kann als Callback registriert werden und wird dann aufgerufen, wenn eine Nachricht von einem Input-Knoten gelesen und bevor die Nachricht im Nachrichtenfluss weitergegeben wird.

Die Funktion 'cciInputMessageCallback' wird für jede Eingabenachricht aufgerufen, die innerhalb einer Ausführungsgruppe gelesen wurde, in welcher der Callback registriert wurde, falls 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)
Der Wert, der an die Funktion cciRegisterUserExit übergeben wird.
message
Eine Kennung für das Nachrichtenobjekt. Der Benutzerexitcode darf die Transportheader oder Eigenschaftselemente in dieser Baumstruktur nicht aktualisieren. Durch eine Aktualisierung der Nachricht kann die Leistung beeinträchtigt werden. Dies gilt insbesondere, wenn die Eingabenachricht ansonsten im Nachrichtenfluss nicht geändert werden würde.
localEnvironment
Eine Kennung für das Objekt der lokalen Umgebung.
exceptionList
Eine Kennung für das Ausnahmelistenobjekt.
environment
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 auf eine dieser Quellen zugreifen, ohne eine Verarbeitung durch den Parser auszulösen. Sie können beispielsweise beim MQInput-Knoten sicher auf den Bitstrom zugreifen, während Sie beim JMSInput-Knoten sicher auf die Baumstruktur zugreifen können. Sie können durch Aufrufen von cniBufferPointer, cniBufferSize oder cniBufferByte auf den Bitstrom zugreifen. Sie können durch Aufrufen von cniRootElement und unter Verwendung der herkömmlichen Syntaxelementnavigationsfunktionen (z. B. cniFirstChild) auf die Baumstruktur zugreifen. Obwohl dieser Parameter dem Benutzerexit meldet, auf welche Komponenten sicher zugegriffen werden kann, ohne eine Verarbeitung durch den Parser auszulösen, kann der Benutzerexitcode diesen Hinweis ignorieren und den Zeitpunkt der Syntaxanalyse effektiv ändern.
inputNode
Eine Kennung für den Empfangsknoten, der diese Eingabenachricht liest. Die Kennung 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){
…
…
}
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:08


ReferenzthemaReferenzthema | Version 8.0.0.5 | as35950_