WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

cniDispatchThread

Use esta função para despachar um novo encadeamento do fluxo de mensagens para chamar outra instância do encadeamento para executar o nó de entrada do fluxo de mensagens definido pelo usuário.

Esse encadeamento do fluxo de mensagens é alocado de um conjunto de encadeamentos mantido para cada fluxo de mensagens, sob controle da propriedade Additional Instances do fluxo de mensagens. Se nenhum encadeamento estiver disponível porque eles estão todos em uso, CCI_SUCCESS será retornado e returnCode será configurado como CCI_NO_THREADS_AVAILABLE. Este valor não é um erro, mas representa uma das causas a seguir:
  • O fluxo de mensagens não foi configurado para executar com encadeamentos adicionais.
  • Todos os encadeamentos adicionais configurados estão em execução no momento.

A função cniDispatchThread pode ser chamada apenas a partir de um nó de entrada. Se ela for chamada em qualquer outro momento, CCI_FAILURE será retornado e returnCode será configurado como CCI_INV_NODE_ENV.

Sintaxe

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

Parâmetros

returnCode
O código de retorno da função (saída).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_NO_THREADS_AVAILABLE
  • CCI_INV_NODE_OBJECT
  • CCI_INV_NODE_ENV
nodeObject
O endereço do objeto de nó que é executado quando o broker cria ou reutiliza o encadeamento. Este parâmetro é transmitido ao nó quando sua função de implementação cniCreateNodeContext é chamada (entrada).

Valores de Retorno

  • Se um encadeamento foi alocado com êxito, CCI_SUCCESS será retornado e returnCode será configurado como CCI_SUCCESS.
  • Se um encadeamento não pôde ser despachado porque encadeamentos insuficientes estão disponíveis no conjunto de encadeamentos do fluxo de mensagens para satisfazer o pedido, CCI_SUCCESS será retornado e returnCode será configurado como CCI_NO_THREADS_AVAILABLE.
  • Se a função não foi chamada em um nó de entrada, CCI_FAILURE será retornado e returnCode será configurado como CCI_INV_NODE_ENV.
  • Para todas as outras condições de erro, CCI_FAILURE é retornado e returnCode indica a razão para o erro.

Exemplo

  cniDispatchThread(&rcDispatch, ((NODE_CONTEXT_ST
*)context)->nodeObject);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:21


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | as07520_