WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

cniPropagate

Use this function to propagate a message to a specified terminal object. If the terminal is not attached to another node by a connector, the message is not propagated, and the function is ignored.

Therefore, you do not have to check whether the terminal is attached before you propagate the message, unless you want the node to take different in this scenario. If required, you can use cniIsTerminalAttached to check whether the terminal is connected before you call this function.

Syntax

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

Parameters

returnCode
The return code from the function (output).
Possible return codes are:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
  • CCI_INV_MESSAGE_OBJECT
terminalObject
The address of the output terminal to receive the message (input). The address is returned by cniCreateOutputTerminal.
localEnvironment
The address of the local environment object to be sent with the message (input).

This message object is used by the publish/subscribe node supplied by the broker.

For compatibility with earlier versions, you can refer to this parameter as destinationList.

exceptionList
The address of the exception list for the message (input).
message
The address of the message object to be sent (input). If the message being sent is the same as the input message, this address is the one passed on the cniEvaluate implementation function.

Return values

If successful, CCI_SUCCESS is returned. Otherwise, CCI_FAILURE is returned, and the returnCode parameter indicates the reason for the error.

Example

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        cniPropagate(&rc, terminalObject, destinationList, exceptionList, message);
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:47:29


Reference topicReference topic | Version 8.0.0.7 | as07620_