TimeoutNotification

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

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

Propósito

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 ambiente de trabalho pelo seguinte ícone:

Ícone de Nó de Notificação de Tempo

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.

Início da mudançaVocê 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 utilize o mesmo Identificador Exclusivo para mais de um nó do TimeoutNotification.Fim da mudança

Quando um nó TimeoutNotification for iniciado como resultado do início do intermediário 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ê 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ó 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. 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ó TimeoutNotification são descritos na tabela a seguir.

Terminal Descrição
Failure 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 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ó TimeoutNotification são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Identificador Exclusivo Sim Sim Nenhum(a) Esta propriedade especifica um valor que é exclusivo no intermediário 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.

Início da mudançaNão utilize o mesmo Identificador Exclusivo para mais de um nó do TimeoutNotification.Fim da mudança

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.
  • 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 Não 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).

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 validação seja atrasada até que ela seja analisada pela análise parcial. Se você alterar esse valor para Imediato (Immediate), a análise parcial será substituída e tudo o que estiver na mensagem será analisado e validado, exceto aqueles tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não possam ser resolvidos no momento. Se você alterar esse valor para Completo (Complete), a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado; tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não podem ser resolvidos no momento causam falha de validação.

Utilizar o Analisador Compacto MQRFH2C para o Domínio MQRFH2 Não Não Não Selecionada 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 Não Selecionada 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 Nenhuma 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 Nenhuma 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.

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

Se uma mensagem for propagada para o terminal Failure 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
Validar Não Sim Nenhuma Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Conteúdo e Valor.
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.
Incluir Todas as Limitações do Valor Não Não Selecionado Não é possível editar essa propriedade. Se essa caixa de opções for selecionada, verificações básicas de limitação de valor serão incluídas na validação Conteúdo e Valor (Content and Value).
  Não Não Nenhuma Não é possível editar essa propriedade.
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

ac20802_