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

Explorando Saídas de Usuário

Seus fluxos de mensagens podem beneficiar-se de saídas de usuário.

Antes de começar:

O diagrama a seguir ilustra como funciona uma saída de usuário. Os eventos numerados são descritos após o diagrama. O nó MQInput é utilizado como um exemplo, mas a função se aplica a todos os nós de entrada, incluindo nós de entrada definidos pelo usuário. De forma semelhante, os nós Compute e MQOutput podem ser substituídos por quaisquer nós equivalentes.

Eventos do Fluxo de Mensagens Básicas
  1. (cciInputMessageCallback) A mensagem é removida da fila da origem de entrada (lida no fluxo).

    Os nós integrados e nós definidos pelo usuário diferem um pouco na maneira como as saídas de usuário são chamadas. Para nós de entrada integrados, a saída de usuário é chamada o mais rápido possível após os dados terem sido lidos a partir da origem externa. Para os nós de entrada definidos pelo usuário, a saída do usuário será chamada pouco antes de o nó propagar a mensagem.

  2. (cciPropagatedMessageCallback) A mensagem é propagada para o nó para processamento.
  3. (cciOutputMessageCallback). Uma mensagem de pedido é enviada para o transporte do nó de saída e as informações do destino específicas de transporte são gravadas em WrittenDestination no LocalEnvironment (por exemplo, estas informações incluem o queueName e msgId para uma mensagem do MQ). A chamada é feita quando um nó bem-sucedido coloca uma mensagem em um transporte, a partir de um nó de saída ou de pedido. outputMessageEvent é chamado apenas por nós integrados. O tópico para cada nó que suporta informações de WrittenDestination contém detalhes sobre os dados que ele contém.
  4. (cciNodeCompletionCallback) O processamento do nó é concluído.
  5. (cciTransactionEventCallback) A saída de usuário é chamada após a transação ser concluída, portanto, esse processamento de saída de usuário não faz parte dessa transação. A saída de usuário é chamada, mesmo que nenhum processamento transacional tenha sido concluído pelo fluxo.

    Quando a propriedade do fluxo de mensagens Contagem de Consolidação for maior do que um, existirão proporções de muitos para um entre os eventos 1 e 5. Esta proporção também existe para alguns cenários específicos desse nó de entrada; por exemplo, quando um nó MQInput é configurado com a propriedade Consolidar por Grupo de Mensagens selecionada.

Você pode gravar uma saída de usuário para rastrear qualquer número desses eventos. Para cada um desses eventos, os seguintes dados estão disponíveis para a saída de usuário. Todo o acesso é somente de leitura, a menos que seja indicado de forma diferente:
  • A mensagem é removida da fila:
    • Fluxo de bits
    • Nó Input
    • Árvore Ambiente (leitura e gravação)
  • A mensagem é propagada para o nó:
    • Árvore de mensagens (leitura e gravação do elemento body)
    • Árvore LocalEnvironment (leitura e gravação)
    • Lista de Exceções
    • Árvore Ambiente (leitura e gravação)
    • Nó de Origem
    • Nó de Destino
  • Uma mensagem é enviada para um transporte:
    • Árvore de mensagens (leitura e gravação do elemento body)
    • Árvore LocalEnvironment (leitura e gravação)
    • Lista de Exceções
    • Árvore Ambiente (leitura e gravação)
    • Nó de saída ou de pedido
  • O processamento do nó é concluído:
    • Árvore de mensagens (leitura e gravação do elemento body)
    • Árvore LocalEnvironment (leitura e gravação)
    • Lista de Exceções
    • Árvore Ambiente (leitura e gravação)
    • Nó de Envio de Dados
    • Exceção (se houver)
  • O final da transação:
    • Nó Input
    • Exceção (se houver)
    • Árvore Ambiente (leitura e gravação)

Você pode registrar várias saídas de usuário e, se registradas, serão chamadas em uma ordem definida (consulte Comando mqsichangeflowuserexits). As alterações feitas na montagem da mensagem (a mensagem e o ambiente) por uma saída de usuário ficam visíveis para saídas de usuário subseqüentes.

Quando a saída de usuário é chamada, ela pode consultar as seguintes informações:
  • Informações sobre o fluxo de mensagens:
    • Nome do fluxo de mensagens
    • Nome do intermediário
    • Nome do gerenciador de filas do intermediário
    • Nome do grupo de execução
    • Propriedade da contagem de confirmação do fluxo de mensagens
    • Propriedade do intervalo de confirmação do fluxo de mensagens
    • Propriedade de transação coordenada de fluxo de mensagens
  • Informações sobre o nó:
    • Nome do Nó
    • Tipo de Nó
    • Nome do terminal
    • Propriedades do nó
A saída de usuário também pode desempenhar as seguintes tarefas:
  • Navegar e ler a montagem da mensagem (Message, LocalEnvironment, ExceptionList, Environment)
  • Navegar e gravar a árvore do corpo da Mensagem, LocalEnvironment e Environment

É possível registrar saídas de usuário em uma base dinâmica, sem precisar reimplementar a configuração.

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:28:14


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | ac02145_