Nodo MQOutput

Utilice el nodo MQOutput para enviar mensajes a clientes que se conecten con el intermediario utilizando WebSphere MQ Enterprise Transport y que utilicen las interfaces de programación de aplicaciones MQI y AMI.

Este tema contiene las secciones siguientes:

Finalidad

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

Si es adecuado, defina 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 vacío el Nombre de gestor de colas.

Puede configurar el nodo MQOutput 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.

Establezca 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 transacción. 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 podrá utilizar un nodo de salida estándar; utilice una instancia del nodo Output para crear un terminal de salida para el 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, elija otro nodo de salida soportado.

El nodo MQOutput se encuentra en la bandeja de WebSphere MQ de la paleta y está representado en el entorno de trabajo con el siguiente icono:

Icono de nodo MQOutput

Utilización de este nodo en un flujo de mensajes

Por ejemplo, para utilizar este nodo, suponga que ha escrito una aplicación de publicación para publicar actualizaciones de unas acciones regularmente. 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 múltiples suscriptores a través del un nodo Publication. Por lo tanto, usted incluye un nodo MQOutput para enviar el mensaje a una aplicación que registra todos los cambios de precio que se producen.

Configuración del nodo MQOutput

Cuando haya colocado una instancia del nodo MQOutput en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Para visualizar las propiedades del nodo, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades.

Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Configure el nodo MQOutput.

  1. Opcional: En el separador Descripción, entre una descripción corta, una descripción larga, o ambas. En esta página también puede redenominar el nodo.
  2. En el separador Básicas:
    • Para 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 Modalidad de destino del separador Avanzadas (que se describe posteriormente en esta sección) en Nombre de cola. Si establece Modalidad de destino en otro valor, se hace caso omiso de estas propiedades.
  3. Las propiedades del separador Avanzadas definen el control transaccional del mensaje y la forma en que éste se coloca en la cola. Muchas de estas propiedades se corresponden con opciones de la llamada MQPUT.
    • Seleccione la Modalidad de destino en la lista. Esta propiedad identifica las colas en las que se coloca el mensaje de salida:
      • Nombre de cola (el valor predeterminado). El mensaje se envía a la cola que se indica en la propiedad Nombre de cola. Las propiedades Nombre del gestor de colas y Nombre de cola del separador Básicas son obligatorias si selecciona esta opción.
      • Cola de respuestas. El mensaje se envía a la cola que se indica en el campo ReplyToQ (cola de repuestas) del MQMD.

        Inicio del cambioCuando se selecciona esta opción, el nodo MQOutput construye un mensaje de respuesta WebSphere MQ. Consulte Contenido del mensaje de respuesta de WebSphere MQ para obtener más información sobre los valores utilizados por el nodo MQOutput y la carpeta Root.MQMD en esta situación.Fin del cambio

    • Seleccione la Modalidad de transacción en la lista para determinar cómo se debe transferir el mensaje:
      • Si selecciona Automática (el valor predeterminado), 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.
      Para obtener más información, consulte Configuración de transacciones coordinadas.
    • Seleccione la Modalidad de persistencia en la lista para determinar si el mensaje debe transferirse de forma persistente:
      • Si selecciona Automática (el valor predeterminado), 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 Nuevo ID de mensaje para generar un nuevo ID para este mensaje. Esta propiedad se corresponde con la opción MQPMO_NEW_MSG_ID de la estructura MQPMO de la MQI.

      Deseleccione el recuadro si no desea generar un nuevo ID. Se generará de todas formas un nuevo ID de mensaje si selecciona Petición en el separador Petición.

      Puede ver más información sobre las opciones relacionadas con esta propiedad en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ

    • Seleccione Nuevo ID de correlación para generar un nuevo ID de correlación para este mensaje. Esta propiedad se corresponde con la opción MQPMO_NEW_CORREL_ID de la estructura MQPMO de la MQI. Deseleccione el recuadro si no desea generar un nuevo ID.

      Puede ver más información sobre las opciones relacionadas con esta propiedad en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ

    • Seleccione Segmentación permitida si desea que WebSphere MQ segmente el mensaje dentro del gestor de colas, cuando sea adecuado. Deseleccione el recuadro si no desea que se efectúe la segmentación. Inicio del cambioConsulte Envío de segmentos de mensajes en un mensaje WebSphere MQ para obtener más información sobre la segmentación de mensajes.Fin del cambio

      Puede ver más información sobre las opciones relacionadas con esta propiedad en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ

    • Seleccione Contexto de mensaje para indicar cómo debe tratarse el contexto de origen. Seleccione una de las opciones siguientes:
      • Pasar todo se corresponde con la opción MQPMO_PASS_ALL_CONTEXT de la estructura MQPMO de la MQI.
      • Pasar identidad se corresponde con la opción MQPMO_PASS_IDENTITY_CONTEXT de la estructura MQPMO de la MQI.
      • Definir todo se corresponde con la opción MQPMO_SET_ALL_CONTEXT de la estructura MQPMO de la MQI.
      • Definir identidad se corresponde con la opción MQPMO_SET_IDENTITY_CONTEXT de la estructura MQPMO de la MQI.
      • Valor predeterminado se corresponde con la opción MQPMO_DEFAULT_CONTEXT de la estructura MQPMO de la MQI.
      • Ninguna se corresponde con la opción MQPMO_NO_CONTEXT de la estructura MQPMO de la MQI.

      Puede ver más información sobre las opciones relacionadas con estas propiedades en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ

    • Seleccione 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.
  4. En el separador Petición, establezca las propiedades para definir las características de cada mensaje de salida generado.
    • Seleccione 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 genere 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.

      Se generará un nuevo identificador de mensaje aunque el recuadro Nuevo ID de mensaje no esté seleccionado en el separador Avanzadas.

    • Entre un nombre de gestor de colas en Gestor de colas de respuesta. Este nombre 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. Este nombre se inserta en el MQMD de cada mensaje de salida como cola de respuesta.

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 para enviar el mensaje a un destino adicional.

Inicio del cambio

Contenido del mensaje de respuesta de WebSphere MQ

Los:
  • Los valores de los siguientes campos de MQMD están establecidos, independientemente de los valores que indique:
      MQMD.Report = 0;
      MQMD.PutApplType = MQAT_BROKER;
      MQMD.PutDate = Taken from current Timestamp
      MQMD.PutTime = Taken from current Timestamp
      MQMD.PutApplName = MsgTree.MQMD.ReplyToQMgr (first 28 chars)  
  • Los valores de los siguientes campos se establecen tomando los valores de la carpeta Root.MQMD:
      MQMD.Version
      MQMD.Format
      MQMD.Priority
      MQMD.Persistence
      MQMD.Expiry
      MQMD.Encoding
      MQMD.CodedCharSetId
      MQMD.GroupId
      MQMD.MsgSeqNumber
      MQMD.Offset
      MQMD.MsgFlags
      MQMD.OriginalLength
  • Los siguientes valores de MQMD se establecen condicionalmente, basándose en los valores del nodo MQOutput y la carpeta Root.MQMD:
      IF MsgTree.MQMD.MsgType = MQMT_REQUEST THEN                       
        MQMD.MsgType = MQMT_REPLY;                                      
      IF Nodes Message Context is Default, PassAll or PassIdentity THEN 
        MQMD.UserIdentifer = MsgTree.MQMD.UserIdentifier;               
      IF MsgTree.MQMD.Report contains MQRO_PASS_CORREL_ID THEN          
        MQMD.CorrelId = MsgTree.MQMD.CorrelId;                          
      ELSE                                                              
        MQMD.CorrelId = MsgTree.MQMD.MsgId;                       
      IF MsgTree.MQMD.Report contains MQRO_PASS_MSG_ID THEN             
        MQMD.MsgId = MsgTree.MQMD.MsgId;                                
      ELSE                                                              
        MQMD.MsgId = MQMI_NONE;  
  • El valor del campo MQMD.Persistence se establece en base a la modalidad Persistence del nodo MQOutput.

Cuando la estructura MQMD de salida se ha construido, el Message Context del nodo MQOutput se omite y el comportamiento es set All.

Los valores que se alteran temporalmente, sólo lo hacen en la estructura MQMD de salida; no se realiza ninguna actualización en la carpeta MQMD del árbol de mensajes.

Fin del cambio

Configuración de transacciones coordinadas

Cuando se define un nodo MQOutput, la opción seleccionada para la propiedad Modalidad de transacción define si el mensaje se graba bajo punto de sincronismo:
  • Si selecciona , el mensaje se graba bajo punto de sincronismo (es decir, dentro de una unidad de trabajo de WebSphere MQ).
  • Si selecciona Automática (el valor predeterminado), el mensaje se grabará bajo punto de sincronismo si el mensaje de entrada está marcado como persistente.
  • Si selecciona No, el mensaje no se graba bajo punto de sincronismo.
Otra propiedad del nodo MQOutput, Modalidad de persistencia, define si el mensaje de salida está marcado como persistente cuando transfiere a la cola de salida:
  • Si selecciona , el mensaje se marca como persistente.
  • Si selecciona Automática (el valor predeterminado), la persistencia del mensaje viene determinada por las propiedades del mensaje de entrada, según lo definido en MQMD.
  • Si selecciona No, el mensaje no se marca como persistente.
  • Si selecciona 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 están descritos 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 de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); 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 de descripción del nodo MQOutput están descritas en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Nombre de nodo No No El tipo de nodo, MQOutput El nombre del nodo.
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.

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 están descritas 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ática Esta propiedad controla si el mensaje se transfiere transaccionalmente. Los valores válidos son Automática, y No.
Modalidad de persistencia No Automática Esta propiedad controla si el mensaje se transfiere persistentemente. Los valores válidos son Automática, , No y Según lo definido para la cola.
Nuevo ID de mensaje No No seleccionado Si selecciona este recuadro, WebSphere MQ genera un nuevo identificador de mensaje para sustituir el contenido del campo MsgId de MQMD.
Nuevo ID correlación No No seleccionado Si selecciona este recuadro, WebSphere MQ genera un nuevo identificador de correlación para sustituir el contenido del campo CorrelId de MQMD.
Segmentación permitida No No seleccionado Si selecciona este recuadro, WebSphere MQ divide el mensaje en segmentos en el gestor de colas.
Contexto del mensaje No Pasar todo Esta propiedad controla cómo se maneja el contexto de origen. Los valores válidos son Pasar todo, Pasar identidad, Definir todo, Definir identidad y Valor predeterminado.
Autorización de usuario alternativo No No seleccionado Si selecciona este recuadro, se utiliza la autorización alternativa cuando se transfiere el mensaje de salida.

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 Si selecciona el recuadro, cada mensaje de salida se genera como un mensaje de petición.
Gestor de colas de respuestas No   El nombre del gestor de colas de WebSphere MQ para 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.
Referencia relacionada
Nodo MQInput
Nodo Output
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Reservados todos los derechos.
Última actualización : 2009-02-16 14:30:23

ac04570_