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 Feld iFpInputMessageCallback des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wird.

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 diese Baumstruktur nicht aktualisieren.
localEnvironment
Eine Kennung für das lokale Umgebungsobjekt.
exceptionList
Eine Kennung für das Ausnahmelistenobjekt.
environment
Eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
messageOrigin
Je nach Art des Empfangsknotens kann die Nachricht aus einem Bitstrom (CCI_MESSAGE_ORIGIN_BITSTREAM) oder aus einer Baumstruktur (CCI_MESSAGE_ORIGIN_TREE) stammen. Der Benutzerexit kann auf eine dieser Quellen zugreifen, ohne eine Verarbeitung durch den Parser auszulösen. So ist beispielsweise im Fall des MQInput-Knotens ein sicherer Zugriff auf den Bitstrom und im Fall des JMSInput-Knotens ein sicherer Zugriff auf die Baumstruktur möglich. Auf den Bitstrom kann durch Aufruf von cniBufferPointer, cniBufferSize oder cniBufferByte zugegriffen werden. Auf die Baumstruktur kann durch Aufruf von cniRootElement und unter Verwendung der herkömmlichen Syntaxelementnavigationsfunktionen (z. B. cniFirstChild) zugegriffen werden. Zwar weist dieser Parameter den Benutzerexit darauf hin, worauf ein sicherer Zugriff möglich ist, ohne eine Verarbeitung durch den Parser auszulösen, es ist jedoch möglich, dass der Benutzerexitcode diesen Hinweis ignoriert und den Zeitpunkt für die Syntaxanalyse effektiv ändert.
inputNode
Eine Kennung für den Empfangsknoten, der diese Eingabenachricht liest. Die Kennung kann für Aufrufe von Funktionen wie cciGetNodeName, cciGetNodeType und and 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 | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:30:03

as35950_