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 o colas 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, o en los destinos identificados en el entorno local (también denominado Lista de destinos) asociados al mensaje.

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 entorno de trabajo con el siguiente icono:

Icono de nodo MQOutput

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo puede utilizar este nodo:

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 configura un nodo Compute para crear un nuevo mensaje de salida siempre que cambia el valor de una acción particular y transmite estos a un nodo MQOutput para registrar todos los cambios de precio de esta acción.

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.
      • 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.
    • Seleccione Modalidad de transacción de la lista desplegable para determinar cómo se debe transferir el mensaje:
      • Si selecciona Automática (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ática (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 Validación en el navegador del diálogo de propiedades si desea que el analizador MRM valide el cuerpo de los mensajes contra el diccionario generado del conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

    Si desea ver más información detallada, consulte los apartados Validar mensajes y Propiedades de validación para mensajes del dominio MRM.

  5. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  6. 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 procesar adicionalmente el mensaje, procesar errores o enviar el mensaje a un destino adicional.

Si conecta uno de estos terminales de salida a otro nodo en el flujo de mensajes, 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 los terminales de salida.

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 sincronización o no:

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

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ática (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 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 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 Lista de destinos, Cola de respuestas y Nombre de cola.
Modalidad de transacción No Automática Define si el mensaje se transfiere transaccionalmente. Los valores válidos son Automática, y No.
Modalidad de persistencia No Automática Define si el mensaje se transfiere de forma persistente. Los valores válidos son Automática, , 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.

En la tabla siguiente se describen las propiedades de Validación del nodo MQOutput.

Consulte el apartado Propiedades de validación para mensajes del dominio MRM para obtener una descripción completa de estas propiedades.

Propiedad O C Valor por omisión Descripción
Validar Heredar Determina si se realiza la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar.
Acción para anomalía No Excepción Determina qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones.
Incluir todas las limitaciones de valor No Seleccionado Esta propiedad no se puede editar. La acción por omisión, indicada por el recuadro de selección marcado, es que se incluyan comprobaciones de restricción de valor básicas en la validación de Contenido y valor.
Arreglo No Ninguno Esta propiedad no se puede editar.

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, 2006 Última actualización: 22/08/2006
ac04570_