Nodo MQOutput

Este tema contiene las secciones 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 programación de aplicaciones MQI y AMI.

El nodo MQOutput entrega un mensaje de salida de un flujo de mensajes a una cola de WebSphere MQ. El nodo utiliza MQPUT para colocar el mensaje en la cola de destino que especifique.

Si es adecuado, puede definir la cola como una cola compartida o una cola de clúster de WebSphere MQ. Cuando utilice una cola de clúster de WebSphere MQ, deje el nombre del gestor de colas en blanco.

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

Puede establecer otras propiedades para controlar la forma en que se envían los mensajes, definiendo las opciones adecuadas de MQPUT. Por ejemplo, puede solicitar que un mensaje se procese bajo control de transacciones. También puede especificar que WebSphere MQ pueda, si es adecuado, dividir el mensaje en segmentos en el gestor de colas.

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, puede elegir otro nodo de salida soportado.

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

Icono de nodo MQOutput

Utilización de este nodo en un flujo de mensajes

Para obtener un ejemplo sobre cómo utilizar este nodo, supongamos que ha escrito una aplicación de publicación que publica actualizaciones de acciones de forma regular. La aplicación envía los mensajes al intermediario en un nodo MQInput y el flujo de mensajes pone las publicaciones a disposición de los diversos suscriptores, a través de un nodo Publication. Luego, usted incluye un nodo MQOutput para enviar el mensaje a una aplicación que registra cada cambio de precio que se produce.

Configuración del nodo MQOutput

Una vez ha puesto una instancia del nodo MQOutput en un flujo de mensajes, puede 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 MQOutput de la manera siguiente:

  1. Si desea enviar el mensaje de salida a una sola cola de destino que está definida por este nodo, entre el nombre de la cola a la que envía mensajes el flujo de mensajes en Nombre de cola. Entre el nombre del gestor de colas en el que está definida esta cola en Nombre del gestor de colas. Debe establecer estas propiedades si establece la propiedad avanzada Modalidad de destino (descrita más abajo) en Nombre de cola. Si establece Modalidad de destino en otro valor, se hace caso omiso de estas propiedades.
  2. Seleccione Avanzadas en el navegador del diálogo de propiedades. Estas propiedades definen el control transaccional del mensaje y la forma en que se coloca en la cola. Muchas de estas propiedades corresponden a opciones de la llamada MQPUT.
    • Seleccione Modalidad de destino en 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 nombrada en la propiedad Nombre de cola. Si selecciona esta opción, las propiedades Nombre de 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 nombrada en el campo ReplyToQ (cola de repuestas) del MQMD.
    • Seleccione Modalidad de transacción de la lista desplegable para determinar cómo se debe transferir el mensaje:
      • Si selecciona Automático (el valor por omisión), la transaccionalidad del mensaje se deducirá de la forma en que se ha especificado en el nodo de entrada.
      • Si selecciona , el mensaje se transfiere transaccionalmente.
      • Si selecciona No, el mensaje se transfiere de manera no transaccional.
      Consulte Configuración de transacciones coordinadas para obtener más información.
    • Seleccione la Modalidad de persistencia de la lista desplegable para determinar si el mensaje debe guardarse de forma persistente o no.
      • Si selecciona Automático (el valor por omisión), la persistencia será la especificada en el mensaje de entrada.
      • Si selecciona , el mensaje se transfiere de forma persistente.
      • Si selecciona No, el mensaje se transfiere de forma no persistente.
      • Si selecciona Según lo definido para la cola, la persistencia del mensaje se establece de acuerdo con lo definido para la cola de WebSphere MQ.
    • Seleccione el recuadro Nuevo ID de mensaje para generar un nuevo ID para este mensaje. Esto corresponde a la opción MQPMO_NEW_MSG_ID de MQPMO de MQI.

      Deseleccione el recuadro si no desea generar un nuevo ID. Tenga en cuenta que se generará de todas formas un nuevo ID de mensajes si selecciona el recuadro de selección Petición en el panel Petición del diálogo de propiedades.

      En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.

    • Seleccione el recuadro Nuevo ID de correlación para generar un nuevo ID de correlación para este mensaje. Esto corresponde a la opción MQPMO_NEW_CORREL_ID de MQPMO de MQI. Deseleccione el recuadro si no desea generar un nuevo ID.

      En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.

    • Seleccione el recuadro Segmentación permitida si desea que WebSphere MQ segmente el mensaje dentro del gestor de colas, cuando sea adecuado. También debe establecer MQMF_SEGMENTATION_ALLOWED en el campo MsgFlags en MQMD para que se realice la segmentación. Deseleccione el recuadro si no desea que se efectúe la segmentación.

      En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.

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

      En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que están correlacionadas estas propiedades.

    • Seleccione el recuadro Autorización de usuario alternativo si desea establecer la opción MQOO_ALTERNATE_USER_AUTHORITY en las opciones abiertas (MQOO) de MQI. Si selecciona este recuadro, al abrir la cola para la salida se especifica esta opción. La información de usuario alternativo se recupera de la información del contexto del mensaje. Deseleccione el recuadro de selección si no quiere especificar la autorización de usuario alternativo. Si deselecciona el recuadro, para transferir el mensaje se utiliza el ID de usuario del servicio de intermediario.
  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 para marcar cada mensaje de salida en el MQMD como un mensaje de petición (MQMT_REQUEST) y borre el campo de identificador de mensaje (establecido en MQMI_NONE) para asegurar que WebSphere MQ genera un nuevo identificador. Deseleccione el recuadro de selección 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.

      Tenga en cuenta que se generará un nuevo identificador de mensaje aunque no se marque el recuadro de selección Nuevo ID de mensaje en el panel Avanzado del navegador del diálogo de propiedades.

    • Entre un nombre de gestor de colas en Gestor de colas de respuesta. Éste se inserta en el MQMD de cada mensaje de salida como gestor de colas de respuesta.
    • Entre un nombre de cola en Cola de respuesta. Éste 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 entrar una descripción breve, una descripción completa, o ambas.
  5. Pulse Aplicar para efectuar los cambios en el nodo MQOutput 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 descartar 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 enviar el mensaje a un destino adicional.

Configuración de transacciones coordinadas

Cuando se define un nodo MQOutput, la opción seleccionada para la propiedad Modalidad de transacción indica si el mensaje se graba bajo punto de sincronismo o no:

  • Si tiene el valor , el mensaje se graba bajo punto de sincronismo (es decir, dentro de una unidad de trabajo de WebSphere MQ).
  • Si el valor es Automático (el valor por omisión), el mensaje se grabará bajo punto de sincronismo si el mensaje de entrada está marcado como persistente.
  • Si es No, el mensaje no se grabará bajo punto de sincronismo.

Otra propiedad del nodo MQOutput, Modalidad de persistencia, indica si el mensaje de salida se marca como persistente cuando se transfiere a la cola de salida:

  • Si el valor es , el mensaje se marca como persistente.
  • Si es Automático (el valor por omisión), la persistencia del mensaje se determina por las propiedades del mensaje de entrada, según lo definido en MQMD (el descriptor de mensajes de WebSphere MQ).
  • Si el valor es No, el mensaje no se marca como persistente.
  • Si es Según lo definido para la cola, la persistencia del mensaje será la definida en la cola de WebSphere MQ por el nodo MQOutput especificando la opción MQPER_PERSISTENCE_AS_Q_DEF en MQMD.

Terminales y propiedades

Los terminales del nodo MQOutput 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 está 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 MQOutput 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 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 en el que este nodo coloca mensajes (utilizando MQPUT).

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

Propiedad O 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 , Cola de respuestas y Nombre de cola.
Modalidad de transacción No Automático Define si el mensaje se transfiere transaccionalmente. Los valores válidos son Automático, y No.
Modalidad de persistencia No Automático Define si el mensaje se transfiere de forma persistente. Los valores válidos son Automático, , No y Según lo definido para la cola.
Nuevo ID de mensaje No No seleccionado Especifica si WebSphere MQ genera un nuevo identificador de mensaje para sustituir el contenido del campo MsgId de MQMD. Si selecciona el recuadro, se realizará esta acción.
Nuevo ID correlación No No seleccionado Especifica si WebSphere MQ genera un nuevo identificador de correlación para sustituir el contenido del campo CorrelId de MQMD. Si selecciona el recuadro, se realizará esta acción.
Segmentación permitida No No seleccionado Si resulta adecuado, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. Si selecciona el recuadro, se realizará esta acción.
Contexto del mensaje No Pasar todo Indica cómo 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 No seleccionado Indica si se utiliza la autorización alternativa cuando se transfiere el mensaje de salida. Si selecciona el recuadro, se realizará esta acción.

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

Propiedad O C Valor por omisión Descripción
Petición No No seleccionado Indica si debe generarse cada mensaje de salida como un mensaje de petición. Si selecciona el recuadro, se realizará esta acción.
Gestor de colas de respuestas No   Nombre del gestor de colas WebSphere MQ en el que se define la cola de salida, especificada en Cola de respuestas.
Cola de respuestas No   Nombre de la cola de WebSphere MQ en la que se debe poner una respuesta a esta petición.

Las propiedades de descripción del nodo MQOutput 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, 2005 Última actualización: 07/11/2005
ac04570_