El árbol del entorno local tiene su propio nombre de correlación,
LocalEnvironment, y debe utilizarlo en todas las sentencias ESQL que hacen referencia o
establecen el contenido de este árbol.
El árbol del entorno local lo utiliza el intermediario y puede hacer referencia al mismo y modificar esta información. También puede ampliar el árbol para que contenga la información que ha creado.
En este árbol puede crear subárboles que puede utilizar como área de borrador o entorno de trabajo.
El flujo de mensajes establece la información en dos subárboles, Destination y WrittenDestination, debajo de la raíz
LocalEnvironment. Puede hacer referencia al contenido de ambos subárboles y puede
escribir en el árbol de destino para influir en el modo en que el flujo de mensajes
procesa el mensaje. Sin embargo, si escribe en el árbol de destino, siga la estructura definida para
asegurar que el árbol sigue siendo válido.
El subárbol WrittenDestination
contiene las direcciones en las que se ha escrito el mensaje. Su nombre es fijo y el flujo de mensajes crea dicho subárbol cuando se propaga un mensaje a través del terminal de salida (Out) de un nodo de petición, de salida o de respuesta. El subárbol incluye información específica del transporte
(por ejemplo, si el mensaje de salida se ha transferido a una cola de
WebSphere MQ, incluye el gestor de cola y
los nombres de cola). Puede utilizar uno de los métodos siguientes
para obtener información sobre los detalles de un mensaje después de que los nodos
lo hayan enviado:
- Conecte un nodo Compute al terminal de salida (Out).
- Configure una salida de usuario para procesar un suceso de devolución de llamada de
mensaje de salida, como se describe en
Aprovechar las salidas de usuario.
El tema para cada nodo que da soporte a la información WrittenDestination contiene detalles sobre los datos que contiene.
Si
desea que se incluya el árbol del entorno local en el mensaje de salida propagado
por el nodo Compute, debe establecer
la propiedad de nodo Compute
Modalidad de cálculo en un valor que
incluya el entorno local (por ejemplo Todo). Si no es así, el árbol del entorno local no se copia e el mensaje de salida.
La información que inserte en DestinationData o Defaults
depende de las características de la propiedad del nodo correspondiente:
- Si una propiedad de nodo se representa mediante un recuadro de selección
(por ejemplo Nuevo ID de mensaje),
establezca el elemento Defaults o DestinationData
en Yes (equivalente a la selección del
recuadro de selección) o No (equivalente
a borrar la marca de selección del recuadro).
- Si una propiedad de nodo se representa mediante una lista desplegable
(por ejemplo Modalidad de transacción),
establezca el elemento Defaults o DestinationData
en la serie de caracteres apropiada (por ejemplo
Automatic).
- Si se representa una propiedad del nodo mediante un campo de entrada de texto, por ejemplo, Nombre del gestor de colas, establezca el elemento Defaults o DestinationData en la serie de caracteres que entraría en este campo.
Si es necesario, configure el nodo de envío para indicar dónde está la información
de destino. Por ejemplo, para el nodo de salida
MQOutput,
establezca Modalidad de destino:
- Si establece la Modalidad de destino en Nombre de cola, se envía el mensaje de salida a la cola identificada en las propiedades del nodo de salida Nombre de cola y Nombre del gestor de colas. El nodo no hace referencia al destino.
- Si establece Modalidad de destino en Lista de destinos, el nodo extrae la información de destino del subárbol Destination. Si utiliza este valor, puede enviar un solo mensaje a varios destinos, si configura
correctamente Destination y un solo nodo de salida. El nodo sólo comprueba las propiedades del nodo si no hay
disponible un valor en Destination (como se ha descrito anteriormente).
- Si establece Modalidad de destino en Cola de respuestas, el mensaje se envía a la cola de respuestas identificada en el MQMD de este mensaje (campo
ColaRespuestas) El nodo no hace referencia al destino.
Para ver más
información sobre los procedimientos ESQL que realizan actualizaciones habituales en el entorno
local, consulte Llenar el destino en el árbol del entorno local.
Revise las sentencias de ESQL de estos procedimientos para ver cómo se debe modificar
el entorno local. Puede utilizar estos procedimientos sin cambiarlos, o
modificarlos según sus necesidades.
Para ver más información sobre cómo ampliar el contenido de
este árbol para sus fines, consulte Utilización de áreas de anotación en el entorno local.
Para
ver otro ejemplo sobre la utilización del entorno local para modificar el comportamiento
de un flujo de mensajes, consulte el flujo de mensajes de XML_PassengerQuery en el
siguiente programa
nsajssample:
El
nodo
Compute de este flujo de mensajes graba
una lista de destinos en el subárbol RouterList de Destination
que utiliza como etiquetas el nodo
RouteToLabel posterior que propaga el mensaje
al nodo
Label correspondiente.
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.