TimeoutControl

Utilize o nó TimeoutControl para processar uma mensagem de entrada que contém um pedido de tempo limite.

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

Propósito

O nó TimeoutControl valida a mensagem de pedido de tempo limite, armazena a mensagem e propaga a mensagem (inalterada) para o próximo nó no fluxo de mensagens. Para obter informações adicionais, consulte Mensagem de Pedido de Tempo Limite.

O nó TimeoutControl está contido no repositório Cronômetro da paleta e é representado no ambiente de trabalho pelo seguinte ícone:

Ícone de Nó de Controle de Tempo Limite

Utilizando Este Nó em um Fluxo de Mensagens

Utilize um nó TimeoutControl e um nó TimeoutNotification juntos em um fluxo de mensagens para um aplicativo que requer que os eventos ocorram em momentos específicos ou em intervalo regulares.

Os exemplos de quando você pode utilizar os nós de tempo limite em um fluxo de mensagens incluem:
  • Você precisa executar uma tarefa do batch todo dia à meia-noite.
  • Você deseja informações sobre taxas de câmbio a serem enviadas aos bancos em intervalos de uma hora.
  • Você deseja confirmar que transações importantes são processadas em um determinado período de tempo e deseja executar algumas outras ações especificadas para avisar quando uma transação não foi processada nesse período de tempo.

Você pode utilizar mais de um nó TimeoutControl com um nó TimeoutNotification. Os pedidos de tempo limite que são iniciados por aqueles nós TimeoutControl serão todos processados pelo mesmo nó TimeoutNotification se o mesmo Identificador Exclusivo for utilizado para o nó TimeoutNotification e cada um dos nós TimeoutControl.

Consulte a amostra a seguir para obter detalhes adicionais sobre como utilizar os modos de processamento de tempo limite: 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ó TimeoutControl 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ó TimeoutControl são descritos na tabela a seguir.

Terminal Descrição
In O terminal de entrada que aceita uma árvore de mensagens para processamento (que inclui validação do pedido de tempo limite especificado na árvore de mensagens em Local do Pedido) e o inclui na fila de controle.
Failure O terminal de saída para o qual a mensagem de entrada será propagada se for detectada uma falha durante o processamento neste nó. Se este terminal não estiver conectado a outro nó, as informações de erro serão retornadas ao nó anterior no fluxo de mensagens.
Out O terminal de saída para o qual as mensagens que chegam serão propagadas, inalteradas, após o processamento de tempo limite bem-sucedido. Se este terminal não estiver conectado a outro nó, não ocorrerá nenhuma propagação. Se a propagação da mensagem falhar, a mensagem será propagada para o terminal Failure.

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ó TimeoutControl 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ó, TimeoutControl 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ó TimeoutControl são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Identificador exclusivo Sim Sim Nenhum(a) Esta é a única propriedade obrigatória para o nó. Seu valor deve ser exclusivo no intermediário. A propriedade equivalente do nó TimeoutNotification ao qual ela está associada deve ter o mesmo valor. O comprimento máximo deste identificador é de 12 caracteres.
Local do pedido Não Não Nenhum(a) Esta propriedade descreve onde localizar as informações de pedido de tempo limite na mensagem que chega. Este valor pode ser qualquer local válido na árvore da mensagem de entrada e é validado no tempo de execução. Se você não especificar um local de pedido, InputLocalEnvironment.TimeoutRequest será assumido. Para obter informações adicionais sobre a mensagem de pedido de tempo limite, consulte Mensagem de Pedido de Tempo Limite.
Persistência do pedido Não Não Automático Esta propriedade controla se um pedido de tempo limite de entrada sobrevive a um reinício do intermediário ou do fluxo de mensagens que contém o nó TimeoutNotification que está vinculado a este nó TimeoutControl.

Selecione Sim (Yes) se desejar que o pedido que chega permaneça; selecione Não (No), se não desejar. Se você selecionar Automático (o padrão), a configuração de Persistência na pasta Propriedades da mensagem que chega será utilizada.

As propriedades Mensagem do nó TimeoutControl são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Local da mensagem armazenada Não Não Nenhum(a) Esta propriedade identifica o local da parte da mensagem de pedido que você deseja armazenar para propagação pelo nó TimeoutNotification com o qual este nó está vinculado. Se você não especificar um valor, toda a mensagem será armazenada. É possível especificar qualquer local válido na árvore de mensagens. Se você escolher armazenar a mensagem inteira, não precisará especificar nenhum valor em Domínio de Mensagem, Conjunto de Mensagens, Tipo de Mensagem ou Formato da Mensagem.
Domínio de mensagem Não Não Nenhum O domínio utilizado para analisar a mensagem de pedido de tempo limite armazenada pelo nó TimeoutNotification.
Selecione o nome do analisador que você está utilizando. Esse valor e os três valores correspondentes em Conjunto de Mensagens, Tipo de Mensagem e Formato de Mensagem são utilizados pelo nó TimeoutNotification com o qual ele é pareado quando ele reconstrói a mensagem armazenada para propagação. Se você armazenar a mensagem de pedido inteira (deixando em branco o Local da Mensagem Armazenada), não especifique nenhum valor aqui. Se você optar por armazenar parte da mensagem de pedido, especifique valores aqui que reflitam o fragmento da mensagem de pedido armazenado como se fosse a mensagem inteira, que é o caso quando ela é processada pelo nó TimeoutNotification. Escolha dentre os seguintes analisadores:
  • MRM
  • XML
  • XMLNS
  • XMLNSC
  • BLOB
Conjunto de Mensagens Não Não Nenhum(a) O nome ou identificador do conjunto de mensagens no qual a mensagem de pedido de tempo limite armazenada está definida. Se você estiver utilizando o analisador MRM, selecione o Conjunto de Mensagens que deseja utilizar a partir da lista.

Deixe Conjunto de Mensagens em branco para os analisadores XML, XMLNS, XMLNSC e BLOB.

Tipo de mensagem Não Não Nenhum(a) O nome da mensagem de pedido de tempo limite armazenada. Se você estiver utilizando o analisador MRM, selecione a mensagem correta na lista em Tipo de Mensagem. Esta lista é ocupada com mensagens que estão definidas no Conjunto de mensagens que você selecionou.

Deixe Tipo de Mensagem em branco para os analisadores XML, XMLNS, XMLNSC e BLOB.

Formato de Mensagem Não Não Nenhum(a) O nome do formato físico da mensagem de pedido de tempo limite armazenada. Se você estiver utilizando o analisador MRM, selecione o formato da mensagem a partir da lista em Formato de Mensagem. Esta lista inclui todos os formatos físicos que você definiu para este Conjunto de Mensagens.

Deixe Formato da Mensagem em branco para analisadores XML, XMLNS, XMLNSC, e BLOB.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac20800_