WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

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 o colas 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 el Nombre del gestor de colas en blanco.

Puede configurar el nodo MQOutput para colocar un mensaje en una cola específica de WebSphere MQ que se ha definido en cualquier gestor de colas a la cual el gestor de colas puede acceder para el intermediario, o en los destinos identificados en el entorno local asociado al mensaje.

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 comprueba si hay una cabecera MQMD (WebSphere MQ descriptor de mensaje) en el árbol de mensajes. Si no hay ninguna cabecera MQMD, el nodo MQOutput crea una en el árbol de mensajes y la llena con las propiedades predeterminas de MQMD. Si se encuentra una cabecera MQMD, el nodo MQOutput comprueba si es una cabecera de tipo WebSphere MQ y si no lo es, establece la propiedad Contexto de mensaje en Predeterminado. El nodo MQOutput trata cualquier otra cabecera de transporte del árbol de mensajes como datos. Si estas cabeceras no son necesarias como parte del cuerpo del mensaje, utilice un nodo de transformación para eliminarlas de árbol de mensajes antes del nodo MQOutput. Si el árbol de mensajes proviene de JMS, puede utilizar un nodo JMSMQTransform para construir un árbol de mensajes compatible con MQ. Para más detalles, consulte el apartado Transformación de mensajes JMS.

El nodo MQOutput se encuentra en la bandeja de WebSphere MQ de la paleta y está representado en el WebSphere Message Broker Toolkit 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 se debe utilizar este nodo:

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

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. El usuario configura un nodo Compute para crear un nuevo mensaje de salida cada vez que cambia el valor de una acción determinada y conecta dicho nodo a un nodo MQOutput para registrar todos los cambios de precio de dicha acción.

Cómo trabajar con datos WrittenDestination

Tras colocar el mensaje, la carpeta WrittenDestination del entorno local se actualizará con la información de destino. Los datos de WrittenDestination de un nodo MQOutput tienen el formato siguiente:
WrittenDestination = (
   MQ  = (
      z`DestinationData = (
         queueName        = 'OUT'
         queueManagerName = 'MYQUEUEMANAGER'
         replyIdentifier = X'4d...2e'
         msgId           = X'3c...2c'
         correlId        = X'2a...00'
         GroupId         = X'3a...00'
      )
   )
)

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 procesar adicionalmente el mensaje, procesar errores o enviar el mensaje a un destino adicional.

Si utiliza agregación en los flujos de mensajes, debe utilizar los terminales de salida.

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.

Una vez que la estructura MQMD de salida se ha construido, el Message Context del nodo MQOutput se ignora 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.

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 el 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 el punto de sincronismo si el mensaje de entrada está marcado como persistente.
  • Si selecciona No, el mensaje no se graba bajo el 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

Cuando haya colocado una instancia del nodo MQOutput en un flujo de mensajes, podrá configurarlo; consulte el tema Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista 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) Terminal de salida al que se direcciona el mensaje, si éste se ha colocado satisfactoriamente en la cola de salida.

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 predeterminado Descripción
Nombre de nodo No No El tipo de nodo, MQOutput El nombre del nodo.
Descripción corta No No   Una 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 predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Nombre del gestor de colas No   Escriba el nombre del gestor de colas de WebSphere MQ para el que se define esta cola de salida (especificada en la propiedad Nombre de cola).

La propiedad Nombre del gestor de colas sólo es necesaria si la cola especificada está definida en otro gestor de colas o es una cola del clúster. Si es una cola de clúster, Nombre del gestor de colas se puede especificar opcionalmente si desea ser preceptivo sobre qué gestor de colas recibe el mensaje. Si la cola está definida en un gestor de colas remoto, debe especificarse el Nombre del gestor de colas y debe coincidir con la cola de transmisión definida en el gestor de colas local del intermediario, para dicho gestor de colas.

queueManagerName
Nombre de cola No   Para enviar el mensaje de salida a una sola cola de destino que está definida por este nodo, escriba el nombre de la cola de salida de WebSphere MQ a la cual el flujo de mensajes envía los mensajes.

Si establece la propiedad Modalidad de destino en Nombre de cola, debe especificar un valor para la propiedad Nombre de cola. Si establece Modalidad de destino en otro valor, se hará caso omiso de esta propiedad.

queueName

Las propiedades Avanzadas del nodo MQOutput están descritas en la siguiente tabla. Estas propiedades definen el control transaccional para el mensaje y la forma en que se coloca el mensaje en la cola. Muchas de estas propiedades se corresponden con opciones de la llamada MQPUT.

Propiedad O C Valor predeterminado Descripción
Modalidad de destino No Nombre de cola Las colas a las que se envía el mensaje de salida.
  • Si selecciona Nombre de cola (el valor predeterminado), el mensaje se envía a la cola que especificada en la propiedad Nombre de cola. Si selecciona esta opción, debe establecer las propiedades Nombre del gestor de colas y Nombre de cola.
  • Si selecciona Cola de respuestas, el mensaje se envía a la cola que especificada en el campo ReplyToQ en MQMD.

    Cuando se selecciona este valor, el nodo MQOutput construye un mensaje de respuesta WebSphere MQ. Para obtener más información sobre los valores que utiliza el nodo MQOutput y la carpeta Root.MQMD en esta situación, consulte Contenido del mensaje de respuesta de WebSphere MQ.

  • Si selecciona Lista de destino, el mensaje se envía a la lista de colas especificadas en el entorno local que está asociado al mensaje. Los datos que ha indicado se utilizan en el subárbol DestinationData del entorno local. Para obtener más información sobre el subárbol DestinationData, consulte Tipos de datos para elementos del subárbol DestinationData de MQ. Para obtener más información sobre las listas de destino, consulte Crear listas de destino.
Modalidad de transacción No Automática Esta propiedad controla si el mensaje se transfiere transaccionalmente.
  • 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.
Modalidad de persistencia No Automática Esta propiedad controla si el mensaje se transfiere persistentemente.
  • 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.
Nuevo ID de mensaje No Deseleccionado Si marca este recuadro, WebSphere MQ genera un identificador de mensajes nuevo para sustituir el contenido del campo MsgId en MQMD. 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 la propiedad Petición en el separador Petición.

Para obtener más información sobre las opciones con las que se correlaciona esta propiedad, consulte la sección Application Programming Reference de la publicación Centro de información en línea de WebSphere MQ Versión 7.

Nuevo ID correlación No Deseleccionado Si selecciona este recuadro, WebSphere MQ genera un nuevo identificador de correlación para sustituir el contenido del campo CorrelId de MQMD. 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.

Para obtener más información sobre las opciones con las que se correlaciona esta propiedad, consulte la sección Application Programming Reference de la publicación Centro de información en línea de WebSphere MQ Versión 7.

Segmentación permitida No Deseleccionado Si selecciona este recuadro, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. Deseleccione el recuadro si no desea que se efectúe la segmentación. Para obtener más información sobre la segmentación de mensajes, consulte Envío de segmentos de mensajes en un mensaje WebSphere MQ.

Para obtener más información sobre las opciones con las que se correlaciona esta propiedad, consulte la sección Application Programming Reference de la publicación Centro de información en línea de WebSphere MQ Versión 7.

Contexto del mensaje No Pasar todo Esta propiedad controla cómo se maneja el contexto de origen.
  • 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.

Cuando un perfil de seguridad está asociado con el nodo y está configurado para realizar la propagación de identidad, el contexto elegido puede alterarse temporalmente para garantizar que se establezca la identidad de salida.

Para obtener más información sobre las opciones con las que se correlacionan estas propiedades, consulte la sección Application Programming Reference de la publicación Centro de información en línea de WebSphere MQ Versión 7.

Autorización de usuario alternativo No Deseleccionado Si marca este recuadro de selección, se utiliza la autorización alternativa cuando se coloca el mensaje de salida y se establece 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.

Las propiedades de petición del nodo MQOutput se describen en la siguiente tabla. Estas propiedades definen las características de cada mensaje de salida que se genera.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Petición No Deseleccionado Si marca el recuadro de selección, cada mensaje de salida de MQMD se genera como un mensaje de petición (MQMT_REQUEST), y el campo del identificador de mensajes se borra (y se establece en MQMI_NONE) de forma que WebSphere MQ genera un identificador nuevo. Deseleccione el recuadro de selección para indicar que ningún mensaje de salida está marcado como mensaje de petición. Si ha establecido Modalidad de destino en Cola de respuestas, no puede marcar este recuadro de selección.

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

 
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. Este nombre se inserta en el MQMD de cada mensaje de salida como gestor de colas de respuesta. replyToQMgr
Cola de respuestas No   Nombre de la cola de WebSphere MQ en la que se debe poner una respuesta a esta petición. Este nombre se inserta en el MQMD de cada mensaje de salida como cola de respuesta. replyToQ

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

Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Validar No Heredar Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar. validateMaster
Acción para anomalía No No Excepción Esta propiedad controla 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.  
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:18


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac04570_