Utilice el nodo Throw para generar una excepción dentro de un flujo de mensajes.
Este tema contiene las secciones siguientes:
Puede captarse y procesarse una excepción mediante:
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 WebSphere Message Broker Toolkit por el siguiente icono:
Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.
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.
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. 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 del 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.
|
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:
Si está utilizando el catálogo
de mensajes predeterminado, este texto se inserta como &1
en el texto del mensaje. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Sucesos | No | No | Ninguno | Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y
Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles. Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado. |