TryCatch

Utilize o nó TryCatch para fornecer um manipulador especial para processamento de exceções.

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

Propósito

Inicialmente, a mensagem de entrada é roteada no terminal Try, que você deve conectar aos nós de processamento sem erro restantes do fluxo de mensagens. Se um nó de recebimento de dados (que pode ser um nó Throw) emitir uma exceção, o nó TryCatch a capturará e roteará a mensagem original para seu terminal Catch. Conecte o terminal Catch a nós adicionais para fornecer processamento de erro para a mensagem após uma exceção. Se o terminal Catch estiver conectado, a mensagem será propagada para ele. Se o terminal Catch não estiver conectado, a mensagem será descartada.

O nó TryCatch está contido no repositório Construção da paleta e é representado no ambiente de trabalho pelo seguinte ícone:

 Ícone do nó TryCatch

Utilizando este nó em um fluxo de mensagens

Examine a amostra a seguir para ver como utilizar esse nó: Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers Toolkit.

Utilize os nós Throw e TryCatch quando utilizar o nó Compute para calcular um total. Você pode criar uma mensagem que seja enviada ao administrador do sistema quando o total calculado exceder o valor máximo do campo Total.

Conectando Terminais

O nó TryCatch não possui propriedades configuráveis que afetam sua operação. Você determina como ele opera, conectando os terminais de saída aos nós subseqüentes em seu fluxo de mensagens.

  1. Conecte o terminal Try ao primeiro nó na seqüência de nós que fornece a fase normal (sem erro) de processamento dessa mensagem. Essa seqüência pode conter um ou mais nós que executam qualquer processamento válido. A seqüência de nós pode opcionalmente ser concluída com um nó de saída.
  2. Conecte o terminal Catch ao primeiro nó na seqüência de nós que fornece o processamento de erro para esse fluxo de mensagens. Essa seqüência pode conter um ou mais nós que executam qualquer processamento válido. A seqüência de nós pode opcionalmente ser concluída com um nó de saída.

    Quando for emitida uma exceção no fluxo de mensagens, pela utilização explícita do nó Throw ou pela instrução ESQL THROW ou pelo intermediário que gera uma exceção implícita quando detecta um erro que o fluxo de mensagens não está programado para manipular, o controle retorna ao nó TryCatch.

    A mensagem é propagada através do terminal Catch e o tratamento de erros projetado é executado. A mensagem que é propagada através desse terminal possui o conteúdo que possuía no ponto em que a exceção foi emitida, incluindo a descrição completa da exceção em Lista de Exceção.

Terminais e Propriedades

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

Os terminais do nó TryCatch são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Catch O terminal de saída para o qual a mensagem será propagada se for emitida uma exceção downstream e capturada por esse nó.
Teste O terminal de saída para o qual a mensagem será propagada se não for capturada.

A tabela a seguir descreve 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ó TryCatch 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ó: TryCatch 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.
Referências relacionadas
Nó Throw
Nó Trace
Instrução THROW
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:44

ac04850_