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

AggregateControl

Utilize o nó AggregateControl para marcar o início de um fan-out de pedidos que fazem parte de uma agregação.

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

Finalidade

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 de controle (Control) incluem o identificador do intermediário, a propriedade de nome agregado e a propriedade de tempo limite. Você não deve alterar as informações de agregação incluídas no Ambiente da Mensagem pelo nó AggregateControl.
  • 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. Você deve preservar as informações incluídas no Ambiente da mensagem pelo nó AggregateControl, 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.

Este nó cria a pasta LocalEnvironment.ComIbmAggregateControlNode. Essa pasta e seus campos são para uso interno pelo WebSphere Message Broker e você não deve contar com sua existência ou valores ao desenvolver seus fluxos de mensagens.

O nó AggregateControl está contido no repositório Roteamento da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

 Ícone do nó AggregateControl

Utilizando Este Nó em um Fluxo de Mensagens

Veja as amostras a seguir para consultar sobre como utilizar este nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Terminais e Propriedades

Quando tiver colocado uma instância do nó AggregateControl 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. 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ó AggregateControl são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Out O terminal de saída para o qual a mensagem original será roteada quando o processamento for concluído com êxito.
Control O terminal de saída para o qual uma mensagem de controle será roteada. A mensagem de controle é enviada para um nó AggregateReply correspondente.

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

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ó AggregateControl são descritas na tabela a seguir:

Propriedade M P Default Descrição
Nome do Nó Não Não O tipo de nó (AggregateControl) 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ó AggregateControl são descritas na tabela a seguir:

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Nome Agregado Sim Sim   Um nome usado para associar o fluxo de mensagens fan-out ao fluxo de mensagens fan-in. Esse valor deve ser contextualmente exclusivo em um broker.

Este nome também é usado para identificar um serviço configurável de agregação (se existir um) a ser usado pelo nó.

aggregateName
Tempo Limite (s) (Timeout (sec)) Sim Não 0 A período de tempo, em segundos, durante o qual as respostas são aguardadas no fan-in.

O valor padrão é zero; se você aceitar esse valor padrão, o tempo limite será desativado para fan-outs desse nó (ou seja, as respostas são aguardadas indefinidamente). Se nem todas as respostas forem recebidas, o fluxo de mensagens continuará aguardando e não será concluído. Defina um valor maior que zero para assegurar-se de que o fluxo de mensagens possa ser concluído, mesmo que nem todas as respostas sejam recebidas. Para obter informações adicionais sobre tempos limite, consulte Nó AggregateReply.

z/OS platformNo z/OS®, se a propriedade de tempo limite (Timeout) não estiver definida como zero, defina o parâmetro do gerenciador de filas EXPRYINT como 5.

O valor especificado pela propriedade Tempo Limite (s) é substituído pelo valor configurado na propriedade timeoutSeconds do serviço configurável de agregação, se estiver configurado. Os valores de tempo limite especificados pelo nó e o serviço configurável são substituídos por um valor de tempo limite definido na mensagem, no local especificado pela propriedade Local de Tempo Limite do nó AggregateControl.

 

As propriedades Avançadas do nó AggregateControl são descritas na tabela a seguir:

Propriedade M P Default Descrição
Local do Tempo Limite Não Não '$LocalEnvironment/Aggregation/Timeout' O local na árvore de mensagens em que o valor de tempo limite da agregação está definido. O valor especificado na árvore de mensagens substitui a propriedade Tempo Limite (s) do nó AggregateControl e a propriedade timeoutSeconds do serviço configurável de agregação.
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

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:18


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04740_