Nodo Throw

Utilice el nodo Throw para generar una excepción dentro de un flujo de mensajes.

Este tema contiene las secciones siguientes:

Finalidad

Puede captarse y procesarse una excepción mediante:

  • Un nodo TryCatch anterior.
  • El nodo de entrada del flujo de mensajes (los nodos incorporados, por ejemplo HTTPInput y MQInput, tienen terminales de captación)
  • Un nodo AggregateReply anterior.

Incluya un nodo Throw para forzar una ruta de errores a través del flujo de mensajes si el contenido del mensaje contiene datos inesperados. Por ejemplo, para restituir un mensaje que no contenga un campo determinado, puede comprobar (utilizando un nodo Filter) si el campo existe; si el campo no existe, el mensaje se puede pasar a un nodo Throw que registre detalles acerca de la excepción en el subárbol de lista de excepciones de dentro del mensaje.

El nodo Throw se encuentra en la bandeja Construcción de la paleta y está representado en el entorno de trabajo por el siguiente icono:

Icono del nodo Throw

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo: Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.

Incluya un nodo Throw con un nodo TryCatch en el flujo de mensajes para avisar el administrador del sistema de una situación de error potencial; por ejemplo, si tiene un nodo Compute que calcule un número, pruebe el resultado de ese cálculo y genere una excepción si el resultado sobrepasa un cierto valor. El nodo TryCatch capta esa excepción y propaga el mensaje a una secuencia de nodos que procese el error.

Terminales y propiedades

Cuando haya colocado una instancia del nodo Throw en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Para visualizar las propiedades del nodo en el diálogo Propiedades, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

El terminal del nodo Throw está descrito en la tabla siguiente.

Terminal Descripción
In (de entrada) El terminal de entrada que acepta un mensaje para que lo procese el nodo.

Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).

Las propiedades de Descripción del nodo Throw están descritas en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo: Throw El nombre del nodo.
Descripción corta No No   Descripción breve del nodo.
Descripción larga No No   Texto que describe el propósito del nodo en el flujo de mensajes.

Las propiedades básicas del nodo Throw se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Catálogo de mensajes No No   Nombre del catálogo de mensajes desde el que se extrae el texto de error que corresponde al número de error de la excepción. Escriba el nombre de archivo y vía de acceso totalmente calificada del catálogo de mensajes que contiene el origen del mensaje. Este archivo puede ser su propio catálogo de mensajes o el catálogo de mensajes predeterminado que se proporciona con WebSphere Message Broker. Para utilizar este último, deje esta propiedad vacía.
Número de mensaje No No 3001 Número de error de la excepción que se ha generado.
  • Si ha creado su propio catálogo de mensajes, entre el número para el mensaje en el catálogo que desee utilizar cuando se genere la excepción.
  • Si va a utilizar el catálogo de mensajes predeterminado, especifique un número entre 3001 (valor predeterminado) y 3049. Estos números están reservados en el catálogo predeterminado para su uso. En el catálogo de mensajes predeterminado, el texto de cada uno de estos mensajes es idéntico, pero puede utilizar un número distinto dentro de ese rango para cada situación en la que genera una excepción; utilice el número para identificar la causa exacta del error.
Texto del mensaje No No   Texto adicional que indica la causa del error. Entre, en formato libre, texto adicional con la información que desee incluir con el mensaje cuando éste se grabe en las anotaciones de error locales; por ejemplo, si ha comprobado que existía un campo determinado de un mensaje y se ha generado una excepción al no encontrar el campo, puede incluir el texto:
El mensaje no contenía
el campo necesario: Número de sucursal
Si está utilizando el catálogo de mensajes predeterminado, este texto se inserta como &1 en el texto del mensaje.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:53:44

ac04830_