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

Establecimiento de las propiedades del manejador de sucesos

Puede configurar las propiedades de manejadores de sucesos para cada terminal de entrada dinámico en un nodo Collector. Estas propiedades del manejador de sucesos determinan cómo se añaden a las colecciones de mensajes los mensajes recibidos por cada terminal.

Antes de empezar:

Puede utilizar una o varias propiedades del manejador de sucesos para controlar la forma en la que los mensajes se añaden a las colecciones de mensajes, para cada terminal de entrada añadida al nodo Collector. Las colecciones de mensajes incompletas se almacenan en una cola WebSphere MQ. Las colecciones de mensajes se almacenan en el orden en el que las genera el nodo Collector (la primera que entra es la primera que sale). Cada colección de mensajes tiene una instancia del manejador de sucesos para cada uno de los terminales de entrada. El manejador de sucesos determina si un mensaje de entrada de ese terminal se añade a una colección de mensajes. La instancia del manejador de sucesos mantiene la información sobre el estado de la colección, el número de mensajes recibidos, el temporizador y la serie de correlación. Cuando se recibe un mensaje en un terminal de entrada, éste se ofrece sucesivamente al manejador de sucesos de cada colección de mensajes que espera en la cola. Cuando uno de los manejadores de sucesos acepta el mensaje, éste se añade a la colección de mensajes. El mensaje aceptado no se ofrece a ninguna otra colección de mensajes. Si todos los manejadores de mensajes rechazan el mensaje, éste se añade a una nueva colección de mensajes, que se añade al final de la cola.

El primer mensaje aceptado en una colección determina la serie de correlación para esa colección de mensajes, si se ha configurado. Los mensajes subsiguientes ofrecidos a esa colección de mensajes sólo se aceptan si su serie de correlación coincide con la de la colección. El primer mensaje aceptado por cada manejador de sucesos inicia el temporizador de tiempo de espera, si está configurado. Cada mensaje aceptado por cada manejador de sucesos incrementa la cuenta de cantidad. Un manejador de sucesos pasa a estar lleno cuando el número de mensajes aceptados es igual a la cantidad configurada, o cuando se alcanza el valor de tiempo de espera. Cuando un manejador de sucesos está lleno, éste no acepta más mensajes. Una colección de mensajes sólo está completa cuando todos los manejadores de sucesos de la colección de mensajes están llenos. La colección de mensajes está lista para su propagación.

Puede configurar las propiedades del manejador de sucesos utilizando la tabla Definición de colección en el separador Básicas de la vista Propiedades.

Para configurar las propiedades del manejador de sucesos del nodo Collector:

  1. Abra el flujo de mensajes con el nodo Collector.
  2. Pulse el botón derecho del ratón en el nodo Collector y seleccione Propiedades.
  3. Pulse el separador Básicas.
  4. Siga las siguientes instrucciones para configurar las propiedades del manejador de sucesos que desea establecer para cada terminal de entrada:
    • Si desea añadir un número de mensajes definido a cada colección de mensajes desde uno o varios terminales, debe entrar un valor para Cantidad en la tabla Definición de colección. Este valor se utiliza para especificar el número de mensajes que cada terminal de entrada configurado acepta para completar una colección. Por ejemplo, si ha establecido Cantidad par que espere 2 mensajes en tres de los terminales de entrada, la colección de mensajes no se completa hasta que se hayan recibido 2 mensajes en cada uno de los tres terminales de entrada. La colección de mensajes completa contiene 6 mensajes, 2 de cada uno de los tres terminales. Tan pronto se reciban más de dos mensajes en uno de los terminales de entrada, el siguiente mensaje se añade a una nueva colección de mensajes.
      1. En la tabla Definición de colección, pulse la fila correspondiente el terminal de entrada seleccionado dentro de la columna Cantidad.
      2. Escriba un valor para el número de mensajes de entrada que desee añadir a una colección de mensajes. Si selecciona Cero o elige establecer esta propiedad, no hay ningún límite en el número de mensajes aceptados. En este caso el valor establecido en la propiedad Tiempo de espera debe ser mayor que cero. Si acepta el valor predeterminado de 1; solamente se añade un mensaje del terminal seleccionado a una colección.

      Debe entrar un valor para Cantidad si no se establece Tiempo de espera.

    • Si desea recopilar mensajes para un periodo de tiempo establecido antes de propagar la colección de mensajes se debe especificar un valor de Tiempo de espera. Este valor se utiliza para especificar el tiempo máximo en segundo durante el cual el terminad de entrada seleccionado acepta mensajes antes de completar una colección de mensajes. El intervalo de tiempo de espera empieza cuando llega el primer mensaje en el terminal seleccionado. Todos los mensajes subsiguientes se añaden a la misma colección de mensajes. Cuando el intervalo de tiempo de espera finaliza, no se añaden más mensajes a la colección de mensajes desde esta terminal. Cuando se satisfacen las condiciones en todos los terminales, la colección de mensajes está lista para propagarse. Cuando llega el mensaje siguiente al terminal de entrada seleccionado, se crea una nueva colección de mensajes y vuelve a empezar el intervalo de tiempo de espera. Si un tiempo de espera es un conjunto de varios terminales de entrada, cada terminal recopila mensajes durante el periodo de tiempo configurado. Durante el tiempo de espera, se añaden mensajes de todos los terminales a la misma colección de mensajes.
      1. En la tabla Definición de colección, pulse la fila correspondiente el terminal de entrada seleccionado dentro de la columna Tiempo de espera.
      2. Escriba un valor para el intervalo de tiempo en segundos durante el que desea esperar para añadir mensajes a una colección de mensajes. Por ejemplo, para esperar a que los mensajes se añadan a una colección de mensajes durante una hora, escriba el valor 3600. Si acepta el valor predeterminado Cero, el tiempo de espera no estará habilitado y no habrá límite en el tiempo que se van a esperar los mensajes. En este caso el valor establecido en la propiedad Cantidad debe ser mayor que cero.

      Debe entrar un valor para Tiempo de espera si no se establece Cantidad.

    • Si desea añadir mensajes a distintas colecciones de mensajes en base al contenido del mensaje, debe especificar un valor XPath para la Vía de acceso de correlación. Este valor se utiliza para especificar la vía de acceso del mensaje de entrada del que extraer la serie de correlación. La serie de correlación es el valor que se extrae mediante la vía de acceso de correlación. Si se especifica un patrón de correlación, la serie de correlación se compara con el patrón de correlación. Los mensajes sólo se aceptan en una colección de mensajes con la misma serie de correlación. Si especifica un asterisco (*) en el nombre de la colección de mensajes, se sustituirá por la serie de correlación.
      1. En la tabla Definición de colección, pulse la fila correspondiente el terminal de entrada seleccionado dentro de la columna Vía de acceso de correlación.
      2. Seleccione una vía de acceso de correlación predefinida en la lista, o especifique su propia vía de acceso de correlación mediante XPath. La vía de acceso de correlación debe empezar por el nombre de correlación, que puede ir seguido de cero o más campos de vía de acceso. Por ejemplo, en el siguiente mensaje la serie de correlación es xxx en el campo de nombre:
        <library>
        	<name>xxx</name>
        	<more>
        		...
        	</more>
        </library>
        En este ejemplo, la vía de acceso de correlación que utiliza XPath es $Body/library/name.

        Las variables $Root, $LocalEnvironment y $Environment están disponibles para permitir que la vía de acceso empiece en las raíces del mensaje, entorno local, árboles de entorno y cuerpo del mensaje.

      Si la vía de acceso de correlación se evalúa como una serie vacía, el mensaje no coincidente se añade a una colección de mensajes sin nombre predeterminada.

      Si define un valor para Vía de acceso de correlación, puede configurar de forma opcional un Patrón de correlación.

    • Si desea hacer coincidir una subserie del contenido de mensaje de la Vía de acceso de correlación, puede definir un patrón con el que debe coincidir en el mensaje utilizando Patrón de correlación. El Patrón de correlación contiene un único carácter comodín y texto opcional. La serie de correlación, que se utiliza para el nombre de la colección de mensajes, es la parte de la subserie que coincide con el comodín. Por ejemplo, si la vía de acceso de correlación contiene el nombre de archivo part1.dat en una cabecera de archivo, y el patrón de correlación se ha especificado como *.dat, la serie de correlación es part1.

      Si esta propiedad está definida, sólo los mensajes que tienen la misma serie de correlación se añaden a la misma colección de mensajes. El primer mensaje añadido a una colección de mensajes determina la serie de correlación que debe coincidir en los demás mensajes de esa colección de mensajes.
      1. En la tabla Definición de colección, pulse la fila correspondiente el terminal de entrada seleccionado dentro de la columna Patrón de correlación.
      2. Escriba un valor para el patrón de correlación. El Patrón de correlación debe contener un único carácter comodín: *. Si se desea, se puede escribir más texto alrededor de este carácter comodín.

      Si el patrón de correlación no encuentra ninguna coincidencia con una subserie, el mensaje no coincidente se añade a una colección de mensajes sin nombre predeterminada.

  5. Repita el paso 4 para cada uno de los terminales de entrada que ha añadido al nodo Collector. Puede configurar distintos manejadores de sucesos para diferentes orígenes de entrada.
Nota: Asegúrese de establecer con cuidado las propiedades del manejador de sucesos en terminales distintas de forma que coincida con la entrega de mensajes esperada a los terminales del nodo Collector.
Ahora puede configurar la caducidad de la colección, consulte Establecimiento de la caducidad de la colección.
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 16:58:42


Tema de tareaTema de tarea | Versión 8.0.0.5 | ac37730_