Nodo Throw

Este tema contiene las secciones siguientes:

Finalidad

Utilice el nodo Throw para generar una excepción dentro de un flujo de mensajes. La excepción puede captarla y procesarla:

  • Un nodo TryCatch precedente
  • El nodo de entrada de flujo de mensajes (todos los nodos incorporados HTTPInput, MQInput, y SCADAInput tienen terminales de captación)
  • Un nodo AggregateReply anterior

Puede incluir 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 no existe, el mensaje puede pasarse a un nodo Throw que registre detalles sobre la excepción en el subárbol de lista de detalles dentro del mensaje.

El nodo Throw se representa en el entorno de trabajo con 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:

Incluya un nodo Throw con un nodo TryCatch en el flujo de mensajes para alertar al administrador del sistema de una situación de error potencial. Por ejemplo, si tiene un nodo Compute que calcula un número, puede probar el resultado de este cálculo y generar una excepción si el resultado sobrepasa un cierto valor. El nodo TryCatch capta esta excepción y propaga el mensaje a una secuencia de nodos que procesan el error.

Configuración del nodo Throw

Cuando se haya transferido una instancia del nodo Throw a un flujo de mensajes, podrá configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y seleccione Propiedades. Aparecen las propiedades básicas del nodo.

Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor por omisión) aparecen con un asterisco en el diálogo de propiedades.

Configure el nodo Throw de la manera siguiente:

  1. En Catálogo de mensajes, entre el nombre de archivo y vía de acceso totalmente calificada del catálogo de mensajes que contiene el origen del mensaje. Puede ser su propio catálogo de mensajes o el catálogo de mensajes por omisión que se proporciona con WebSphere Message Broker. Para utilizar este último, deje esta propiedad vacía.
  2. En Número de mensaje, entre el 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 utiliza el catálogo de mensajes por omisión, especifique un número entre 3001 y 3049. Estos números están reservados en el catálogo de WebSphere Message Broker para su uso. En el catálogo de mensajes por omisión, 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.

    El número de mensaje por omisión es 3001.

  3. En Texto del mensaje, entre, en formato libre, el 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 si 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 por omisión, este texto se inserta como &1 en el texto del mensaje.
  4. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  5. Pulse Aplicar para efectuar los cambios en el nodo Throw sin cerrar el diálogo de propiedades. Pulse Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse Cancelar para cerrar el diálogo y eliminar todos los cambios que ha efectuado en las propiedades.

Terminales y propiedades

El terminal del nodo Throw se describe en la siguiente tabla.

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 en el diálogo de propiedades si tiene que entrar un valor cuando no hay definido ningún valor por omisión), 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 básicas del nodo Throw se describen en la siguiente tabla.

Propiedad O C Valor por omisión 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. El valor por omisión (espacio en blanco) indica que el mensaje se toma del catálogo de mensajes que se proporciona con WebSphere Message Broker.
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.

Las propiedades de descripción del nodo Throw se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
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.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ac04830_