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

cciNodeCompletionCallback

A função cciNodeCompletionCallback pode ser registrada como um retorno de chamada e é chamada sempre que um nó conclui o processamento de uma mensagem e está retornando o controle para seu nó de envio de dados.

A função cciNodeCompletionCallback é chamada para cada mensagem propagada no grupo de execução onde o retorno de chamada foi registrado, se o estado de saída do usuário estiver ativo. O retorno de chamada é registrado fornecendo um ponteiro para a função como o campo iFpNodeCompletionCallback da estrutura CCI_UE_VFT transmitida para cciRegisterUserExit.

Se o nó for concluído devido a uma exceção não-manipulada, ele retornará com um reasonCode CCI_EXCEPTION e os detalhes dessa exceção poderão ser obtidos chamando cciGetLastExceptionData.

Se o nó for concluído normalmente (incluindo a manipulação de uma exceção no terminal de captura ou de falha), ele retornará com um reasonCode de CCI_SUCCESS. Nesse caso, a chamada de cciGetLastExceptionData retorna resultados imprevisíveis.

Sintaxe

typedef void (*cciNodeCompletionCallback) (
                                 CciDataContext* userContext,
                                 CciMessage*        message,
                                 CciMessage* localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage* environment,
                                 CciConnection* connection,
                                 int reasonCode);

Parâmetros

userContext (entrada)
O valor transmitido para a função cciRegisterUserExit.
message
Um identificador para o objeto de mensagem atual. A mensagem atual é a mensagem que é propagada para o nó mais uma ou mais das seguintes modificações:
  • Modificações que são aplicadas à raiz de entrada no nó
  • Modificações que são feitas a partir de uma saída de usuário durante o retorno de chamada de propagação precedente
  • Modificações que são feitas a partir de uma saída de usuário durante o retorno de chamada completo do nó de recebimento de dados se o nó não criar uma nova mensagem; por exemplo, nós de saída, Compute nós com um Modo de Cálculo que é configurado para LocalEnvironment, Exceção, ou Exceção E LocalEnvironment ou nós de pedido com um Local de dados de saída que está configurado para LocalEnvironment.

O código de saída do usuário não deve atualizar cabeçalhos de transporte ou elementos de Propriedades na árvore de mensagens. A atualização da mensagem pode afetar o desempenho. As alterações feitas durante este retorno de chamada são visíveis apenas se o nó de envio de dados não causar a criação de uma nova Mensagem.

localEnvironment
Um identificador para o objeto do ambiente local que está sendo propagado.
exceptionList
Um identificador para o objeto da lista de exceções que está sendo propagado.
environment
Um identificador para o objeto de ambiente para o fluxo de mensagens atual.
connection
Um identificador para o objeto de conexão entre os dois nós. O identificador pode ser utilizado, por exemplo, em chamadas para cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName e cciGetTargetTerminalName. Esta manipulação é válida apenas pela duração desta instância da função de saída de usuário.
reasonCode
Um código de razão que indica se o nó foi concluído normalmente (CCI_SUCCESS) ou se o nó foi concluído como resultado de uma exceção não-manipulada (CCI_EXCEPTION). Se o nó for concluído devido a uma exceção não-manipulada, você poderá obter os detalhes dessa exceção chamando cciGetLastExceptionData. Se o nó for concluído normalmente (incluindo a manipulação de uma exceção no terminal de captura ou de falha), o efeito de chamar cciGetLastExceptionData será indeterminado.

Valores de Retorno

Nenhum.

Exemplo

void myNodeCompletionCallback(
                                 CciDataContext* userContext,
                                 CciMessage*        message,
                                 CciMessage* localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage* environment,
                                 CciConnection* connection
                                 int reasonCode){
…
…
}
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:30


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