Desenvolvendo Saídas do Usuário

As saídas do usuário permitem que o software customizado fornecido pelo usuário rastreie os dados que passam através dos fluxos de mensagens nos WebSphere Message Brokers.

As funções fornecidas pelo usuário podem ser chamadas em pontos específicos durante o ciclo de vida de uma mensagem conforme ela é transmitida através do fluxo de mensagens e podem chamar funções do utilitário para consultar informações sobre o ponto no fluxo, e o conteúdo da montagem de mensagem.

As saídas do usuário podem ser chamadas quando ocorrer um ou mais dos eventos a seguir:

Fluxo de Mensagens Básicas
No fluxo de mensagens básicas mostrado acima, você pode rastrear as mensagens em dois níveis:
No nível da Transação, você pode rastrear os seguintes eventos:
No nível do Nó, você pode rastrear os seguintes eventos:
Isso significa que existem quatro tipos diferentes de eventos, que ocorrem na seguinte seqüência:
  1. Mensagem removida da fila a partir da origem de entrada (lida no fluxo)
  2. Mensagem propagada para o nó para processamento
  3. Processamento do nó concluído
  4. Fim da transação.

Eventos do Fluxo de Mensagens Básicas

No diagrama acima, o nó MQInput é utilizado como um exemplo, mas a função aplica-se a todos os nós de entrada, incluindo os nós definidos pelo usuário. No entanto, existe uma leve diferença entre os nós internos e os nós definidos pelo usuário, da maneira na qual as saídas do usuário são chamadas. Para os nós de entrada interna, a saída do usuário é chamada assim que possível depois que os dados forem lidos 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.

No exemplo mostrado acima, o evento 4 é acionado no fim da transação. A saída do usuário é chamada depois que a transação tiver sido concluída, de modo que o processamento de saída do usuário não faça parte dessa transação. A saída do usuário é chamada mesmo se nenhum procedimento de transação tiver sido concluído pelo fluxo. Quando a Contagem de Confirmação de propriedade do fluxo de mensagens for maior do que 1, há uma proporção de muitos para um entre o evento 1 e o evento 4. Isso também é verdadeiro para alguns cenários específicos do nó de entrada específico; por exemplo, quando um MQInputNode for configurado com a propriedade Confirmar 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:

Várias saídas de usuário podem estar registradas e, se estiverem, elas serão chamadas em uma ordem definida (consulte Comando mqsichangeflowuserexits). Quaisquer alterações feitas na montagem da mensagem por uma saída do usuário serão visíveis para as saídas de usuário subseqüentes.

Quando a saída de usuário for chamada, serão consultadas as seguintes informações:

As saídas do usuário podem ser registradas dinamicamente, sem precisar implementar novamente a configuração.

Tarefas relacionadas
Desenvolvendo uma Saída de Usuário
Implementando uma Saída de Usuário
Referências relacionadas
Comando mqsicreatebroker
Comando mqsichangebroker
Comando mqsichangeflowuserexits
Comando mqsireportflowuserexits
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac02140_