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:
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:
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.
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.
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ó 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:
|
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. |
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. |