AggregateReply

Utilize o nó AggregateReply para marcar o final de um fan-in de agregação. Ele coleta respostas e as combina em uma única mensagem composta.

Este tópico contém as seguintes seções:

Propósito

Agregação é uma extensão do modelo de aplicativo de pedido/resposta. Ela combina a geração e difusão de vários pedidos relacionados à recepção das respostas correspondentes e compila estas respostas em uma única mensagem de resposta agregada.

A função de agregação é fornecida pelos três seguintes nós:

  • O nó AggregateControl marca o início de um fan-out de pedidos que fazem parte de uma agregação. Ele envia uma mensagem de controle utilizada pelo nó AggregateReply para corresponder os diferentes pedidos que foram feitos. As informações propagadas do terminal Control incluem o identificador do intermediário, a propriedade de nome agregado e a propriedade de tempo limite. As informações de agregação incluídas no Ambiente de mensagem pelo nó AggregateControl não devem ser alteradas.
  • O nó AggregateRequest registra o fato de que as mensagens de pedido foram enviadas. Ele também coleta informações que ajudam o nó AggregateReply a construir a mensagem de resposta agregada. As informações incluídas no Ambiente de mensagem por AggregateRequest devem ser preservadas; caso contrário, a agregação falhará.
  • O nó AggregateReply marca o final de um fan-in de agregação. Ele coleta respostas e as combina em uma única mensagem de resposta agregada.

O nó AggregateReply está contido no repositório Roteamento da paleta e é representado no ambiente de trabalho pelo seguinte ícone:

 Ícone do nó AggregateReply

Quando as mensagens que chegam são armazenadas pelo nó AggregateReply antes de todas as respostas para a agregação serem recebidas, a persistência da mensagem determina se ela permanecerá após um reinício.

Se, durante uma agregação, uma ou mais das mensagens de resposta não forem recebidas pelo nó AggregateReply, o tempo limite normal ou processamento de mensagens desconhecidas lidará com a resposta já recebida.

O valor MQMD.Expiry de cada mensagem AggregateReply está configurado como -1 na mensagem de saída composta. Este valor é configurado porque o valor de MQMD.Expiry não possui significado uma vez que a mensagem de resposta não está mais no Transporte de WebSphere MQ e foi armazenada pelo intermediário durante o processo de agregação.

Utilizando este nó em um fluxo de mensagens

Veja as amostras a seguir para consultar sobre como utilizar este nó: Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers Toolkit.

Terminais e Propriedades

Quando tiver colocado uma instância do nó AggregateReply em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em Propriedades. Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

Os terminais do nó AggregateReply são descritos na tabela a seguir.

Terminal Descrição
Control O terminal de entrada que aceita mensagens de controle enviadas por um nó AggregateControl correspondente.

O terminal Control foi reprovado no Versão 6.0; para utilizar conexões com o terminal Control, consulte Utilizando Mensagens de Controle em Fluxos de Agregação.

In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem será roteada se for detectado um defeito durante o processamento.
Unknown O terminal de saída para o qual as mensagens serão roteadas quando não puderem ser identificadas como mensagens de resposta válidas.
Out O terminal de saída para o qual a mensagem composta será roteada quando o processamento for concluído com êxito.
Timeout O terminal de saída para o qual a mensagem composta incompleta é roteada quando o intervalo de tempo limite especificado no nó AggregateControl correspondente tiver expirado.
Catch O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e, em seguida, capturada por este nó.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó AggregateReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não O tipo de nó (AggregateReply) O nome do nó.
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó AggregateReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome Agregado Sim Sim   Um nome utilizado para associar o fluxo de mensagens fan-in ao fluxo de mensagens fan-out. Esse valor deve ser contextualmente exclusivo no intermediário.
Tempo Limite de Mensagens Desconhecido Não Não 0 O período de tempo, em segundos, durante o qual as mensagens que não podem ser identificadas como respostas são mantidas antes de serem propagadas para o terminal Unknown.

O valor padrão é zero; se você aceitar este valor padrão, o tempo limite será desativado e mensagens desconhecidas serão propagadas para o terminal Unknown mediante recebimento.

z/OS platform No z/OS, se a propriedade Tempo Limite da Mensagem Desconhecido estiver configurada para zero, configure o parâmetro EXPRYINT do gerenciador de filas para 5.

Modo de Transação Sim Não Selecionada Esta propriedade define as características transacionais desta mensagem:
  • Se você selecionar a caixa de opções (o padrão), o fluxo de mensagens subseqüente ficará sob controle da transação. Esta configuração permanece verdadeira para mensagens derivadas da mensagem de saída e são produzidas por um nó MQOutput, a menos que o nó MQOutput substitua explicitamente o status da transação. Nenhum outro nó pode alterar as características transacionais da mensagem de saída.
  • Se você limpar a caixa de opções, o fluxo de mensagens subseqüente não ficará sob controle da transação. Esta configuração permanece verdadeira para mensagens derivadas da mensagem de saída e são produzidas por um nó MQOutput, a menos que o nó MQOutput tenha especificado que a mensagem deve ser colocada sob o ponto de sincronização.
Referências relacionadas
Nó AggregateControl
Nó AggregateRequest
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac04750_