Utilize o nó TimeoutNotification para gerenciar fluxos de mensagens dependentes de tempo limite.
Este tópico contém as seguintes seções:
O nó TimeoutNotification é um nó de entrada que você pode utilizar de duas formas:
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.
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:
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.
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.
CREATE NEXTSIBLING OF OutputRoot.Properties DOMAIN 'MQMD';
SET OutputRoot.MQMD.Version = MQMD_CURRENT_VERSION;
SET OutputRoot.MQMD.Format = 'XML';
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.
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.
|
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:
|
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:
|
|
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:
|
|
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. |
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. |