Nodo TimeoutNotification

Este tema contiene las secciones siguientes:

Finalidad

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

  • Emparejado con uno o varios nodos TimeoutControl.

    El nodo TimeoutNotification procesa mensajes de petición de tiempo de espera establecidos por los nodos TimeoutControl con los que se empareja y propaga copias de los mensajes (o fragmentos seleccionados de los mensajes) al siguiente nodo del flujo de mensajes.

  • 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 representa en el entorno de trabajo mediante el icono siguiente:

Icono de nodo de notificación de tiempo de espera

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, es posible que desee que un trabajo de proceso por lotes se ejecute cada día a medianoche o puede que desee que se envíe a los bancos información sobre los tipos de cambio de moneda a intervalos de una hora.

Se puede emparejar más de un nodo TimeoutControl con un nodo TimeoutNotification. El mismo nodo TimeoutNotification procesa todas las peticiones de tiempo de espera procesadas por dichos nodos TimeoutControl. Esto sucede si se utiliza el mismo Identificador exclusivo para el nodo TimeoutNotification y para cada uno de los nodos TimeoutControl.

Tenga en cuenta que cuando un nodo TimeoutNotification se inicia como resultado 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 emiten notificaciones para las peticiones de tiempo de espera persistentes que ahora han pasado y que tienen la propiedad IgnoreMissed establecida en False (falso).

Si utiliza un nodo TimeoutNotification para generar un mensaje de WebSphere MQ en un nodo de salida por ejemplo MQOutput, debe proporcionar un MQMD válido. Esto es necesario si el nodo TimeoutNotification se ejecuta en modalidad automática (autónoma). Si el nodo TimeoutNotification se ejecuta en modalidad controlada (es decir, está emparejado con uno o varios nodos TimeoutControl), esto sólo es necesario en el caso de que los mensajes almacenados no tengan aún un MQMD.

El ESQL siguiente muestra cómo puede realizar esta operación.
CREATE NEXTSIBLING OF OutputRoot.Properties DOMAIN 'MQMD';
SET OutputRoot.MQMD.StrucId = MQMD_STRUC_ID;
SET OutputRoot.MQMD.Version =  MQMD_CURRENT_VERSION;
SET OutputRoot.MQMD.Format = 'XML';
Dado que no hay contexto de WebSphere MQ en el entorno local, la propiedad de nodo MQOutput Contexto del mensaje debe tener el valor por omisión.

Consulte el Ejemplo de proceso de Tiempo de espera excedido para obtener más detalles sobre cómo utilizar los nodos de proceso de tiempo de espera.

Configuración del nodo TimeoutNotification

Puede configurar cada instancia del nodo TimeoutNotification en el flujo de mensajes.

Para configurar el nodo, pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Se visualizan las propiedades básicas del nodo.

Identificador exclusivo es la única propiedad obligatoria. No tiene ningún valor por omisión.

Configure el nodo TimeoutNotification realizando lo siguiente:

  • En Identificador exclusivo especifique un valor que sea exclusivo en el intermediario y sea igual que el identificador que se ha especificado para los nodos TimeoutControl con los que se empareja este nodo (si hay alguno). La longitud máxima de este identificador es de 12 caracteres.
  • Especifique un valor para Modalidad de transacción. Esta propiedad afecta el control de transacción de los mensajes de tiempo de espera propagados y se puede establecer en uno de los valores siguientes:
    Se inicia siempre una transacción.
    No
    No se inicia nunca una transacción.
    Automática
    Este valor sólo es significativo si la Modalidad de operación tiene el valor Controlada. El hecho de que una transacción se inicie depende de la persistencia de las peticiones de tiempo de espera almacenadas, lo que está controlado por el valor de Persistencia de peticiones en el nodo TimeoutControl con el que está emparejado.
  • Especifique un valor para Modalidad de operación. Esta propiedad indica si este nodo tiene nodos TimeoutControl emparejados. Establézcala en uno de los valores siguientes:
    Automática
    El nodo no está emparejado con ningún nodo TimeoutControl. Genera peticiones de tiempo de espera con un intervalo que está controlado por el valor de la propiedad Valor de tiempo de espera.
    Controlada
    El nodo procesa todas las peticiones de tiempo de espera almacenadas por los nodos TimeoutControl con los que está emparejado.
  • Si la Modalidad de operación es Automática, especifique un valor para Intervalo de tiempo de espera. Este valor especifica el intervalo (en segundos) entre la propagación del mensaje.
  • Seleccione Validación en el navegador del diálogo de propiedades si desea que el analizador MRM valide el cuerpo de los mensajes contra el diccionario generado del conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

    Si desea ver más información detallada, consulte los apartados Validar mensajes y Propiedades de validación para mensajes del dominio MRM.

  • Seleccione Opciones de mensajes generales en el navegador del diálogo de propiedades. Temporización del análisis se establece por omisión en A petición. Esto hace que la validación se retarde hasta que se analiza mediante el análisis parcial. Si cambia este valor a 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 lo cambia por Completo, el análisis parcial se altera y se analizan y validan todos los elementos del 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.
  • Seleccione Descripción en el diálogo de propiedades del navegador para escribir una descripción breve, una descripción larga o ambas cosas.

Cuando haya terminado la configuración, pulse Aplicar. Esta acción realiza los cambios en el nodo TimeoutNotification sin cerrar el diálogo de propiedades. Pulse en 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

En la tabla siguiente se describen los terminales del nodo TimeoutNotification.

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 ejecuta en modalidad Automática (es decir, no hay nodos TimeoutControl emparejados con este nodo), los mensajes propagados sólo contienen 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, los nodos TimeoutControl que están emparejados con este nodo almacenan peticiones de tiempo de espera), los mensajes propagados contienen lo que han almacenado los nodos TimeoutControl, que pueden ser mensajes de solicitud enteros o fragmentos de éstos.

Tenga en cuenta que si se utiliza el nodo TimeoutNotification como nodo de entrada en un flujo de mensajes que genera un mensaje WebSphere MQ (por ejemplo, utilizando un nodo MQOutput), el flujo de mensajes debe crear las cabeceras y los datos 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 siguientes tablas describen las propiedades del nodo; la columna O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si se ha de entrar un valor cuando no se ha definido ningún valor por omisión), la columna C indica si la propiedad es configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para desplegarlo).

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

Propiedad O C Valor por omisión Descripción
Identificador exclusivo Ninguno Valor que es exclusivo en el intermediario y que es igual que el del identificador que se ha especificado para los nodos TimeoutControl con los que está emparejado este nodo (si hay alguno). La longitud máxima de este identificador es de 12 caracteres.
Modalidad de transacción No No 'Sí' La modalidad de transacción para el nodo. El valor puede ser , No o Automática. Si la modalidad de transacción es Automática, transacción basada en la persistencia de los mensajes almacenados que está controlada por la propiedad Persistencia de peticiones del 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. El valor puede ser Automática o Controlada.
Intervalo de tiempo de espera No No 1 Intervalo (en segundos) entre peticiones de tiempo de espera. Sólo es pertinente si la Modalidad de operación se establece en Automática.

En la tabla siguiente se describen las propiedades de validación del nodo TimeoutNotification.

Consulte Propiedades de validación para mensajes del dominio MRM para obtener una descripción completa de estas propiedades.
Propiedad O C Valor por omisión Descripción
Validar Ninguna Determina si se realiza la validación. Los valores válidos son Ninguno, Contenido y Contenido y valor.
Acción para anomalía No Excepción Determina 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 Seleccionado Esta propiedad no se puede editar. La acción por omisión, indicada por el recuadro de selección que se marque, es que se incluyan comprobaciones de restricción de valor básicas en la validación de Contenido y valor.
Arreglo No Ninguna Esta propiedad no se puede editar.

En la tabla siguiente se describen las propiedades de las Opciones de mensajes generales para el nodo TimeoutNotification.

Propiedad O C Valor por omisión Descripción
Temporización del análisis No A petición Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son A petición, Inmediato y Completo.

Consulte Análisis a petición para obtener una descripción completa de esta propiedad.

Utilizar analizador compacto MQRFH2C para dominio MQRFH2 No No Falso Esta propiedad controla si se utiliza el Analizador compacto MQRFH2C, en lugar del analizador MQRFH2, para las cabeceras MQRFH2.

Las propiedades de las opciones de analizador XMLNSC para el nodo TimeoutNotification se describen en la tabla siguiente.

Propiedad O C Valor por omisión Descripción
Utilizar analizador compacto XMLNSC para dominio XMLNS Deseleccionado No Inicio del cambioEsta propiedad le permite controlar si se utiliza el analizador compacto XMLNSC para mensajes en el dominio XMLNS. Tenga en cuenta que si establece esta propiedad, los datos del mensaje aparecerán 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 predeterminadas sea XMLNS.Fin del cambio
Modalidad de retención de contenido mixto No Ninguna Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra texto mixto en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para el texto mixto. Si se selecciona Ninguno, significa que el texto mixto se ignora y no se crea ningún elemento.
Modalidad de retención de comentarios No Ninguna Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra comentarios en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para los comentarios. Si se selecciona Ninguno, significa que se ignoran los comentarios y no se crean elementos.
Modalidad de retención de instrucciones de proceso No Ninguna Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra instrucciones de proceso en un mensaje de entrada. Los valores válidos son Ninguno y Todos. Si se selecciona Todos, significa que se crean elementos para las instrucciones de proceso. Si se selecciona Ninguno, significa que se ignoran las instrucciones de proceso y no se crean elementos.

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

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 la finalidad 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
ac20802_