WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo Secuencia

Utilice el nodo Secuencia para añadir un número de secuencia a uno o más grupos de mensajes de entrada.

Este tema contiene las secciones siguientes:

Finalidad

El nodo Secuencia permite recibir grupos de mensajes de un origen de un origen de entrada y mantener el orden en que llegan los mensajes en cada grupo.

Utilice un nodo Secuencia para generar un número de secuencia que aumente de forma monotónica para cada grupo de secuencia. Para cada mensaje del grupo que llega al nodo Secuencia, el número de secuencia del grupo aumenta y se almacena con el mensaje en una ubicación especificada en la propiedad del nodo Vía de acceso para almacenar el número de secuencia (por ejemplo, Entorno local, cabecera MQRFH2, cuerpo del mensaje).

Las secuencias sólo se aplican a los mensajes del mismo grupo de secuencia. Puede utilizar las propiedades del nodo Secuencia para organizar mensajes en grupos de acuerdo con una condición especificada; por ejemplo, la agrupación de todos los mensajes con el mismo valor en un campo de número de cliente en el mensaje. Si no se especifica ningún grupo de secuencia, se utiliza un solo grupo predeterminado para todos los mensajes.

Un nodo Secuencia puede recibir entradas de varios nodos de entrada en el flujo de mensajes o de nodos de entrada que tienen instancias adicionales. El nodo Secuencia puede procesar varios grupos de secuencia en paralelo, pero sólo procesa una solicitud de números de secuencia cada vez para el mismo grupo de secuencia.

El nodo Secuencia asigna un número de secuencia a cada mensaje del grupo de secuencia y no se asigna el número de secuencia siguiente del grupo hasta que se haya terminado de procesar el mensaje actual del grupo (confirmándolo o restituyéndolo). Sólo una hebra a la vez puede procesar mensajes en el mismo grupo de secuencia en sentido descendente desde el nodo Secuencia, lo cual garantiza que se mantiene la secuenciación para el grupo cuando hay diversas hebras en el flujo de mensajes.

Cuando el nodo Secuencia recibe mensajes de diversas hebras, se preserva el orden en que los mensajes llegan al nodo Secuencia. Sin embargo, el orden en que los mensajes llegan al nodo Secuencia puede ser distinto al orden en que se toman desde el transporte en el nodo de entrada. Esta situación se puede producir porque a los mensajes de una hebra los adelanten otros mensajes de otras hebras entre el nodo de entrada y el nodo Secuencia.

Cada grupo de secuencia se puede asociar únicamente a un nodo Secuencia. Varios nodos Secuencia pueden tener un grupo de secuencia con el mismo nombre, pero cada uno de esos grupos de secuencia se trata como un grupo aparte. Se utiliza la combinación del nombre del grupo de ejecución, el nombre del flujo de mensajes, el nombre del nodo y el nombre del grupo de secuencia para diferenciar los grupos de secuencia.

Por ejemplo, podría tener un flujo de mensajes denominado flow1 que contenga un nodo Secuencia denominado node1, que se despliega en un grupo de ejecución denominado eg1. Se envía un mensaje al mismo utilizando un grupo de secuencia denominado group1. El resultado es eg1/flow1/node1/group1. El mismo flujo de mensajes en un grupo de ejecución distinto, por ejemplo eg2, daría como resultado eg2/flow1/node1/group1.

El nodo Secuencia se encuentra en la bandeja Direccionamiento de la paleta y está representado en el WebSphere Message Broker Toolkit mediante el siguiente icono:

Icono de nodo Sequence

Utilización del nodo Secuencia en un flujo de mensajes

Examine el ejemplo siguiente para saber cómo utilizar el nodo Secuencia:

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

Configuración del nodo Secuencia

Cuando haya colocado una instancia del nodo Secuencia en un flujo de mensajes, podrá configurarlo; consulte el tema Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades.

Todas las propiedades obligatorias que no tienen un valor predeterminado aparecen con un asterisco.

Configure el nodo Secuencia:

  1. Opcional: En el separador Descripción, especifique una Descripción corta, una Descripción larga, o ambas. En este separador también puede renombrar el nodo.
  2. En el separador Básicas, establezca las propiedades que determinan cómo se controla la secuencia de mensajes.
    • Utilice la propiedad Vía de acceso para almacenar el número de secuencia para especificar la ubicación donde guardar el número de secuencia en el mensaje. La ubicación se especifica como una expresión XPath.
    • Utilice la propiedad Vía de acceso de identificador de grupo de secuencia para especificar la ubicación del identificador del grupo de secuencia. La ubicación se especifica como una expresión XPath. Los mensajes que tienen el mismo identificador de grupo se consideran parte del mismo grupo de secuencia.
    • Utilice la propiedad Definición de inicio de secuencia para especificar el primer número de secuencia en cada grupo. En el campo Literal, especifique cualquier valor numérico negativo o positivo como el primer número de secuencia del grupo. El valor predeterminado es 0.

      Cuando el nodo Secuencia propaga el primer mensaje de un grupo de secuencia específico, el número de secuencia inicial especificado se utiliza para asignar el primer número de secuencia; los mensajes sucesivos contienen un número de secuencia que aumenta de forma monotónica. Este valor se sobrescribe con la variable LocalEnvironment.Sequence.StartOfSequenceNumber.

    • Utilice la propiedad Definición de fin de secuencia para especificar cuándo se ha completado cada grupo de secuencia.
      • Seleccione Literal para especificar un número de secuencia literal. Este valor puede ser cualquier valor numérico positivo o negativo que sea mayor que el valor de la propiedad Definición de inicio de secuencia. Cuando llega el mensaje con el número de secuencia especificado, se cierra el grupo de secuencia.
      • Seleccione Predicado para especificar una expresión XPath que se evalúa como Verdadera o Falsa, e indica si el mensaje es el último de la secuencia. Una vez se ha determinado el primer mensaje de la secuencia, a los mensajes de ese grupo de secuencia se les siguen asignando números de secuencia hasta que el predicado de fin de secuencia se evalúa a True.

        Si la expresión XPath es válida pero no está presente en el mensaje, se evalúa como False y se asigna un número de secuencia al siguiente mensaje del grupo de secuencia. Cuando el predicado se evalúa a True, el mensaje pasa a ser el último de la secuencia y no se asignan más mensajes a la secuencia para ese grupo de secuencia.

        Si la expresión XPath no es válida, da un error y se retrotrae el mensaje.

      • Seleccione Automático para especificar el periodo de tiempo de espera para el nodo. Esta opción especifica cuánto tiempo (en segundos) espera el nodo que lleguen los mensajes de una cola vacía, antes de cerrar el grupo de secuencia. Esta opción es útil para las aplicaciones que no pueden determinar el número final de la secuencia. El temporizador empieza cuando no hay mensajes en la cola a la espera de que se propaguen. Si hay nuevos mensajes que llegan antes de alcanzar el período de tiempo de espera, se cancela el temporizador. Si no llegan mensajes nuevos antes del final del tiempo especificado, se cierra el grupo de secuencia y los demás mensajes para el grupo se consideran parte de un grupo nuevo.
  3. En el separador Avanzadas:
    • Utilice la propiedad Modalidad de persistencia para especificar si se debe almacenar de forma persistente el estado del grupo de secuencia. El valor predeterminado es No persistente.

Terminales y propiedades

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

Terminal Descripción
De entrada) El terminal de entrada a través del cual llega al nodo el mensaje ensamblado de entrada.
Anomalía El terminal de salida al que se direcciona el mensaje si se produce un error. Este valor incluye anomalías provocadas por el proceso de reintento.
De salida El terminal de salida al cual se propaga de forma predeterminada el mensaje de salida.

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

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No Secuencia El nombre del nodo.
Descripción corta No No   Una 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 Secuencia.

Propiedad O C Valor predeterminado Descripción
Vía de acceso para almacenar el número de secuencia No No
$OutputLocalEnvironment/
Sequence/Number
Una expresión XPath que especifica la ubicación en la que se debe guardar el número de secuencia del mensaje.
Vía de acceso de identificador de grupo de secuencia No No No se ha establecido Una expresión XPath que apunta a la ubicación del identificador de grupo de secuencia. Los mensajes que tienen el mismo identificador de grupo se consideran parte del mismo grupo de secuencia. Esta propiedad funciona del mismo modo que la propiedad Vía de acceso de correlación en el nodo Collector.
Definición de inicio de secuencia No 0 Especifica el primer número de secuencia de cada grupo. Los valores válidos son los enteros positivos o negativos. El valor predeterminado es 0.
Definición de fin de secuencia No Automática Especifica cuándo se ha completado cada grupo de secuencia. Los valores válidos son:
  • Literal y número
  • Predicado y XPath
  • Automático y tiempo en segundos
El valor predeterminado es Automático.

En la tabla siguiente se describen las propiedades avanzadas del nodo Secuencia.

Propiedad O C Valor predeterminado Descripción
Modalidad de persistencia No No persistente Especifica si se va a almacenar el estado del grupo de secuencia de forma persistente. Las opciones válidas son:
  • No persistente
  • Persistente
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:54


Tema de referenciaTema de referencia | Versión 8.0.0.5 | bc28010_