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

TimeoutNotification

Utilize o nó TimeoutNotification para gerenciar fluxos de mensagens dependentes de tempo limite.

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

Finalidade

O nó TimeoutNotification é um nó de entrada que você pode utilizar de duas formas:

  • Um nó TimeoutNotification pode ser associado a um ou mais nós TimeoutControl.

    O nó TimeoutNotification processa mensagens de pedido de tempo limite enviadas pelos nós TimeoutControl aos quais ele está associado e propaga cópias das mensagens (ou fragmentos selecionados das mensagens) para o próximo nó no fluxo de mensagens.

  • Um nó TimeoutNotification pode ser utilizado como um nó independente.

    Mensagens geradas são propagadas para o próximo nó no fluxo de mensagens em intervalos de tempo que são especificados na configuração desse nó.

O nó TimeoutNotification está contido no repositório Cronômetro da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó TimeoutNotification

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 um momento específico, ou em intervalos regulares; por exemplo, quando desejar que uma tarefa em lote seja executada todos os dias à meia-noite ou se desejar que informações sobre taxas de câmbio sejam enviadas para bancos em intervalos de horas.

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 sã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. Entretanto, não use o mesmo Identificador Exclusivo para mais de um nó TimeoutNotification.

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

As mensagens de pedido de tempo limite são armazenadas para processamento em uma fila usada pelo nó TimeoutNotification. Por padrão, essa fila é o SYSTEM.BROKER.TIMEOUT.QUEUE. No entanto, você pode usar um serviço configurável de cronômetro para especificar uma fila de tempo limite alternativa, que fornece maior controle sobre o armazenamento de mensagens. Para obter informações sobre como usar uma fila de tempo limite alternativa, consulte Configurando o Armazenamento de Eventos para Nós de Tempo Limite.

Quando um nó TimeoutNotification for iniciado como resultado do início do broker ou pelo fluxo de mensagens que contém o início do nó, ele varrerá seu armazenamento de tempo limite interno e limpará os pedidos de tempo limite não persistentes. São emitidas notificações para quaisquer pedidos de tempo limite persistentes passados e que possuem a propriedade IgnoreMissed configurada como False.

Se você utilizar um nó TimeoutNotification para gerar uma mensagem do WebSphere MQ para um nó de saída, como o nó MQOutput, forneça um MQMD válido. Você também deve fornecer um MQMD válido se o nó TimeoutNotification estiver em execução no modo automático (como um nó independente). Se o nó TimeoutNotification estiver em execução no modo controlado (isto é, ele for pareado com um ou mais nós TimeoutControl), você deverá fornecer um MQMD válido somente se as mensagens armazenadas já não tiverem um MQMD. O seguinte ESQL mostra como fornecer um MQMD válido:
CREATE NEXTSIBLING OF OutputRoot.Properties DOMAIN 'MQMD';
SET OutputRoot.MQMD.Version = MQMD_CURRENT_VERSION;
SET OutputRoot.MQMD.Format = 'XML';
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ó TimeoutNotification 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ó TimeoutNotification são descritos na tabela a seguir.

Terminal Descrição
Falha O terminal de saída para o qual a mensagem será propagada se for detectada uma falha durante o processamento neste nó. Os nós podem ser conectados a este terminal para processar estas falhas. Se esse terminal não estiver conectado a outro nó, as mensagens não serão propagadas e nenhum registro ou armazenamento seguro de dados ocorrerá.
Out O terminal de saída para o qual as mensagens serão propagadas após a expiração de tempos limite.
  • Se o nó TimeoutNotification estiver em execução em modo Automático (ou seja, não existem nós TimeoutControl associados a este nó), as mensagens propagadas conterão apenas uma pasta Propriedades e um LocalEnvironment preenchido com as informações de tempo limite.
  • Se o nó TimeoutNotification estiver em execução em modo Controlado (ou seja, os nós TimeoutControl que estão associados a este nó armazenam pedidos de tempo limite), as mensagens propagadas conterão o que foi armazenado pelos nós TimeoutControl que pode ser mensagens de pedido inteiras ou fragmentos delas.
Se o nó TimeoutNotification for utilizado como o nó de entrada para um fluxo de mensagens que gera uma mensagem do WebSphere MQ (por exemplo, utilizando um nó MQOutput), o fluxo de mensagens deverá criar os cabeçalhos e dados do MQ necessários (por exemplo, MQMD).
Catch O terminal de saída para o qual a mensagem será propagada se for emitida uma exceção no recebimento de dados. Se esse terminal não estiver conectado a outro nó, os seguintes eventos ocorrerão:
  1. O nó TimeoutNotification grava o erro no log de erros local.
  2. O nó TimeoutNotification tenta repetidamente processar o pedido até que o problema que causou a exceção seja resolvido.

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ó TimeoutNotification 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ó: TimeoutNotification O nome do nó.
Descrição curta 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ó TimeoutNotification são descritas na tabela a seguir.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Identificador Exclusivo Sim Sim Nenhum Esta propriedade especifica um valor que é exclusivo no broker e que é igual ao identificador especificado para os nós do TimeoutControl com os quais este nó está ligado (se houver algum). 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ó.

Não utilize o mesmo Identificador Exclusivo para mais de um nó do TimeoutNotification.

uniqueIdentifier
Modo de Transação Não Não Sim O modo de transação para o nó. Se o modo de transação for Automático, uma transação será baseada na persistência das mensagens armazenadas, que é controlada pela propriedade Persistência do Pedido do nó TimeoutControl ao qual ela está associada. Você pode configurar esta propriedade para um dos seguintes valores:
  • Selecione Sim se desejar que uma transação seja iniciada.
  • Selecione Não se não desejar que uma transação seja iniciada.
  • Selecione Automático apenas se tiver configurado Modo de Operação como Controlado. Se uma transação será iniciada depende da persistência dos pedidos de tempo limite armazenados, que é controlada pelo valor de Persistência do Pedido no nó TimeoutControl ao qual ele está associado.
 
Modo de Operação Não Não Automático Esta propriedade indica se este nó está associado a algum dos nós TimeoutControl associados. Os valores válidos são:
  • Se você selecionar Automático, o nó não será associado a nenhum dos nós TimeoutControl. O nó gera pedidos de tempo limite com um intervalo que é controlado pela configuração da propriedade Valor de Tempo Limite, que deve ser um número inteiro positivo.
  • Se você selecionar Controlado, o nó processará todos os pedidos de tempo limite que foram armazenados pelos nós TimeoutControl com os quais ele está associado.
 
Intervalo de Tempo Limite Não Sim 1 O intervalo (em segundos) entre pedidos de tempo limite. Essa propriedade só será relevante se Modo de Operação (Operation Mode) estiver definido como Automático (Automatic).

O valor desta propriedade deve ser um número inteiro positivo.

Se o Modo de Operação for configurado como Automático, o valor da propriedade Intervalo de Tempo Limite será substituído pela propriedade Timeout Interval, se configurada, no serviço configurável Cronômetro.

timeoutInterval

As propriedades das Opções do Analisador para o nó TimeoutNotification são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Sincronização de Análise Não Não On Demand Essa propriedade controla quando a mensagem de tempo limite é analisada. Os valores válidos são On Demand, Imediato e Completo.

Por padrão, esta propriedade é configurada como On Demand, o que faz com que a análise da mensagem seja atrasada. Para que a mensagem seja analisa imediatamente, consulte Analisando On Demand.

Construir árvore utilizando tipos de dados de esquema XML Não Não Desmarcada Esta propriedade controla se o analisador XMLNSC cria elementos de sintaxe na árvore de mensagens com tipos de dados retirados do Esquema XML. Você pode selecionar esta propriedades apenas se configurar a propriedade Validar na guia Validação ou Conteúdo ou Conteúdo e Valor.
Utilizar o Analisador Compacto MQRFH2C para o Domínio MQRFH2 Não Não Desmarcada Esta propriedade controla se o MQRFH2C Compact Parser, no lugar do analisador MQRFH2, é utilizado para cabeçalhos MQRFH2.
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS Não Não Desmarcada Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você definir essa propriedade, os dados da mensagem aparecerão em XMLNSC nos nós que estiverem conectados ao terminal de saída quando o cabeçalho RFH2 de entrada ou o Domínio (Domain) das propriedades padrão for XMLNS.
Reter Conteúdo Misto (Retain Mixed Content) Não Não Nenhuma Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens quando ele encontra texto misto em uma mensagem de tempo limite. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado.
Reter Comentários (Retain Comments) Não Não Nenhum(a) Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens quando ele encontra comentários em uma mensagem de tempo limite. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado.
Reter Instruções de Processamento (Retain Processing Instructions) Não Não Nenhum(a) Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens quando ele encontra instruções de processamento em uma mensagem de tempo limite. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado.
Elementos opacos Não Não Branco Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de tempo limite que devem ser analisados em segundo plano pelo analisador XMLNSC. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada.

As propriedades Validação do nó TimeoutNotification são descritas na tabela a seguir.

Se uma mensagem for propagada para o terminal de Falha do nó, ela não será validada. Para obter informações adicionais, consulte Validando Mensagens e Propriedades de Validação.
Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Nenhum(a) Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Conteúdo e Valor. validateMaster
Ação de Defeito Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.  
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:28


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