Árbol de propiedades

El árbol de propiedades es el primer elemento del árbol de mensajes y contiene información sobre las características del mensaje.

El directorio raíz del árbol de propiedades se denomina Properties. Es el primer elemento bajo Root. Todos los árboles de mensajes que generan los analizadores incorporados incluyen un árbol de propiedades para el mensaje. Si crea su propio analizador definido por el usuario, puede elegir si desea que el analizador cree un árbol de propiedades. Sin embargo, para que exista mayor coherencia, se recomienda incluir esta acción en el analizador definido por el usuario.

El árbol de propiedades se crea e inserta en el árbol después de todas las cabeceras, pero antes de los datos del mensaje. Contiene un conjunto de propiedades estándar que se pueden manipular en los nodos de flujos de mensajes utilizando el mismo procedimiento que para cualquier otra propiedad. La mayoría de estos campos se correlacionan con campos de las cabeceras WebSphere MQ para las que se ofrece soporte, si están presentes, y se pasan al analizador adecuado cuando se entrega el mensaje de un nodo a otro.

Por ejemplo, la cabecera MQRFH2 contiene información sobre el conjunto de mensajes, el tipo y el formato. Estos valores se almacenan en el árbol de propiedades como MessageSet, MessageType y MessageFormat. Para acceder a estos valores utilizando ESQL en los nodos de proceso del mensaje, consulte los valores del árbol de propiedades; no haga referencia directamente a los campos de las cabeceras desde las que se han derivado.

Si el mensaje se convierte a una corriente de bits, por ejemplo, en un nodo de salida, todas las propiedades que permanecen únicamente en el árbol de propiedades (es decir, no en cualquiera de las cabeceras de los mensajes de salida) no se incluyen en parte alguna del mensaje de salida.

El analizador de propiedades garantiza que los valores de los campos de cabecera coincidan con los valores del árbol de propiedades al entrar o salir de cada nodo. Al salir de un nodo, el analizador de propiedades invoca cada analizador de cabeceras con los valores que contiene actualmente. A continuación, solicita los valores del analizador de cabeceras y actualiza sus propios valores. Si ha codificado ESQL en el nodo que actualiza valores en el árbol de propiedades, o bien, en la cabecera, o ambos, estos valores siempre coinciden con el árbol que se pasa desde el nodo. Sin embargo, si actualiza un campo del árbol de propiedades y la cabecera con valores diferentes, el valor que establece en el árbol de propiedades se escribe encima del valor que se establece en la cabecera.

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

Conceptos relacionados
Diseño de mensajes
Nombres de correlación

Tareas relacionadas
Desarrollo de aplicaciones de flujos de mensajes
Acceso al árbol Propiedades

Referencia relacionada
Nodos incorporados