Nodo TimeoutControl

Este tema contiene las secciones siguientes:

Finalidad

El nodo TimeoutControl recibe un mensaje de entrada que contiene una petición de tiempo de espera. Consulte Mensaje de petición de tiempo de espera para obtener una descripción del mensaje de petición de tiempo de espera. El nodo valida la petición, almacena el mensaje y propaga el mensaje (sin modificarlo) al siguiente nodo del flujo de mensajes.

El nodo TimeoutControl se representa en el entorno de trabajo mediante el icono siguiente:

Icono de nodo de control 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 horas determinadas o a intervalos regulares.

A continuación se muestran ejemplos de los momentos en que puede que desee utilizar los nodos de tiempo de espera en un flujo de mensajes:
  1. Necesita ejecutar un trabajo de proceso por lotes cada día a medianoche.
  2. Desea que se envíe información sobre los tipos de cambio monetario a los bancos cada hora.
  3. Desea confirmar que se han procesado transacciones importantes dentro de un periodo de tiempo determinado y realizar otras acciones especificadas para avisar cuando no se ha procesado una transacción en ese periodo de tiempo.

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

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 TimeoutControl

Cuando haya puesto una instancia del nodo TimeoutControl en un flujo de mensajes, puede configurarlo.

Pulse con el botón derecho del ratón el nodo en la vista del 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 las propiedades básicas del nodo realizando lo siguiente:

  • En Identificador exclusivo especifique un identificador que sea exclusivo en el intermediario. Este identificador debe ser idéntico a la misma propiedad del nodo TimeoutNotification con el que se ha emparejado. La longitud máxima de este identificador es de 12 caracteres.
  • En Ubicación de peticiones, especifique la ubicación de la información de petición de tiempo de espera en el mensaje de entrada. Esta ubicación puede ser cualquier lugar del árbol de mensaje de entrada. Si no especifica un valor para esta propiedad, se tomará InputLocalEnvironment.TimeoutRequest. Consulte Mensaje de petición de tiempo de espera para obtener una descripción del mensaje de petición de tiempo de espera.
  • Especifique un valor para Persistencia de peticiones. Esta propiedad determina si las peticiones de tiempo de espera de entrada perduran después de un reinicio del intermediario o del flujo de mensajes que contiene el nodo TimeoutNotification que está emparejado con este nodo TimeoutControl. Especifique , si desea que la petición de entrada permanezca; especifique No, si no lo desea. Si especifica Automática, se utilizará el valor de Persistencia de la carpeta Propiedades del mensaje de entrada. Automática es el valor por omisión de esta propiedad.

Ahora configure las propiedades de mensaje del nodo:

  • En Ubicación de mensajes almacenados, especifique la ubicación de la parte del mensaje de solicitud que desea almacenar para que lo propague el nodo TimeoutNotification con el que está emparejado. Si no especifica un valor, se almacena el mensaje entero. Puede especificar cualquier ubicación válida del árbol de mensaje. Si elige almacenar el mensaje entero, no necesita especificar ningún valor en Dominio de mensajes, Conjunto de mensajes, Tipo de mensaje o Formato del mensaje.
  • En Dominio de mensajes, seleccione el nombre del analizador que utiliza en la lista desplegable. Este valor y los tres valores correspondientes del Conjunto de mensajes, Tipo de mensaje y Formato del mensaje los utilizará el nodo TimeoutNotification con el que está emparejado cuando vuelva a crear el mensaje almacenado para la propagación. Si ha almacenado el mensaje de solicitud entero (dejando en blanco Ubicación de mensajes almacenados), no especifique ningún valor aquí. Si elige almacenar parte del mensaje de solicitud, aquí debe especificar valores que reflejen el fragmento de mensaje de solicitud almacenado como si fuera el mensaje entero, lo que sucede cuando lo procesa el nodo TimeoutNotification. Puede elegir entre los nombres siguientes:
    • MRM
    • XML
    • XMLNS
    • XMLNSC
    • JMSMap
    • JMSStream
    • MIME
    • BLOB
    • IDOC
  • Si está utilizando el analizador MRM o IDOC, seleccione el conjunto de mensajes correcto en la lista desplegable de Conjunto de mensajes.

    Deje en blanco Conjunto de mensajes para los analizadores XML, XMLNS, XMLNSC, JMS, MIME y BLOB.

  • Si está utilizando el analizador MRM, seleccione el mensaje correcto en la lista desplegable de Tipo de mensaje. Esta lista contiene los mensajes que están definidos en el conjunto de mensajes que ha seleccionado.

    Deje en blanco Tipo de mensaje para los analizadores XML, XMLNS, XMLNSC, JMS, IDOC, MIME y BLOB.

  • Si está utilizando el analizador MRM o IDOC, seleccione el formato del mensaje en la lista desplegable de Formato del mensaje. Esta lista incluye todos los formatos físicos que ha definido para este conjunto de mensajes.

    Deje en blanco Formato del mensaje para los analizadores XML, XMLNS, XMLNSC, JMS, MIME y BLOB.

Cuando haya terminado la configuración, pulse Aplicar. Esto realizará los cambios en el nodo TimeoutControl 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 TimeoutControl.

Terminal Descripción
Entrada Terminal de entrada que acepta un árbol de mensaje para proceso (lo que incluye validar la petición de tiempo de espera especificada en el árbol de mensaje en Ubicación de peticiones) y lo añade a la cola de control.
De anomalías Terminal de salida en el que se propaga el mensaje de entrada si se detecta una anomalía durante el proceso de este nodo. Si este terminal no está conectado a otro nodo, la información de error se devuelve al nodo anterior del flujo de mensajes.
De salida Terminal de salida al que se propagan los mensajes de entrada, sin modificarse, después del proceso satisfactorio de las peticiones de tiempo de espera. Si este terminal no está conectado a otro nodo, no se produce ninguna propagación. Si falla la propagación del mensaje, éste se propaga al terminal de anomalías.

>Las siguientes tablas describen las propiedades del nodo; la columna M 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 TimeoutControl.

Propiedad O C Valor por omisión Descripción
Identificador exclusivo Ninguno Es la única propiedad obligatoria para el nodo. El valor debe ser exclusivo en el intermediario. La propiedad equivalente del nodo TimeoutNotification con el que está emparejado debe tener el mismo valor. La longitud máxima de este identificador es de 12 caracteres.
Ubicación de peticiones No No Ninguna Esta propiedad describe dónde encontrar la información de petición de tiempo de espera. Debe ser una ubicación válida en el árbol de mensaje. Se valida en la ejecución. Si no se especifica ninguna ubicación de peticiones, se toma LocalEnvironment.TimeoutRequest. Consulte Mensaje de petición de tiempo de espera para obtener una descripción del mensaje de petición de tiempo de espera.
Persistencia de peticiones No No Automática Esta propiedad determina si una petición de tiempo de espera de entrada perdura después de un reinicio de flujo de mensajes o de intermediario. El valor de esta propiedad puede ser Automática, o No. Si el valor es Automática, se utiliza el valor de Persistencia de la carpeta Propiedades del mensaje de entrada.

En la tabla siguiente se describe las propiedades de mensaje del nodo TimeoutControl.

Propiedad O C Valor por omisión Descripción
Ubicación de mensajes almacenados No No Ninguna Ubicación de la parte del mensaje de solicitud que desea almacenar para que lo propague el nodo TimeoutNotification con el que está emparejado este nodo.
Dominio de mensajes No No Ninguna Dominio utilizado por el nodo TimeoutNotification para analizar el mensaje de petición de tiempo de espera almacenado.
Conjunto de mensajes No No Ninguna Nombre o identificador del conjunto de mensajes en el que se define el mensaje de petición de tiempo de espera almacenado.
Tipo de mensaje No No Ninguna Nombre del mensaje de petición de tiempo de espera almacenado.
Formato del mensaje No No Ninguna Nombre del formato físico del mensaje de petición de tiempo de espera almacenado.

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

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
ac20800_