Nodo AggregateReply

Utilice el nodo AggregateReply para marcar el final de un abanico de entrada de agregación. Este nodo recopila respuestas y las combina en un solo mensaje compuesto.

Este tema contiene las secciones siguientes:

Finalidad

La agregación es una ampliación del modelo de aplicación petición/respuesta. Combina la generación y la salida en abanico de varias peticiones relacionadas con la recepción de las diversas respuestas correspondientes, y compila estas respuestas en un solo mensaje de respuesta agregado.

La función de agregación la proporcionan los tres nodos siguientes:

  • El nodo AggregateControl marca el principio de un abanico de salida de peticiones que forman parte de una agregación. Envía un mensaje de control que utiliza el nodo AggregateReply para compara las distintas peticiones que se han realizado. La información que se propaga desde el terminal de Control incluye el identificador de intermediario, la propiedad de nombre de agregación y la propiedad de tiempo de espera. La información de agregación añadida al entorno del mensaje por el nodo AggregateControl no se debe cambiar.
  • El nodo AggregateRequest registra el hecho de haber enviado los mensajes de petición. También recopila información que ayuda al nodo AggregateReply a crear el mensaje de respuesta agregado. La información añadida al entorno de mensajes por AggregateRequest se debe conservar, de lo contrario, la agregación fallará.
  • El nodo AggregateReply marca el final de un abanico de entrada de agregación. Recopila respuestas y las combina en un solo mensaje de respuesta agregado.

El nodo AggregateReply se encuentra en la bandeja Direccionamiento de la paleta y está representado en el entorno de trabajo mediante el siguiente icono:

Icono de nodo AggregateReply

Cuando el nodo AggregateReply almacena mensajes de entrada antes de que se reciban todas las respuestas para la agregación, la persistencia del mensaje determina si éste perdurará después de un reinicio.

Si durante una agregación, el nodo AggregateReply no recibe uno o varios de los mensajes de respuesta, el tiempo de espera normal o el proceso de mensajes desconocido se encarga de las respuestas que ya se han recibido.

El valor MQMD.Expiry de cada mensaje AggregateReply se establece en -1 en el mensaje compuesto de salida. Este valor se establece debido a que el valor MQMD.Expiry no tiene ningún significado cuando el mensaje de respuesta ya no está en WebSphere MQ Transport y el intermediario lo ha almacenado durante el proceso de agregación.

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo: Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.

Terminales y propiedades

Cuando haya colocado una instancia del nodo AggregateReply en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Para visualizar las propiedades del nodo en el diálogo Propiedades, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Los terminales del nodo AggregateReply están descritos en la siguiente tabla.

Terminal Descripción
Control El terminal de entrada que acepta mensajes de control enviados por un nodo AggregateControl correspondiente.

El terminal de Control ya no se utiliza en la Versión 6.0; para utilizar conexiones al terminal de Control, consulte Utilizar mensajes de control en flujos de agregación.

In (de entrada) El terminal de entrada que acepta un mensaje para que lo procese el nodo.
Failure (de anomalías) El terminal de salida al que se dirige un mensaje si se ha detectado una anomalía durante su proceso.
Unknown (desconocido) El terminal de salida al que se dirigen los mensajes cuando no pueden identificarse como mensajes de respuesta válidos.
Out (de salida) El terminal de salida al que se dirige el mensaje compuesto cuando el proceso termina correctamente.
Timeout (de tiempo de espera) El terminal de salida al que se direcciona el mensaje compuesto incompleto cuando ha transcurrido el intervalo de tiempo de espera excedido especificado en el nodo AggregateControl correspondiente.
Catch (de captación) El terminal de salida al que se dirige un mensaje si se genera una excepción en sentido descendente y después este nodo la capta.

Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); 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).

En la tabla siguiente se describen las propiedades de descripción del nodo AggregateReply.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo (AggregateReply) El nombre del nodo.
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.

Las propiedades básicas del nodo AggregateReply se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Nombre de agregación   Nombre que se utiliza para asociar el flujo de mensajes de abanico de entrada con el flujo de mensajes de abanico de salida. Ha de ser un nombre único en el intermediario.
Tiempo de espera de mensaje desconocido No No 0 Periodo de tiempo, en segundos, durante el cual se retienen los mensajes que no se pueden identificar como respuestas antes de propagarse al terminal Unknown (desconocido).

El valor predeterminado es cero; si lo acepta, se inhabilita el tiempo de espera y los mensajes desconocidos se propagan al terminal Unknown tras su recepción.

z/OS platform En z/OS, si la propiedad de tiempo de espera de mensaje desconocido no se establece en cero, establezca el parámetro de gestor de colas EXPRYINT en 5.

Modalidad de transacción No Seleccionado Esta propiedad define las características transaccionales de este mensaje:
  • Si selecciona el recuadro (valor predeterminado), el flujo de mensajes siguiente estará bajo el control de la transacción. Este valor también es cierto para los mensajes que se obtienen del mensaje de salida y la salida la realiza un nodo MQOutput a menos que el nodo MQOutput altere temporalmente el estado de la transacción de forma explícita. Ningún otro nodo puede cambiar las características de transacción del mensaje de salida.
  • Si deselecciona el recuadro, el flujo de mensajes siguiente no estará bajo el control de la transacción. Este valor también es cierto para los mensajes que se obtienen del mensaje de salida y la salida la realiza un nodo MQOutput a menos que el nodo MQOutput haya especificado que el mensaje ha de transferirse bajo punto de sincronismo.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:53:43

ac04750_