Nodo MQeOutput

Este tema contiene los apartados siguientes:

Finalidad

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

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

No puede utilizar el nodo MQeOutput para cambiar las características transaccionales del flujo de mensajes. Las características transaccionales que establece 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 van a difundir a sistemas z/OS.

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

Si no desea que el flujo de mensajes envíe mensajes a una cola WebSphere MQ Everyplace, puede elegir otro nodo de salida para el que se ofrezca soporte:

  • MQReply
  • MQOutput
  • SCADAOutput
  • Publication

El nodo MQeOutput se representa en el área de trabajo mediante el icono siguiente:

icono del nodo MQeOutput

Utilización de este nodo en un flujo de mensajes

Como ejemplo sobre cómo se puede utilizar este nodo, suponga que un agricultor inspecciona sus campos para comprobar si se riegan correctamente. Lleva consigo un dispositivo PDA con WebSphere MQ Everyplace instalado. Observa que sus campos no se están regando, así que utiliza el PDA con un enlace de navegación global por satélite (Global Satellite Navigation) para comprobar la válvula del flujo de agua y ve que está defectuosa. Esta información está disponible debido a que el dispositivo SCADA remoto responsable del control de la válvula ha publicado un mensaje de diagnóstico, que ha recuperado el intermediario y enviado a un nodo MQeOutput y al cliente WebSphere MQ Everyplace del dispositivo PDA.

Documentación de WebSphere MQ Everyplace

Puede obtener información detallada sobre WebSphere MQ Everyplace y las propiedades del nodo, en la documentación de WebSphere MQ Everyplace que se facilita en la página Web de WebSphere MQ.

Configuración del nodo MQeOutput

Se puede configurar al transferir una instancia del nodo MQeOutput a un flujo de mensajes. Pulse el botón derecho del ratón en la vista del editor y, a continuación, pulse en Propiedades. Se muestran las propiedades básicas del nodo.

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

Configure el nodo MQeOutput tal como se indica a continuación:

  1. Entre el Nombre del gestor de colas y el Nombre de cola que especifican el destino para el 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 que establezca estas propiedades.
  2. Seleccione Avanzadas en el navegador del diálogo de propiedades y, a continuación, seleccione la Modalidad de destino de la lista desplegable. De este modo, se identifican las colas a las que se debe entregar el mensaje de salida.
    • Nombre de cola. El mensaje se envía a la cola denominada en la propiedad Nombre de cola. Las propiedades Nombre del gestor de colas y Nombre de cola (que se encuentran en el separador Básico) son obligatorias si se selecciona esta opción. Éste es el valor por omisión.
    • Cola de respuestas. El mensaje se envía a la cola denominada en el campo ColaRespuestas de MQMD.
    • Lista de destinos. El mensaje se envía a la lista de colas denominadas en el entorno local (también conocido como lista de destinos) asociado a este 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 de selección Petición para indicar que cada mensaje de salida se marque en MQMD como un mensaje de solicitud (MQMD_REQUEST), y borre el campo de identificador de mensaje (establézcalo en MQMI_NONE) para asegurarse de que WebSphere MQ genere un nuevo identificador. Deseleccione el recuadro de selección para indicar que los mensaje de salida no se marquen como mensajes de solicitud. Este recuadro de selección no se puede seleccionar si se ha seleccionado una Modalidad de destino de Cola de respuestas.
    2. Especifique un nombre de gestor de colas WebSphere MQ Everyplace en Gestor de cola de respuestas. Este nombre se inserta en el MQMD de cada mensaje de salida como gestor de cola de respuestas. Este nuevo valor altera temporalmente el valor actual de MQMD.
    3. Especifique un nombre de cola WebSphere MQ Everyplace en Cola de respuestas. Este nombre se inserta en el MQMD de cada mensaje de salida como cola de respuestas. Este nuevo valor altera temporalmente el valor actual de MQMD.
  4. Seleccione Descripción en el navegador del diálogo de propiedades para especificar una descripción corta, una descripción larga, o ambas.
  5. Pulse el botón en Aplicar para realizar los cambios en el nodo MQeOutput sin cerrar el diálogo de propiedades. Pulse el botón en Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse el botón en Cancelar para cerrar el diálogo y descartar todos los cambios que ha realizado en las propiedades.

Conexión de terminales

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

Conecte el terminal de anomalías o el terminal de salida de este nodo a otro nodo de este flujo de mensajes si desea que se envíe el mensaje a un destino adicional.

Terminales y propiedades

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

Terminal Descripción
Terminal de entrada Terminal de entrada que acepta un mensaje para que lo procese el nodo.
Terminal de anomalías Terminal de salida al que se direcciona el mensaje si se detecta una anomalía web el mensaje a la cola de salida.
Terminal de salida Terminal de salida al que se direcciona el mensaje si se transfiere correctamente a la cola de salida, y si se requieren procesos ulteriores en el flujo de mensajes.

En las tablas siguientes se describen las propiedades del nodo; la columna que tiene el encabezamiento M indica si se trata de una propiedad obligatoria (marcada con un asterisco en el diálogo de propiedades si se debe especificar un valor cuando no se ha definido ningún valor por omisión), la columna que tiene el encabezamiento C indica que se trata de una propiedad configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para su difusión).

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

Propiedad M C Valor por omisión Descripción
Nombre del gestor de colas No   Nombre del gestor de colas WebSphere MQ Everyplace para el que se ha definido la cola de salida, especificada en Nombre de cola.
Nombre de cola No   Nombre de la cola de salida WebSphere MQ Everyplace a la que transfiere mensajes este nodo.

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

Propiedad M 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 tabla siguiente:

Propiedad M C Valor por omisión Descripción
Petición No Deseleccionada Si los mensajes de salida se van a generar como mensajes de solicitud. Si selecciona el recuadro de selección, se realiza la acción.
Gestor de cola de respuestas No   Nombre del gestor de colas para el que se ha definido la cola de salida, especificada en Cola de respuestas.
Cola de respuestas No   Nombre de la cola de respuesta a la que se debe transferir una respuesta para esta petición.

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

Propiedad M 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.

Conceptos relacionados
WebSphere MQ Mobile Transport
Flujos de mensajes
Difusión de aplicaciones de flujos de mensajes

Tareas relacionadas
Trabajo con casos de WebSphere MQ Everyplace de ejemplo
Cómo decidir los nodos que utilizar
Utilización de colas de clúster WebSphere MQ para entrada y salida
Utilización de colas compartidas de WebSphere MQ para entrada y salida (z/OS)
Manejo de errores en flujos de mensajes
Edición de propiedades configurables

Referencia relacionada
WebSphere MQ Mobile Transport
Nodo MQeInput
Nodo MQOutput
Nodo MQReply
Nodo SCADAOutput
Nodo Output