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 ambiente de trabalho 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 utilize o mesmo Identificador Exclusivo para
mais de um nó do TimeoutNotification.
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.
CREATE NEXTSIBLING OF OutputRoot.Properties DOMAIN 'MQMD'; SET OutputRoot.MQMD.Version = MQMD_CURRENT_VERSION; SET OutputRoot.MQMD.Format = 'XML';
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.
|
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 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.
|
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 | 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. |