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

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:

Finalidade

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 Enviando Mensagens de Pedido de Tempo Limite.

O nó TimeoutControl está contido no repositório Cronômetro da paleta e é representado no WebSphere Message Broker Toolkit 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 em lote todo dia à meia-noite
  • Você deseja que informações sobre taxas de câmbio sejam enviadas para os bancos em intervalos de uma hora
  • Você deseja confirmar que transações importantes sejam processadas em um determinado período e executar algumas outras ações especificadas para avisar quando uma transação não tiver sido processada nesse período

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.

Início da mudançaSó será possível usar os nós TimeoutControl com um nó TimeoutNotification que esteja em um fluxo de mensagens separado se as condições a seguir forem atendidas:
  • O mesmo Identificador Exclusivo é usado para o nó TimeoutNotification e cada um de seus nós TimeoutControl
  • O fluxo de mensagens que contém os nós TimeoutControl e o fluxo de mensagens que contém o nó TimeoutNotification estão implementados no mesmo grupo de execução
Fim da mudança
Consulte a amostra a seguir para obter detalhes adicionais sobre como utilizar os modos de processamento de tempo limite:

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ó 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. 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 Propriedade do Comando mqsiapplybaroverride
Identificador exclusivo Sim Sim Nenhum(a) Esta é a única propriedade obrigatória para o nó. Seu valor deve ser exclusivo no broker. 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.

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

uniqueIdentifier
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 Enviando Mensagens 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 broker 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.

As propriedades de mensagens do nó TimeoutControl estã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 será necessário especificar nenhum valor em Domínio de Mensagem, Local de Esquema ou Raiz do Documento.
Domínio de mensagem Não Não BLOB O domínio utilizado para analisar a mensagem de pedido de tempo limite armazenada pelo nó TimeoutNotification. Se você não especificar um valor e o local da mensagem estiver armazenado, o valor padrão será BLOB.
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:
  • DFDL
  • XMLNSC
  • JSON
  • BLOB
  • MRM
  • XMLNS
Também é possível especificar um analisador definido pelo usuário, se apropriado.
Modelo de mensagem Não Não Nenhum(a) O nome ou local do modelo de mensagem no qual a mensagem de solicitação de tempo limite armazenada está definida.
Message Não Não Nenhum(a) O nome ou o local do elemento global que modela a mensagem de solicitação de tempo limite armazenado e está contido no arquivo de esquema do modelo de mensagem. Essa lista é preenchida com todas as mensagens disponíveis definidas no modelo de mensagem que você selecionou.
Formato Físico 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.
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:27


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