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

Throw

Use o nó Throw para emitir uma exceção em um fluxo de mensagens.

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

Finalidade

Uma exceção pode ser capturada e processada por:

  • Um nó TryCatch precedente
  • O nó de entrada do fluxo de mensagens (os nós integrados, por exemplo, HTTPInput e MQInput, têm terminais Catch)
  • Um nó AggregateReply precedente

Inclua um nó Throw para forçar um caminho de erro pelo fluxo de mensagens se o conteúdo da mensagem contiver dados inesperados. Por exemplo, para retornar uma mensagem que não contenha um campo particular, é possível verificar (usando um nóFilter) se o campo existe; se o campo não existir , a mensagem pode ser passada para um nó Throw que registre detalhes sobre a exceção na subárvore da lista de exceções da mensagem.

O nó Throw está contido no repositório Construção da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

 Ícone do nó Throw

Utilizando este nó em um fluxo de mensagens

Veja as amostras a seguir para consultar sobre como utilizar este nó:

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.

Inclua um nó Throw com um nó TryCatch em seu fluxo de mensagens para alertar o administrador de sistemas sobre uma possível situação de erro; por exemplo, se você tiver um nó Compute que calcula um número, teste o resultado deste cálculo e emita uma exceção se o resultado exceder uma determinada quantidade. O nó TryCatch captura esta exceção e propaga a mensagem para uma seqüência de nós que processam o erro.

Terminais e Propriedades

Quando tiver colocado uma instância do nó Throw 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.

O terminal do nó Throw é descrito na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.

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ó Throw são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome de nó Não Não O tipo de nó: Throw 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ó Throw são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Catálogo de Mensagens Não Não   O nome do catálogo de mensagens a partir do qual o texto do erro para o número do erro da exceção é extraído. Digite o caminho completo e o nome do arquivo do catálogo de mensagens que contém a origem da mensagem. Esse arquivo pode ser seu próprio catálogo de mensagens ou o catálogo de mensagens padrão fornecido com o WebSphere Message Broker. Para utilizar o catálogo padrão fornecido, deixe essa propriedade em branco.
Número da Mensagem Não Não 3001 O número do erro da exceção que está sendo lançada.
  • Se você tiver criado seu próprio catálogo de mensagens, insira o número para a mensagem no catálogo que deseja utilizar quando essa exceção for emitida.
  • Se você estiver utilizando o catálogo de mensagens padrão, especifique um número entre 3001 (o padrão) e 3049. Estes números são reservados no catálogo padrão para utilização. O texto de cada uma dessas mensagens no catálogo de mensagens padrão é idêntico, mas é possível usar um número diferente nesse intervalo para cada situação na qual você emite uma exceção; use o número para identificar a causa exata do erro.
Texto da mensagem Não Não   Texto adicional que explica a causa do erro. Digite qualquer texto de formato livre adicional que contenha informações que você deseja incluir com a mensagem quando ela for gravada no log de erros local; por exemplo, se você tiver verificado a existência de um campo específico em uma mensagem e lançado uma exceção quando esse campo não foi localizado, poderá incluir o texto:
A mensagem não continha o campo requerido: Número do desvio
Se você estiver utilizando o catálogo de mensagens padrão, esse texto será inserido como &1 no texto da mensagem.
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:19


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