Utilize o nó TryCatch para fornecer um manipulador especial para processamento de exceções.
Este tópico contém as seguintes seções:
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 WebSphere Message Broker Toolkit pelo seguinte ícone:
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.
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.
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.
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.
O nó propaga a mensagem para a sequência de nós conectada ao terminal Catch (o fluxo de captura) e a manipulação de erros projetada é iniciada. O conteúdo da árvore de mensagens que é propagado é idêntico ao conteúdo que foi propagado para o terminal de Tentativa, que é o conteúdo da árvore quando o nó TryCatch o recebeu pela primeira vez. O nó aprimora a árvore de mensagens com as novas informações da exceção que ele gravou na árvore da lista de exceções. Quaisquer modificações ou adições que os nós no fluxo de tentativa fizeram na árvore de mensagens não estão presentes na árvore de mensagens que é propagada ao fluxo de captura.
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.
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ó. |
Capturar | 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. |
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. |