Nodo MQOutput

Este tema contiene los apartados siguientes:

Finalidad

Utilice el nodo MQOutput para enviar mensajes a clientes que se conectan al intermediario utilizando WebSphere MQ Enterprise Transport y que utilizan las interfaces de programas de aplicación MQI y AMI.

El nodo MQOutput entrega un mensaje de salida de un flujo de mensajes a una cola WebSphere MQ. El nodo utiliza MQPUT para transferir el mensaje a la cola de destino especificadas.

Puede configurar el nodo MQOutput para que transfiera un mensaje a una cola WebSphere MQ específica definida en cualquier gestor de colas al que pueda acceder el gestor de colas del intermediario.

Puede establecer otras propiedades para controlar el modo en el que se envían los mensajes, haciendo que se establezcan las opciones MQPUT adecuadas. Por ejemplo, puede solicitar que se procese un mensaje bajo el control de transacción. También puede especificar que, si procede, WebSphere MQ pueda dividir el mensaje en segmentos en el gestor de colas.

Si crea un flujo de mensajes para utilizarlo como un subflujo, no puede utilizar un nodo de salida estándar, sino que 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, puede elegir otro nodo de salida para el que se ofrezca soporte:

  • MQReply
  • MQeOutput
  • SCADAOutput
  • Publication

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

icono del nodo MQOutput

Utilización de este nodo en un flujo de mensajes

Como ejemplo sobre cómo utilizar este nodo, suponga que ha escrito una aplicación de publicación que publica actualizaciones de valores con carácter regular. La aplicación envía los mensajes al intermediario de un nodo MQInput, y el flujo de mensajes permite que las publicaciones estén disponibles para varios suscriptores a través del nodo Publication.Debe incluir un nodo MQOutput para enviar el mensaje a una aplicación que registre cada cambio de precio que se produzca.

Configuración del nodo MQOutput

Se puede configurar al transferir una instancia del nodo MQOutput 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 MQOutput tal como se indica a continuación:

  1. Si desea enviar el mensaje de salida a una única cola de destino que haya definido este nodo, especifique en Nombre de cola el nombre de la cola a la que el flujo de mensajes envía mensajes. Indique el nombre del gestor de colas para el que se ha definido esta cola en Nombre del gestor de colas. Debe establecer estas propiedades si establece Modalidad de destino (descrita más abajo) de la propiedad Avanzadas en Nombre de cola. Si establece Modalidad de destino en otro valor, estas propiedades se ignoran.
  2. Seleccione Avanzadas en el navegador del diálogo de propiedades. Estas propiedades definen el control transaccional del mensaje y el modo en el que se transfiere el mensaje a la cola. Muchas de estas propiedades se correlacionan con opciones en la invocación de MQPUT.
    • Seleccione la Modalidad de destino de la lista desplegable. De este modo, se identifican las colas a las que se transfiere 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.
    • Seleccione la Modalidad de transacción de la lista desplegable para determinar cómo debe transferirse el mensaje.
      • Si selecciona Automático (el valor por omisión), la transaccionalidad del mensaje se deriva del modo que se ha especificado en el nodo de entrada.
      • Si selecciona , el mensaje se transfiere de forma transaccional.
      • Si selecciona No, el mensaje se transfiere de forma no transaccional.
      Para obtener más información, consulte el apartado Configuración de transacciones coordinadas.
    • Seleccione la Modalidad de permanencia de la lista desplegable para determinar si el mensaje debe transferirse de forma permanente.
      • Si selecciona Automático (el valor por omisión), la permanencia es la que se ha especificado en el mensaje entrante.
      • Si selecciona , el mensaje se transfiere de forma permanente.
      • Si selecciona No, el mensaje se transfiere de forma no permanente.
      • Si selecciona Según lo define la cola, la permanencia del mensaje se establece tal como se ha definido para la cola WebSphere MQ.
    • Seleccione el recuadro de selección Nuevo ID de mensaje para generar un nuevo ID de mensaje para este mensaje. De este modo, se correlaciona con la opción MQPMO_NEW_MSG_ID de MQPMO de MQI. Deseleccione el recuadro de selección si no desea generar un nuevo ID.

      En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.

    • Seleccione el recuadro de selección Nuevo ID correlación para generar un nuevo ID de correlación para este mensaje. De este modo, se correlaciona con la opción MQPMO_NEW_CORREL_ID de MQPMO de MQI. Deseleccione el recuadro de selección si no desea generar un nuevo ID.

      En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.

    • Seleccione el recuadro de selección Segmentación permitida si desea que WebSphere MQ segmente el mensaje del gestor de colas cuando proceda. Para que la segmentación se lleve a cabo, también debe establecer MQMF_SEGMENTATION_ALLOWED en el campo IndicadoresMsjs de MQM. Deseleccione el recuadro de selección si no desea segmentación.

      En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.

    • Seleccione el Contexto del mensaje para indicar cómo se debe manejar el contexto de origen. Elija una de las opciones siguientes:
      • Pasar todo (correlaciona con la opción MQPMO_PASS_ALL_CONTEXT de MQPMO de la MQI).
      • Pasar identidad (correlaciona con la opción MQPMO_PASS_IDENTITY_CONTEXT de MQPMO de la MQI).
      • Definir todo (correlaciona con la opción MQPMO_SET_ALL_CONTEXT de MQPMO de la MQI).
      • Definir identidad (correlaciona con la opción MQPMO_SET_IDENTITY_CONTEXT de MQPMO de la MQI).
      • Valor por omisión (correlaciona con la opción MQPMO_DEFAULT_CONTEXT de MQPMO de la MQI).
      • Ninguno (correlaciona con la opción MQPMO_NO_CONTEXT de MQPMO de la MQI).

      Para obtener más información sobre las opciones con las que se correlacionan estas propiedades, consulte la publicación WebSphere MQ Application Programming Reference.

    • Seleccione el recuadro de selección Autorización de usuario alternativo si desea establecer la opción MQOO_ALTERNATE_USER_AUTHORITY en las lopciones abiertas (MQOO) de la MQI. Si selecciona este recuadro, se especifica esta opción cuando se abre la cola para la salida. La información del usuario alternativo se recupera de la información de contexto del mensaje. Deseleccione el recuadro de selección si no desea especificar la autorización de usuario alternativo. Si deselecciona el recuadro, se utiliza el ID de usuario de servicio del intermediario cuando se transfiere el 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.
    • Seleccione el recuadro de selección Petición en MQMD como 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.
    • Especifique un nombre de gestor de colas en Gestor de cola de respuestas. Este nombre se inserta en el MQMD de cada mensaje de salida como gestor de cola de respuestas.
    • Especifique un nombre de cola en Cola de respuestas. Este nombre se inserta en el MQMD de cada mensaje de salida como cola de respuestas.
  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 MQOutput 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.

Configuración de transacciones coordinadas

Cuando define un nodo MQOutput, la opción que selecciona para la propiedad Modalidad de transacción define si el mensaje se escribe bajo punto de sincronismo.

  • Si se establece en , el mensaje se escribe bajo punto de sincronismo (es decir, dentro de una unidad de trabajo de WebSphere MQ).
  • Si se establece en Automática (el valor por omisión), el mensaje se escribe bajo punto de sincronismo si el mensaje de entrada entrante se ha marcado como permanente.
  • Si se establece en No, el mensaje no se escribe bajo punto de sincronismo.

Otra propiedad del nodo MQOutput, Modalidad de permanencia, define si el mensaje de salida debe marcarse como permanente cuando se transfiere a la cola de salida:

  • Si se establece en , el mensaje se marca como permanente.
  • Si se establece en Automática (el valor por omisión), la permanencia del mensaje se determina a partir de las propiedades del mensaje entrante, tal como se ha establecido en MQMD (el descriptor de mensaje de WebSphere MQ).
  • Si se establece en No, el mensaje no se marca como permanente.
  • Si se establece Según lo definido para la cola, la permanencia del mensaje se establece tal como lo ha definido el nodo MQOutput en la cola WebSphere MQ al especificar la opción MQPER_PERSISTENCE_AS_Q_DEF en MQMD.

Terminales y propiedades

Los terminales del nodo MQOutput 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 cuando se transfiere 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 MQOutput 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 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 a la que transfiere mensajes este nodo (utilizando MQPUT).

Las propiedades avanzadas del nodo MQOutput se describen en la tabla siguiente:

Propiedad M C Valor por omisión Descripción
Modalidad de destino No Nombre de cola Las colas a las que se envía el mensaje de salida. Los valores válidos son Nombre de cola y Cola de respuestas.
Modalidad de transacción No Automática Si el mensaje se transfiere de forma transaccional. Los valores válidos son Automático, y No.
Modalidad de permanencia No Automática Si el mensaje se transfiere de forma permanente. Los valores válidos son Automática, , No y Según lo definido para la cola.
Nuevo ID de mensaje No Deseleccionado Si WebSphere MQ genera un nuevo identificador de mensaje para sustituir el contenido del campo IDMsj en MQMD. Si selecciona el recuadro de selección, se realiza esta acción.
Nuevo ID correlación No Deseleccionado Si WebSphere MQ genera un nuevo identificador de mensaje para sustituir el contenido del campo IDCorrel en MQMD. Si selecciona el recuadro de selección, se realiza esta acción.
Segmentación permitida No Deseleccionado Si procede, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. Si selecciona el recuadro de selección, se realiza esta acción.
Contexto del mensaje No Pasar todo Modo de manejar el contexto de origen. Los valores válidos son Pasar todo, Pasar identidad, Definir todo, Definir identidad y Valor por omisión.
Autorización de usuario alternativo No Deseleccionado Si se debe utilizar una autorización alternativa al transferir el mensaje de salida. Si selecciona el recuadro de selección, se realiza esta acción.

Las propiedades de petición del nodo MQOutput se describen en la tabla siguiente:

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

Las propiedades de descripción del nodo MQOutput 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 Enterprise Transport
Flujos de mensajes
Difusión de aplicaciones de flujos de mensajes

Tareas relacionadas
Cómo decidir los nodos que utilizar
Manejo de errores en flujos de mensajes
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)
Edición de propiedades configurables

Referencia relacionada
Nodo MQeOutput
Nodo MQInput
Nodo MQReply
Nodo Output
Nodo SCADAOutput

página Web de la biblioteca de WebSphere MQ