WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cniPropagate

Utilice esta función para propagar un mensaje a un objeto de terminal especificado. Si el terminal no está conectado a otro nodo mediante un conector, el mensaje no se propaga y se hace caso omiso de la función.

Por consiguiente, no es necesario que compruebe si el terminal está conectado antes de propagar el mensaje, a menos que desee que el nodo realice una acción diferente en este escenario. Si es necesario, puede utilizar cniIsTerminalAttached para comprobar si el terminal está conectado antes de llamar a esta función.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
  • CCI_INV_MESSAGE_OBJECT
terminalObject
Dirección del terminal de salida que debe recibir el mensaje (entrada. La dirección la devuelve cniCreateOutputTerminal.
localEnvironment
Dirección del objeto de entorno local que se debe enviar con el mensaje (entrada).

El nodo Publish/subscribe proporcionado por el intermediario utiliza este objeto de mensaje.

Por compatibilidad con versiones anteriores, puede hacer referencia a este parámetro como destinationList.

exceptionList
Dirección de la lista de excepciones para el mensaje (entrada).
message
Dirección del objeto de mensaje que se debe enviar (entrada). Si el mensaje que se envía es el mismo que el mensaje de entrada, esta dirección es la que se pasa en la función de implementación cniEvaluate.

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve CCI_SUCCESS. De lo contrario, se devuelve CCI_FAILURE y el parámetro returnCode indica la razón del error.

Ejemplo

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        cniPropagate(&rc, terminalObject, destinationList, exceptionList, message);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:22


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as07620_