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

cniDispatchThread

Utilice esta función para despachar una nueva hebra de flujo de mensajes para llamar a otra instancia de hebra a fin de ejecutar el nodo de entrada de flujo de mensajes definido por el usuario.

Esta hebra de flujo de mensajes se asigna de una agrupación de hebras mantenidas para cada flujo de mensajes, bajo el control de la propiedad Instancias adicionales del flujo de mensajes. Si no hay ninguna hebra disponible porque están todas en uso, se devuelve CCI_SUCCESS y returnCode se establece en CCI_NO_THREADS_AVAILABLE. Este valor no es un error, sino que representa una de las causas siguientes:
  • El flujo de mensajes no se ha configurado para ejecutarse con hebras adicionales.
  • Todas las hebras adicionales configuradas están en ejecución actualmente.

La función cniDispatchThread sólo se puede llamar desde un nodo de entrada. Si se llama en cualquier otro momento, se devuelve CCI_FAILURE y returnCode se establece en CCI_INV_NODE_ENV.

Sintaxis

int cniDispatchThread(
  int*        returnCode,
  CciNode*    nodeObject);

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_NO_THREADS_AVAILABLE
  • CCI_INV_NODE_OBJECT
  • CCI_INV_NODE_ENV
nodeObject
La dirección del objeto de nodo que se ejecuta cuando el intermediario crea o reutiliza la hebra. Este parámetro se pasa al nodo cuando se llama a su función de implementación cniCreateNodeContext (entrada).

Valores de retorno

  • Si una hebra se ha asignado satisfactoriamente, se devuelve CCI_SUCCESS y returnCode se establece en CCI_SUCCESS.
  • Si una hebra no se ha podido despachar porque no había suficientes hebras disponibles en la agrupación de hebras de flujo de mensajes para satisfacer la petición, se devuelve CCI_SUCCESS y returnCode se establece en CCI_NO_THREADS_AVAILABLE.
  • Si no se ha llamado a la función desde un nodo de entrada, se devuelve CCI_FAILURE y returnCode se establece en CCI_INV_NODE_ENV.
  • Para todas las demás condiciones de error, se devuelve CCI_FAILURE y returnCode indica la razón del error.

Ejemplo

  cniDispatchThread(&rcDispatch, ((NODE_CONTEXT_ST *)context)->nodeObject);
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 | as07520_