Nodo AggregateReply

Este tema contiene las secciones siguientes:

Finalidad

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.

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:

  1. El nodo AggregateControl marca el inicio de un abanico de salida de peticiones que forman parte de una agregación. Envía un mensaje de control que el nodo AggregateReply utiliza para comparar 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 de mensajes por el nodo AggregateControl no se debe cambiar.
  2. El nodo AggregateRequest registra el hecho de que se han enviado 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á.
  3. 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 representa en el entorno de trabajo con 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.

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo puede utilizar este nodo:

Configuración del nodo AggregateReply

Una vez ha puesto una instancia del nodo AggregateReply en un flujo de mensajes, puede configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Aparecen las propiedades básicas del nodo.

Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor por omisión) aparecen con un asterisco en el diálogo de propiedades.

Configure el nodo AggregateReply de la manera siguiente:

  1. Entre un valor para Nombre de agregación. Este nombre 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. Esta propiedad es obligatoria; debe entrar un valor.
  2. Entre un valor para Tiempo de espera de mensaje desconocido. Este valor se especifica en segundos. Indica la cantidad de tiempo durante el cual se retienen los mensajes que no pueden identificarse como respuestas válidas antes de propagarlos al terminal unknown (desconocido).

    Si entra 0 o no entra ningún valor, el tiempo de espera se inhabilita y los mensajes desconocidos se propagan al terminal unknown tras su recepción.

  3. Seleccione Modalidad de transacción para definir las características de transacción de este mensaje:
    • Si selecciona el recuadro, el flujo de mensajes siguiente estará bajo el control de la transacción. Esto también es cierto para los mensajes que se obtienen del mensaje de salida y producidos por un nodo MQOutput, a menos que el nodo MQOutput altere temporalmente el estado de transacción de forma explícita. Éste es el valor por omisión. (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. Esto también es cierto para los mensajes obtenidos del mensaje de salida y producidos por un nodo MQOutput, a menos que el nodo MQOutput haya especificado que el mensaje se debe poner bajo punto de sincronización.
  4. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  5. Pulse Aplicar para efectuar los cambios en el nodo AggregateReply sin cerrar el diálogo de propiedades. Pulse Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse Cancelar para cerrar el diálogo y eliminar todos los cambios que ha efectuado en las propiedades.

Terminales y propiedades

Los terminales del nodo AggregateReply se describen en la siguiente tabla.

Terminal Descripción
Control El terminal de entrada que acepta mensajes de control enviados por un nodo AggregateControl correspondiente.
Nota: El terminal de control está desfasado 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 caducado 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 del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si tiene que entrar un valor cuando no hay definido ningún valor por omisión), 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).

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

Propiedad O C Valor por omisión Descripción
Nombre de agregación   Nombre que puede utilizarse para asociar el flujo de mensajes de abanico de entrada con el flujo de mensajes de abanico de salida. Esta propiedad es obligatoria.
Tiempo de espera de mensaje desconocido No No 0 Periodo de tiempo durante el cual se retienen los mensajes que no pueden identificarse como respuestas antes de propagarlos al terminal unknown (desconocido).
Modalidad de transacción No Seleccionado Indica si los mensajes propagados por este nodo se colocan transaccionalmente. Si selecciona el recuadro, se realizará esta acción.
Nota: 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.

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

Propiedad O C Valor por omisión Descripción
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.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ac04750_