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

cciOutputMessageCallback

A função cciOutputMessageCallback pode ser registrada como um retorno de chamada e é chamada sempre que uma mensagem é enviada por um nó de saída.

A função cciOutputMessageCallback é chamada para cada mensagem de saída enviada com êxito no grupo de execução ou fluxo de mensagens no qual o retorno de chamada foi registrado se o estado de saída de usuário estiver ativo. Se o nó fornece informações WrittenDestination na árvore LocalEnvironment, o retorno de chamada será chamado após estas informações serem criadas.

As chamadas são feitas após a conclusão das seguintes operações:
  • Envio de uma mensagem de um nó de saída ou de resposta (para nós WebSphere MQ, JMS, TCPIP, HTTP ou SOAP).
  • Envio de uma mensagem de um nó de pedido (nós TCPIP, HTTP ou SOAP). O retorno de chamada é feito após o recebimento da resposta.
  • Gravação em um arquivo (nó FileOutput).
  • Envio de um e-mail (nó EmailOutput).
  • Conclusão de um pedido do adaptador (nós de pedido do WebSphere Adapters).

O retorno de chamada é registrado fornecendo um ponteiro para a função como o campo iFpOutputMessageCallback da estrutura CCI_UE_VFT transmitida para cciRegisterUserExit. O campo iFpOutputMessageCallback foi incluído na estrutura CCI_UE_VFT versão 2.

Ao implementar este retorno de chamada, verifique o tipo de nó utilizando cciGetNodeType antes de desempenhar quaisquer operações específicas do nó.

Sintaxe

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

Parâmetros

userContext (entrada)
O valor transmitido para a função cciRegisterUserExit.
message (entrada)
Um identificador para o objeto de mensagem. Você não deve atualizar os cabeçalhos de transporte ou elementos de Propriedades nesta árvore.

Você pode atualizar o corpo da mensagem. No entanto, como este retorno de chamada é chamado após a mensagem ter sido enviada para o transporte, as alterações não aparecem nessa mensagem. As alterações ficam visíveis apenas para nós que estão conectados no recebimento de dados do nó de saída. Atualizar a mensagem pode afetar o desempenho, principalmente se a árvore de mensagens não for alterada de outra maneira no fluxo de mensagens.

localEnvironment (entrada)
Um identificador para o objeto de ambiente local. O identificador pode conter informações sobre o destino da mensagem gravada na subárvore WrittenDestination. Consulte a documentação de cada nó para obter detalhes adicionais.
exceptionList (entrada)
Um identificador para o objeto da lista de exceções.
environment (entrada)
Um identificador para o objeto de ambiente para o fluxo de mensagens atual.
node (entrada)
Um identificador para o nó que enviou a mensagem de saída. Você pode utilizar o identificador para fazer chamadas para funções como cciGetNodeName, cciGetNodeType e cniGetBrokerInfo.

Valores de Retorno

Nada.

Exemplo

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