Nodo TimeoutNotification

Utilice el nodo TimeoutNotification para gestionar flujos de mensajes que dependan del tiempo de espera.

Este tema contiene las secciones siguientes:

Finalidad

El nodo TimeoutNotification es un nodo de entrada que se puede utilizar de dos maneras:

  • Un nodo TimeoutNotification se puede emparejar con uno o más nodos TimeoutControl.

    El nodo TimeoutNotification procesa mensajes de petición de tiempo de espera que se envían mediante los nodos TimeoutControl con los que está emparejado y propaga copias de los mensajes (o fragmentos seleccionados de los mensajes) al siguiente nodo del flujo de mensajes.

  • Un nodo TimeoutNotification se puede utilizar como nodo autónomo.

    Los mensajes generados se propagan al siguiente nodo del flujo de mensajes a intervalos de tiempo que se especifican en la configuración de este nodo.

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

Icono de nodo Timeout Notification

Utilización de este nodo en un flujo de mensajes

Utilice un nodo TimeoutControl y un nodo TimeoutNotification juntos en un flujo de mensajes para una aplicación que necesite que los sucesos se produzcan a una hora determinada o a intervalos regulares; por ejemplo, cuando desee que un trabajo de proceso por lotes se ejecute cada día a medianoche o que se envíe a los bancos información sobre los tipos de cambio de moneda a intervalos de una hora.

Inicio del cambioSe puede utilizar más de un nodo TimeoutControl con un nodo TimeoutNotification. Las peticiones de tiempo de espera que se inician mediante esos nodos TimeoutControl las procesa todas un mismo nodo TimeoutNotification si se utiliza el mismo Identificador exclusivo para el nodo TimeoutNotification y cada uno de los nodos TimeoutControl. Sin embargo, no utilice el mismo Identificador exclusivo para más de un nodo TimeoutNotification.Fin del cambio

Cuando un nodo TimeoutNotification se inicia como resultado del inicio del intermediario o del flujo de mensajes que contiene el nodo, explora el almacenamiento interno de tiempo de espera y depura cualquier petición de tiempo de espera no persistente. Se generan notificaciones para todas las peticiones de tiempo de espera persistentes que ahora son pasadas y que tienen la propiedad IgnoreMissed establecida en False.

Si utiliza un nodo TimeoutNotification para generar un mensaje WebSphere MQ para un nodo de salida como, por ejemplo, el nodo MQOutput, proporcione un MQMD válido. También debe proporcionar un MQMD válido si el nodo TimeoutNotification se está ejecutando en modalidad automática (como nodo autónomo). Si el nodo TimeoutNotification está ejecutándose en modalidad controlada (es decir, si está emparejado con uno o más nodos TimeoutControl), sólo deberá proporcionar un MQMD válido si los mensajes almacenados no tienen todavía un MQMD. El ESQL siguiente muestra cómo proporcionar un MQMD válido:
CREATE NEXTSIBLING OF OutputRoot.Properties DOMAIN 'MQMD';
SET OutputRoot.MQMD.Version =  MQMD_CURRENT_VERSION;
SET OutputRoot.MQMD.Format = 'XML';
En el siguiente ejemplo encontrará más detalles sobre la utilización de los nodos de proceso de tiempo de espera: 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 TimeoutNotification 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 TimeoutNotification se describen en la tabla siguiente.

Terminal Descripción
De anomalías Terminal de salida en el que se propaga el mensaje si se detecta una anomalía durante el proceso en este nodo. Se pueden conectar nodos a este terminal para procesar estas anomalías. Si este terminal no está conectado a otro nodo, no se propagan mensajes y no se produce ninguna anotación ni ningún almacenamiento seguro de los datos.
De salida Terminal de salida en el que se propagan los mensajes después de que caduquen los tiempos de espera.
  • Si el nodo TimeoutNotification se está ejecutando en modalidad Automática (es decir, que no hay nodos TimeoutControl emparejados con ese nodo), los mensajes propagados contendrán únicamente una carpeta de propiedades y un entorno local que se llena con la información de tiempo de espera.
  • Si el nodo TimeoutNotification se ejecuta en modalidad Controlada (es decir, si los nodos TimeoutControl emparejados con ese nodo almacenan peticiones de tiempo de espera), los mensajes propagados contienen lo que han almacenado los nodos TimeoutControl, que pueden ser mensajes de petición o fragmentos de los mismos.
Si el nodo TimeoutNotification se utiliza como nodo de entrada para un flujo de mensajes que genera un mensaje WebSphere MQ (por ejemplo, utilizando un nodo MQOutput), el flujo de mensajes crea las cabeceras y los datos de MQ necesarios (por ejemplo, MQMD).
Catch (de captación) Terminal de salida al que se propaga el mensaje si se genera una excepción en sentido descendente. Si este terminal no está conectado a otro nodo, se producen los sucesos siguientes:
  1. El nodo TimeoutNotification graba el error en las anotaciones de error locales.
  2. El nodo TimeoutNotification intenta de forma repetida procesar la petición hasta que se resuelve el problema que ha causado la excepción.

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 TimeoutNotification.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo: TimeoutNotification El nombre del nodo.
Descripción corta No No   Descripción breve del nodo.
Descripción larga No No   Texto que describe la finalidad del nodo en el flujo de mensajes.

En la tabla siguiente se describen las propiedades básicas del nodo TimeoutNotification.

Propiedad O C Valor predeterminado Descripción
Identificador exclusivo Ninguno Esta propiedad especifica un valor que es un valor que es exclusivo dentro del intermediario y que es el mismo identificador que el especificado para los nodos TimeoutControl con los que está emparejado este nodo (si los hay). La longitud máxima de este identificador es de 12 caracteres.

Inicio del cambioNo utilice el mismo Identificador exclusivo para más de un nodo TimeoutNotification.Fin del cambio

Modalidad de transacción No No La modalidad de transacción para el nodo. Si la modalidad de transacción es Automática, una transacción se basa en la persistencia de los mensajes almacenados, lo cual está controlado por la propiedad Persistencia de peticiones del nodo TimeoutControl con el que está emparejado. Puede establecer esta propiedad en uno de los valores siguientes:
  • Seleccione si desea que se inicie una transacción.
  • Seleccione No si no desea que se inicie una transacción.
  • Seleccione Automática, sólo si ha establecido Modalidad de operación en Controlada. El hecho de que una transacción se inicie depende de la persistencia de las peticiones de tiempo de espera almacenadas, lo cual está controlado por el valor de Persistencia de peticiones en el nodo TimeoutControl con el que está emparejado.
Modalidad de operación No No Automática Esta propiedad indica si este nodo está emparejado con cualquier nodo TimeoutControl emparejado. Los valores válidos son:
  • Si selecciona Automática, el nodo no se empareja con ningún nodo TimeoutControl. El nodo genera peticiones de tiempo de espera con un intervalo que está controlado por el valor de la propiedad Valor de tiempo de espera.
  • Si selecciona Controlada, el nodo procesa todas las peticiones de tiempo de espera almacenadas por los nodos TimeoutControl con los que está emparejado.
Intervalo de tiempo de espera No No 1 Intervalo (en segundos) entre peticiones de tiempo de espera. Esta propiedad sólo es pertinente si la Modalidad de operación se establece en Automática.

En la tabla siguiente se describen las propiedades de las Opciones de análisis para el nodo TimeoutNotification.

Propiedad O C Valor predeterminado Descripción
Temporización del análisis No No A petición Esta propiedad controla cuándo se analiza el mensaje de tiempo de espera excedido. Los valores válidos son A petición, Inmediato y Completo.

De forma predeterminada, esta propiedad se establece en A petición, con lo cual la validación se retrasa hasta que se analice mediante el análisis parcial. Si cambia este valor por Inmediato, el análisis parcial se altera temporalmente y se analizan y validan todos los elementos de mensaje, excepto los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento. Si cambia este valor a Completo, el análisis parcial se altera temporalmente y se analiza y valida todo lo contenido en el mensaje; los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento producen una anomalía de validación.

Utilizar analizador compacto MQRFH2C para dominio MQRFH2 No No Deseleccionado Esta propiedad controla si se utiliza el Analizador compacto MQRFH2C, en lugar del analizador MQRFH2, para las cabeceras MQRFH2.
Utilizar analizador compacto XMLNSC para dominio XMLNS No No Deseleccionado Esta propiedad controla si el analizador compacto XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta propiedad, los datos del mensaje aparecen bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando la cabecera RFH2 de entrada o el dominio de las propiedades predeterminado sea XMLNS.
Retener contenido mixto No No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra texto mixto en un mensaje de tiempo de espera excedido. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento.
Retener comentarios No No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra comentarios en un mensaje de tiempo de espera excedido. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento.
Retener instrucciones de proceso No No Ninguno Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra instrucciones de proceso en un mensaje de tiempo de espera excedido. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento.

Las propiedades de validación del nodo TimeoutNotification se describen en la siguiente tabla.

Si un mensaje se propaga al terminal de anomalías (Failure) del nodo, no se valida. Para obtener más información consulte Validar mensajes y Propiedades de validación.
Propiedad O C Valor predeterminado Descripción
Validar No Ninguno Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido yContenido y valor.
Acción para anomalía No No Excepción Esta propiedad controla qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones.
Incluir todas las limitaciones de valor No No Seleccionado Esta propiedad no se puede editar. Si selecciona este recuadro de selección, se incluyen las comprobaciones de restricción de valor básicas en la validación de Contenido y valor.
  No No Ninguno Esta propiedad no se puede editar.
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:54:01

ac20802_