Nodo MQeOutput

Atención: La utilización de flujos de mensajes que contienen nodos MQeInput y MQeOutput en WebSphere Message Broker Versión 6.0 está desfasada. El comportamiento que se describe aquí está destinado a utilizarse sólo cuando se esté desplegando de la Versión 6.0 a una versión anterior y a proporcionar una ruta para la migración. Vuelva a diseñar los flujos para eliminar los nodos MQe y sustitúyalos por nodos MQ que estén configurados según las especificaciones propias y coordinados con la configuración de pasarela MQe. Si desea ver más información detallada, consulte Migración de un flujo de mensajes que contiene nodos WebSphere MQ Everyplace.

Este tema contiene las secciones siguientes:

Finalidad

Utilice el nodo MQeOutput para enviar mensajes de clientes que se conectan al intermediario utilizando el protocolo de WebSphere MQ Mobile Transport.

El nodo MQeOutput reenvía los mensajes a los gestores de colas de WebSphere MQ Everyplace. Si especifica un gestor de colas de destino que no es local, asegúrese de que hay una ruta al gestor de colas o un servicio de cola de almacenamiento y reenvío para el gestor de colas, si éste existe.

No puede utilizar el nodo MQeOutput para cambiar las características transaccionales del flujo de mensajes. Estas características, establecidas por el nodo de entrada del flujo de mensajes, determinan el comportamiento transaccional del flujo.

No puede utilizar nodos MQeOutput en flujos de mensajes que se despliegan en sistemas z/OS.

Si crea un flujo de mensajes para utilizarlo como subflujo, no puede utilizar un nodo de salida estándar, debe utilizar una instancia del nodo Output para crear un terminal de salida del subflujo, a través del cual propagar el mensaje.

Si no desea que el flujo de mensajes envíe mensajes a una cola de WebSphere MQ Everyplace, puede elegir otro nodo de salida soportado.

El nodo MQeOutput se representa en el entorno de trabajo con el siguiente icono:

Icono de nodo MQeOutput

Utilización de este nodo en un flujo de mensajes

Para obtener un ejemplo de cómo se puede utilizar este nodo, tomemos el ejemplo de un agricultor que controla la irrigación en sus campos. Lleva un dispositivo PDA con WebSphere MQ Everyplace instalado. Observa que los campos no se están regando, por lo que utiliza su PDA y un enlace de navegación por satélite para comprobar la válvula de paso del agua y ve que es defectuosa. Esta información está disponible porque el dispositivo SCADA remoto responsable de controlar la válvula ha publicado un mensaje de diagnóstico, que el intermediario ha recuperado y ha reenviado a un nodo MQeOutput y de allí al cliente de WebSphere MQ Everyplace en su PDA.

Documentación de WebSphere MQ Everyplace

Encontrará más información sobre WebSphere MQ Everyplace y las propiedades del nodo, en la documentación de WebSphere MQ Everyplace en la página web de WebSphere MQ.

Configuración del nodo MQeOutput

Cuando haya colocado una instancia del nodo MQeOutput en un flujo de mensajes, podrá configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Aparecen las propiedades básicas del nodo.

Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor por omisión) aparecen con un asterisco en el diálogo de propiedades.

Configure el nodo MQeOutput de la manera siguiente:

  1. Entre el Nombre del gestor de colas y el Nombre de cola que especifican el destino del mensaje de salida si selecciona Nombre de cola en Modalidad de destino (descrito más abajo). Si selecciona otra opción para Modalidad de destino, no es necesario establecer estas propiedades.
  2. Seleccione Avanzadas en el navegador del diálogo de propiedades y seleccione la Modalidad de destino en la lista desplegable. De este modo, se identifican las colas a las que entregar el mensaje de salida.
    • Nombre de cola. El mensaje se envía a la cola especificada en la propiedad Nombre de cola. Si selecciona esta opción, las propiedades Nombre del gestor de colas y Nombre de cola (del separador Básico) son obligatorias. Éste es el valor por omisión.
    • Cola de respuestas. El mensaje se envía a la cola especificada en el campo ReplyToQ (cola de repuestas) de MQMD.
    • Lista de destinos. El mensaje se envía a la lista de colas definida en el entorno local (también denominada Lista de destinos) asociada al mensaje.
  3. Seleccione Petición en el navegador del diálogo de propiedades y establezca las propiedades para definir las características de cada mensaje de salida generado.
    1. Seleccione el recuadro Petición para indicar que cada mensaje de salida está marcado en MQMD como un mensaje de petición (MQMD_REQUEST) y deje sin definir el campo del identificador de mensaje (establecido en MQMI_NONE) para asegurarse de que WebSphere MQ genera un nuevo identificador. Deseleccione el recuadro para indicar que no se ha marcado ningún mensaje de salida como mensaje de petición. Si ha seleccionado una Modalidad de destino de Cola de respuestas, no podrá seleccionar este recuadro.
    2. Indique un nombre de gestor de colas de WebSphere MQ Everyplace en Gestor de colas de respuesta. Éste se inserta en el MQMD de cada mensaje de salida como gestor de colas de respuesta. Este nuevo valor modifica el valor actual en MQMD.
    3. Entre un nombre de cola de WebSphere MQ Everyplace en Cola de respuestas. Éste se inserta en el MQMD de cada mensaje de salida como cola de respuestas. Este nuevo valor modifica el valor actual en MQMD.
  4. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  5. Pulse Aplicar para efectuar los cambios en el nodo MQeOutput sin cerrar el diálogo de propiedades. Pulse 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.

Conexión de terminales

Conecte el terminal de entrada al nodo desde el que se direccionan los mensajes de salida.

Conecte el terminal de salida o el terminal de anomalías de este nodo a otro nodo de este flujo de mensajes si desea procesar adicionalmente el mensaje, procesar errores o enviar el mensaje a un destino adicional.

Si lo hace, el entorno local asociado al mensaje se amplía con la siguiente información para cada destino en el que este nodo ha colocado el mensaje:

  • Nombre de cola
  • Nombre del gestor de colas
  • Identificador de respuesta de mensaje (se establece en el mismo valor que el ID de mensaje)
  • ID de mensaje (de MQMD)
  • ID de correlación (de MQMD)

Estos valores se escriben en WrittenDestination dentro de la estructura de árbol del entorno local.

Si no conecta ninguno de estos dos terminales, el árbol del entorno local no se modifica.

Si utiliza agregación en los flujos de mensajes, debe utilizar estos terminales.

Terminales y propiedades

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

Terminal Descripción
In (de entrada) El terminal de entrada que acepta un mensaje para que lo procese el nodo.
Failure (de anomalías) El terminal de salida al que se direcciona el mensaje si se detecta una anomalía al transferir el mensaje a la cola de salida.
Out (de salida) El terminal de salida al que se direcciona el mensaje si se ha colocado satisfactoriamente en la cola de salida y se requiere proceso adicional dentro del flujo de mensajes.

Las tablas siguientes describen las propiedades del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si tiene que entrar un valor cuando no hay definido ningún valor por omisión), 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).

Las propiedades básicas del nodo MQeOutput se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Nombre del gestor de colas No   El nombre del gestor de colas de WebSphere MQ Everyplace para el que se define la cola de salida, especificada en Nombre de cola.
Nombre de cola No   El nombre de la cola de salida de WebSphere MQ Everyplace en el que este nodo coloca mensajes.

La propiedad avanzada del nodo MQeOutput se describe en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Modalidad de destino No Lista de destinos Las colas a las que se envía el mensaje de salida. Los valores válidos son Nombre de cola, Cola de respuestas y Lista de destinos.

Las propiedades de petición del nodo MQeOutput se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Petición No No seleccionado Indica si los mensajes de salida deben generarse como mensajes de petición. Si selecciona el recuadro, se realizará esta acción.
Gestor de colas de respuesta No   El nombre del gestor de colas para el que se define la cola de salida, especificada en Cola de respuestas.
Cola de respuestas No   El nombre de la cola de respuestas en la que se debe poner una respuesta a esta petición.

Las propiedades de descripción del nodo MQeOutput se describen en la siguiente tabla.

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 el propósito 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
ac04610_