Árbol ExceptionList

El árbol ExceptionList forma parte del árbol lógico de mensajes en el que el flujo de mensajes escribe información acerca de las excepciones que se producen cuando se procesa un mensaje.

El directorio raíz del árbol ExceptionList se denomina ExceptionList y el árbol consta de un conjunto de cero o más descripciones de excepciones. El flujo de mensajes llena el árbol ExceptionList si se produce una excepción. Si no se produce ninguna condición de excepción durante el proceso del flujo de mensajes, la lista de excepciones asociada al mensaje consta únicamente del elemento del directorio raíz. Es decir, una lista de excepciones vacía.

Otros nodos del flujo de mensajes que reciben el mensaje después de producirse la excepción, pueden acceder al árbol ExceptionList. Su contenido sólo se puede modificar en el nodo Compute.

Si se produce una condición de excepción, se suspende el proceso del mensaje y se emite una excepción. El control se pasa a un nivel superior, es decir, un bloque de captación que lo incluye. Una ExceptionList se crea para describir la condición de anomalía y, el mensaje completo, junto con LocalEnvironment y la recién llenada ExceptionList, se propagan a través de una vía de acceso de flujos de mensajes de manejo de excepciones.

El elemento dependiente de ExceptionList siempre es RecoverableException. Por lo general, siempre hay un único elemento dependiente del directorio raíz, aunque en determinadas circunstancias se puede generar más de uno. El elemento dependiente de ExceptionList contiene varios elementos dependientes, el último de los cuales proporciona información más específica sobre el tipo de excepción, que puede ser uno de los siguientes.:

Más abajo se muestra la estructura del árbol de la lista de excepciones para una RecoverableException:



La estructura de la descripción de la excepción se puede repetir o anidar para producir un árbol ExceptionList. En este árbol:

Los elementos dependientes del árbol toman el formato de un varios elementos de 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) que se identifica en un elemento de nombre-valor identifica un mensaje de error de WebSphere Business Integration Message Broker. Los valores de Insert se utilizan para sustituir las variables de este mensaje y proporcionar más detalles sobre la causa de la excepción.

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

Nombre Tipo Descripción
File1 String Nombre archivo de origen C++
Line1 Integer Número de línea del archivo de origen C++
Function1 String Nombre de función de origen C++
Type2 String Tipo de objeto de origen
Name2 String Nombre de objeto de origen
Label2 String Etiqueta de objeto de origen
Text1 String Texto adicional
Catalog3 String Nombre de catálogo de mensajes NLS4
Severity3 Integer

1 = información
2 = aviso
3 = error

Number3 Integer Número de mensaje NLS4
Insert3 Type Integer El tipo de datos del valor:

0 = Unknown (desconocido)
1 = Boolean (booleano)
2 = Integer (entero)
3 = Float (flotante)
4 = Decimal
5 = Character (carácter)
6 = Time (hora)
7 = GMT Time (hora GMT)
8 = Date (fecha)
9 = Timestamp (indicación de la hora)
10 = GMT Timestamp (indicación de la hora GMT)
11 = Interval (intervalo)
12 = BLOB (Binary Large Object)
13 = Bit Array (matriz de bits)
14 = Pointer (puntero)

Text String El valor de los datos
Notes:
  1. No utilice los elementos File, Line, Function y Text para la toma de decisiones de manejo de excepciones. Estos elementos garantizan que la información se pueda escribir en las anotaciones para que la utilice el personal de servicio técnico de IBM.
  2. Los elementos Type, Name y Label definen el objeto (generalmente, un nodo de flujo de mensajes) que estaba procesando el mensaje al producirse la condición de excepción.
  3. Los elementos Catalog, Severity y Number definen un mensaje NLS: los elementos Insert que contienen ambos elementos de nombre-valor que se muestran para definir las inserciones en el 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 y a un número de mensaje que se puede convertir.

Una vez que se ha completado el proceso de flujo de mensajes, el árbol ExceptionList se descarta.

Conceptos relacionados
Flujos de mensajes
Contenido del árbol después de una excepción
Diseño de mensajes

Tareas relacionadas
Desarrollo de aplicaciones de flujos de mensajes
Manejo de errores en flujos de mensajes
Acceso al árbol ExceptionList
Generación de una excepción

Referencia relacionada
Nodos incorporados
Nodo Compute