Explorando Saídas de Usuário

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

Antes de começar:

Início da mudançaO 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.Fim da mudança

Eventos do fluxo de mensagens básico
Início da mudança
  1. 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. A mensagem é propagada para o nó para processamento.
  3. O processamento do nó é concluído.
  4. A saída de usuário é chamada após a conclusão da transação, portanto, o processamento da saída de usuário não faz parte dessa transação. A saída de usuário é chamada mesmo se nenhum processamento transacional for 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 4. 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.

Fim da mudança
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
    • Árvore LocalEnvironment (leitura e gravação)
    • Lista de Exceções
    • Árvore Ambiente (leitura e gravação)
    • Nó de Origem
    • Nó de Destino
  • O processamento do nó é concluído:
    • Árvore de Mensagens
    • Á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 de mensagens (Message,LocalEnvironment,ExceptionList)
  • Navegar e ler ou gravar na árvore Ambiente

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

Conceitos relacionados
Saídas de usuário
Tarefas relacionadas
Implementando uma Saída de Usuário
Desenvolvendo uma Saída de Usuário
Referências relacionadas
Comando mqsichangeflowuserexits
Extensões Definidas pelo Usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:38

ac02145_