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

cciOutputMessageCallback

La función cciOutputMessageCallback se puede registrar como una devolución de llamada y se invoca cada vez que un nodo de salida envía un mensaje.

La función cciOutputMessageCallback se invoca para cada mensaje de salida que se envía satisfactoriamente en el grupo de ejecución o flujo de mensajes en el que se ha registrado la llamada de devolución si el estado de la salida de usuario es activo. Si el nodo proporciona información de WrittenDestination en el árbol Entorno local, la devolución de llamada se invoca después de que se crea esta información.

Se realizan llamadas después de completar las operaciones siguientes:
  • Enviar un mensaje desde un nodo de salida o de respuesta (para nodos WebSphere MQ, JMS, TCPIP, HTTP o SOAP).
  • Envía un mensaje desde un nodo de solicitud (nodos TCPIP, HTTP o SOAP). La devolución de llamada se realiza después de que se ha recibido la respuesta.
  • Escribir en un archivo (nodo FileOutput).
  • Enviar un correo electrónico (nodo EmailOutput).
  • Completar una solicitud de adaptador (nodos de solicitud de WebSphere Adapters).

La llamada de devolución se registra proporcionando un puntero a la función como el campo iFpOutputMessageCallback de la estructura CCI_UE_VFT que se pasa a cciRegisterUserExit. El campo iFpOutputMessageCallback se añadió en la estructura CCI_UE_VFT de versión 2.

Cuando implemente esta devolución de llamada, compruebe el tipo de nodo utilizando cciGetNodeType antes de realizar ninguna operación específica del nodo.

Sintaxis

typedef void (*cciOutputMessageCallback)     ( 
                                 CciDataContext*  userContext,
                                 CciMessage*  message,
                                 CciMessage*      localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage*      environment,
                                 CciNode*         node);

Parámetros

userContext (entrada)
El valor que se pasa a la función cciRegisterUserExit.
message (entrada)
Un manejador al objeto de mensaje. No debe actualizar las cabeceras de transporte o elementos de Propiedades en este árbol.

Puede actualizar el cuerpo del mensaje. No obstante, debido a que esta devolución de llamada se invoca después de que el mensaje se ha enviado al transporte, los cambios no aparecen en ese mensaje. Los cambios sólo son visibles a los nodos que están conectados en sentido descendente del nodo de salida. La actualización del mensaje puede afectar al rendimiento, en particular si el árbol de mensaje no se cambiaría, en otras circunstancias, en el flujo de mensajes.

localEnvironment (entrada)
Un manejador al objeto de entorno local. El manejador puede contener información sobre el destino del mensaje que se graba en el subárbol WrittenDestination. Para obtener más información, consulte la documentación de cada nodo.
exceptionList (entrada)
Un manejador al objeto de lista de excepciones.
environment (entrada)
Un manejador al objeto de entorno para el flujo de mensajes actual.
node (entrada)
Un manejador al nodo que ha enviado el mensaje de salida. Puede utilizar el manejador para realizar llamadas a funciones tales como cciGetNodeName, cciGetNodeType y cniGetBrokerInfo.

Valores de retorno

Ninguno.

Ejemplo

void myOutputMessageCallback(
                      CciDataContext*  userContext,
                      CciMessage*  message,
                      CciMessage*      localEnvironment,
                      CciMessage* exceptionList,
                      CciMessage*      environment,
                      CciNode*         node){
}
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:31


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