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.

cciPropagatedMessageCallback

Die Funktion 'cciPropagatedMessageCallback' kann als Callback registriert werden und wird dann aufgerufen, wenn eine Nachricht von einem Knoten an einen anderen übergeben wird.

Die Funktion 'cciPropagatedMessageCallback' wird für jede Nachricht aufgerufen, die innerhalb der Ausführungsgruppe, in welcher der Callback registriert wurde, weitergegeben wird, wenn der Benutzerexitstatus aktiv ist. Der Callback wird registriert, indem ein Zeiger auf die Funktion als iFpPropagatedMessageCallback-Feld des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wurde.

Syntax

typedef void (*cciPropagatedMessageCallback)( 
                                 CciDataContext* userContext,
                                 CciMessage*        message,
                                 CciMessage*     localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage*     environment,
                                 CciConnection*  connection);

Parameter

userContext (Eingabe)
Der Wert, der an die Funktion cciRegisterUserExit übergeben wird.
message
Eine Kennung für das Nachrichtenobjekt, das weitergegeben wird. Der Benutzerexitcode darf die Transportheader oder Eigenschaftenelemente in dieser Baumstruktur nicht aktualisieren. Durch die Aktualisierung der Nachricht kann die Leistung beeinträchtigt werden, insbesondere, wenn die Eingabenachricht im Nachrichtenfluss sonst nicht geändert würde.
localEnvironment
Eine Kennung für das Objekt der lokalen Umgebung, das weitergegeben wird.
exceptionList
Eine Kennung für das Objekt der Ausnahmeliste, das weitergegeben wird.
environment
Eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
connection
Eine Kennung für das Verbindungsobjekt zwischen den beiden Knoten. Die Kennung kann beispielsweise in Aufrufen für cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName und cciGetTargetTerminalName verwendet werden. Diese Kennung ist nur für die Dauer dieser Instanz der Benutzerexitfunktion gültig.

Rückgabewerte

Keine.

Beispiel

void myPropagatedMessageCallback(
                        CciMessage*        message,
                        CciMessage*    localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 

   int          rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(amp rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(amp rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*rc sollte nun auf unerwartete Werte überprüft werden*/
   /*wenn rc 'CCI_BUFFER_TOO_SMALL' ist, ändern Sie die Größe versuchen Sie es erneut*/

}
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 | as35930_