WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Estructura del árbol de lista de excepciones

El árbol de lista de excepciones es una parte del árbol lógico de mensajes en la que el flujo de mensajes graba información sobre las excepciones que se producen cuando se procesa un mensaje.

El elemento raíz del árbol de lista de excepciones se denomina Lista de excepciones, y el árbol consta de un conjunto de cero o más descripciones de excepciones. Si se produce una excepción, el flujo de mensajes rellena el árbol de lista de excepciones. Si no se producen condiciones de excepción durante el proceso del flujo de mensajes, la lista de excepciones asociada a ese mensaje sólo consta de un elemento raíz. Es decir, de hecho, una lista de excepciones vacía.

Al árbol de lista de excepciones pueden acceder otros nodos dentro del flujo de mensajes que reciban el mensaje después de que se produzca la excepción. El contenido del árbol de lista de excepciones sólo se puede modificar en un nodo que proporcione una interfaz para modificar el árbol de mensajes de salida; por ejemplo, el nodo Compute.

Si se produce una condición de excepción, se suspende el proceso del mensaje y se genera una excepción. El control se devuelve a un nivel superior; es decir, a un bloqueo de captación que lo incluye. Se genera una lista de excepciones para describir la condición del error, y el mensaje entero, junto con el árbol de entorno local y la lista de excepciones que se acaba de rellenar, se propagan a través de una ruta de flujo de mensajes de manejo de excepciones.

El hijo de ListaExcepciones puede ser cualquiera de los tipos de excepción que se incluyen en la lista siguiente. Normalmente sólo se crea un hijo del elemento raíz, aunque en ciertas circunstancias puede generarse más de uno. El hijo de ListaExcepciones contiene una serie de hijos, cada uno de los cuales puede ser también cualquiera de los tipos de la lista siguiente. El último de estos hijos proporciona información adicional específica del tipo de excepción.

La figura siguiente muestra la estructura del árbol de lista de excepciones para una excepción recuperable:

Estructura de un árbol de lista de excepciones para una excepción recuperable

La estructura de la descripción de excepción se puede repetir y anidar para generar un árbol de lista de excepciones. En este árbol:

Los hijos en el árbol toman la forma de varios elementos nombre-valor que proporcionan detalles de la excepción, y cero o más elementos de nombre cuyo nombre es Insert. El número de mensaje NLS (Soporte de idioma nacional) identificado en un elemento nombre-valor identifica un mensaje de error de WebSphere Message Broker. Los valores Insert se utilizan para sustituir las variables dentro de este mensaje y proporcionan detalles adicionales sobre la causa de la excepción.

Los elementos nombre-valor dentro de la lista de excepciones que se muestran en la figura anterior se describen en la tabla siguiente.

Nombre Tipo Descripción
File1 Serie Nombre del archivo fuente C++
Line1 Entero Número de línea del archivo fuente C++
Function1 Serie Nombre de la función fuente C++
Type2 Serie Tipo del objeto fuente
Name2 Serie Nombre del objeto fuente
Label2 Serie Etiqueta del objeto fuente
Text1 Serie Texto opcional no NLS
Catalog3 Serie Nombre del catálogo de mensajes NLS4
Severity3 Entero

1 = información
2 = aviso
3 = error

Number3 Entero Número del mensaje NLS4
Insert3 Tipo Entero El tipo de datos del valor:

0 = Desconocido
1 = Booleano
2 = Entero
3 = Flotante
4 = Decimal
5 = Carácter
6 = Hora
7 = Hora GMT
8 = Fecha
9 = Fecha y hora
10 = Fecha y hora GMT
11 = Intervalo
12 = BLOB
13 = Matriz de bits
14 = Puntero

Text Serie El valor de los datos
Notas:
  1. No utilice los elementos File, Line, Function y Text para la toma de decisiones en el manejo de excepciones. Estos elementos aseguran que se pueda grabar información en un archivo de registro para que lo utilice el personal de servicio de IBM® y están sujetos a cambios en el contenido y el orden.
  2. Los elementos Type, Name y Label definen el objeto (normalmente un nodo de flujo de mensajes) que estaba procesando el mensaje cuando se produjo la condición de excepción.
  3. Los elementos Catalog, Severity y Number definen un mensaje NLS: los elementos Insert que contienen los dos elementos nombre-valor que se muestran definen las inserciones en ese mensaje NLS.
  4. El nombre del catálogo de mensajes NLS y el número de mensaje NLS hacen referencia a un catálogo de mensajes que se pueden traducir y un número de mensaje.

Cuando se ha completado el flujo de mensajes, se descarta el árbol de lista de excepciones.

El siguiente ejemplo utiliza la lista de excepciones del flujo de mensajes de XML_Reservation para pasar información sobre errores al nodo Throw que genera un mensaje de error que incluye la información de la lista de excepciones:

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.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:16


Tema de conceptoTema de concepto | Versión 8.0.0.5 | ac00540_