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.

cniPropagate

Mit dieser Funktion können Sie eine Nachricht an ein angegebenes Terminalobjekt weitergeben. Wenn das Terminal nicht mit einem anderen Knoten verbunden ist, wird die Nachricht nicht weitergegeben, und die Funktion wird ignoriert.

Deshalb muss vor der Weitergabe der Nachricht nicht überprüft werden, ob das Terminal verbunden ist, es sei denn, der Knoten soll eine andere Aktion als in diesem Szenario durchführen. Bei Bedarf können Sie vor dem Aufruf dieser Funktion mit cniIsTerminalAttached überprüfen, ob das Terminal verbunden ist.

Syntax

int cniPropagate(
  int*          returnCode,
  CciTerminal*  terminalObject,
  CciMessage*   localEnvironment,
  CciMessage*   exceptionList,
  CciMessage*   message);

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
  • CCI_INV_MESSAGE_OBJECT
terminalObject
Die Adresse des Ausgabeterminals zum Empfangen der Nachricht (Eingabe). Die Adresse wird von cniCreateOutputTerminal ausgegeben.
localEnvironment
Die Adresse des Objekts für die lokale Umgebung, das mit der Nachricht gesendet werden soll (Eingabe).

Dieses Nachrichtenobjekt wird von dem Publish/Subscribe-Knoten verwendet, der vom Broker zur Verfügung gestellt wird.

Aus Gründen der Kompatibilität mit früheren Versionen kann dieser Parameter auch als destinationList bezeichnet werden.

exceptionList
Die Adresse der Ausnahmeliste für die Nachricht (Eingabe).
message
Die Adresse des zu sendenden Nachrichtenobjekts (Eingabe). Wenn die gesendete Nachricht mit der Eingabenachricht übereinstimmt, ist dies die Adresse, die in der Implementierungsfunktion cniEvaluate übergeben wurde.

Rückgabewerte

Bei Erfolg wird CCI_SUCCESS zurückgegeben. Ansonsten wird CCI_FAILURE ausgegeben, und der Parameter returnCode gibt den Grund für den Fehler an.

Beispiel

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        cniPropagate(&rc, terminalObject, destinationList, exceptionList, message);
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

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


ReferenzthemaReferenzthema | Version 8.0.0.5 | as07620_