Nó AggregateControl

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

Finalidade

Utilize o nó AggregateControl para marcar o início de uma difusão de solicitações que fazem parte de uma agregação.

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:

  1. O nó AggregateControl marca o início de uma difusão de solicitações que fazem parte de uma agregação. Ele envia uma mensagem de controle que é utilizada pelo nó AggregateReply para corresponder os diferentes pedidos que foram feitos. As informações propagadas do terminal de controle 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 na mensagem Ambiente pelo nó AggregateControl não devem ser alteradas.
  2. O nó AggregateRequest registra o fato de que as mensagens de pedidos foram enviadas. Ele também coleta informação que ajuda o nó AggregateReply a construir a mensagem de resposta agregada.As informações incluídas na mensagem Ambiente pelo AggregateRequest devem ser preservadas, caso contrário a agregação falhará.
  3. O nó AggregateReply marca o final de uma captação de agregação. Ele coleta respostas e as combina em uma única mensagem de resposta agregada.

O nó AggregateControl é representado no workbench 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ó: amostra para ver como é possível utilizar esse nó:

Configurando o Nó AggregateControl

Quando você tiver colocado uma instância do nó AggregateControl em um fluxo de mensagens, poderá configurá-lo. Clique com o botão direito do mouse na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.

Configure o nó AggregateControl da seguinte forma:

  1. Insira um valor para o Nome Agregado.Esse nome é utilizado para associar o fluxo de mensagens de difusão ao fluxo de mensagens de recepção. Esse valor deve ser contextualmente exclusivo no intermediário. Essa propriedade é obrigatória; é necessário digitar um valor.
  2. Insira um Tempo Limite.Esse valor é especificado em segundos. É necessário digitar um valor (ou aceitar o valor inicial mostrado, 0) porque essa propriedade é obrigatória. Se você aceitar o valor, o tempo limite será desativado para difusões a partir 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. Portanto, recomenda-se que você defina um valor superior a 0. Consulte Nó AggregateReply para obter informações adicionais sobre os tempos limite.
  3. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  4. Clique em Aplicar para fazer as alterações no nó AggregateControl sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Terminais e Propriedades

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ó.
Saída O terminal de saída para o qual a mensagem original será roteada quando o processamento for concluído com êxito.
Controle O terminal de saída para o qual uma mensagem de controle será roteada. A mensagem de controle é enviada para um nó AggregateReply correspondente.
Nota: O terminal Control está obsoleto na Versão 6.0, para utilizar conexões do terminal Control, 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 (marcado com um asterisco no diálogo de propriedades 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 no arquivo bar para implementá-lo).

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

Propriedade M C Padrão Descrição
Nome Agregado Sim Sim   Um nome que pode ser utilizado para associar o fluxo de mensagens de difusão a um fluxo de mensagens de recepção.
Tempo Limite (seg) Sim Não 0 O período de tempo, em segundos, durante o qual é aguardada a chegada de respostas na recepção.
Nota: No z/OS, se a propriedade Tempo Limite não estiver configurada para zero, configure o parâmetro EXPRYINT do gerenciador de filas para 5.

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

Propriedade M C Padrão Descrição
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.
Referências relacionadas
Nó AggregateReply
Nó AggregateRequest
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04740_