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 MQReply

Utilice el nodo MQReply para enviar una respuesta al emisor del mensaje de entrada.

Este tema contiene las secciones siguientes:

Finalidad

El nodo MQReply es una forma especializada de nodo MQOutput que transfiere el mensaje de salida a la cola de WebSphere MQ identificada por el campo ReplyToQ (cola de respuestas) de la cabecera del mensaje de entrada. Si es adecuado, puede definir la cola como una cola compartida o una cola de clúster de WebSphere MQ.

El nodo MQReply utiliza las opciones establecidas en el campo Report (Informe) del MQMD. De forma predeterminada (si no se ha establecido ninguna opción), el nodo MQReply genera un nuevo campo MsgId en el mensaje de respuesta y copia el ID del mensaje del mensaje de entrada al campo CorrelId del mensaje de respuesta. Si la aplicación receptora espera otros valores en estos campos, asegúrese de que la aplicación que transfiere el mensaje a la cola de entrada de flujo de mensajes establezca las opciones de informes necesarias, o de establecer usted mismo las opciones adecuadas en MQMD durante el proceso del mensaje en el flujo de mensajes; por ejemplo, utilice un nodo Compute para establecer las opciones de informe en el mensaje.

Puede obtener más información sobre el campo Informe en la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

El nodo MQReply 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 MQReply

Utilización de este nodo en un flujo de mensajes

Consulte el ejemplo siguiente 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.

Puede utilizar este nodo cuando reciba un pedido de un cliente. Cuando se procesa el mensaje del pedido, se envía una respuesta al cliente acusando recibo del pedido y proporcionando una fecha posible para la entrega.

Trabajo con datos en la carpeta WrittenDestination

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

Configuración del nodo MQReply

Cuando haya colocado una instancia del nodo MQReply 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.

Configure el nodo MQReply como se indica a continuación:

  1. Opcional: En el separador Descripción, entre una descripción corta, una descripción larga, o ambas. En este separador también puede renombrar el nodo.
  2. En el separador Avanzadas:
    1. Seleccione Segmentación permitida si desea que WebSphere MQ divida el mensaje en segmentos en el gestor de colas, si es conveniente. También debe establecer MQMF_SEGMENTATION_ALLOWED en el campo MsgFlags en MQMD para que se realice la segmentación.

      Puede obtener más información sobre las opciones con las que está correlacionada esta propiedad en la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

    2. Elija la modalidad de persistencia que desee para el mensaje de salida.
      • 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 en la cola de WebSphere MQ.
    3. Elija la modalidad de transacción que desee para el mensaje de salida.
      • Si selecciona Automática (el valor predeterminado), la transaccionalidad del mensaje se deducirá de lo especificado en el nodo MQInput.
      • Si selecciona , el mensaje se transfiere transaccionalmente.
      • Si selecciona No, el mensaje se transfiere de manera no transaccional.
  3. En el separador Validación, establezca las propiedades de validación; consulte Propiedades de validación. Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.

    Para obtener más información, consulte Validar mensajes.

El mensaje de respuesta se transfiere (utilizando MQPUT) a la cola llamada en el MQMD (descriptor de mensaje) del mensaje de entrada Cola de respuestas. Este destino no se puede cambiar.

Conexión de los terminales de salida a otro nodo

Conecte el terminal de salida o el terminal de anomalías de este nodo a otro nodo del 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 conectar estos terminales de salida.

Configuración de transacciones coordinadas

Cuando se define un nodo MQReply, la opción seleccionada para la propiedad Modalidad de transacción define si el mensaje se graba bajo el 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 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 MQReply, 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 (el descriptor de mensajes de WebSphere MQ).
  • 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; el nodo MQReply especifica la opción MQPER_PERSISTENCE_AS_Q_DEF en MQMD.

Terminales y propiedades

Los terminales del nodo MQReply 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 puesto satisfactoriamente en la cola de salida y se requiere proceso adicional en el flujo de mensajes.

Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria; 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 MQReply están descritas en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo. 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 Avanzadas del nodo MQReply están descritas en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Segmentación permitida No No seleccionado Si selecciona este recuadro, WebSphere MQ divide el mensaje en segmentos en el gestor de colas.
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.
Modalidad de transacción No Automática Esta propiedad controla si el mensaje se transfiere transaccionalmente. Los valores válidos son Automático, y No.

Las propiedades de validación del nodo MQReply 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 Ninguna, 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.  

El nodo MQReply también tiene las siguientes propiedades a las que no se puede acceder ni se pueden modificar a través de la interfaz del WebSphere Message Broker Toolkit. Sin embargo, estos valores los utiliza el intermediario cuando el mensaje se procesa en el flujo de mensajes.

Propiedad Descripción
Nombre del gestor de colas El nombre del gestor de colas de WebSphere MQ para el que se define la cola de salida, especificada en Nombre de cola. Este nombre se recupera del campo ReplyTo de la cabecera de MQMD del mensaje de entrada.
Nombre de cola El nombre de la cola de WebSphere MQ en la que se coloca el mensaje de salida. Este nombre se recupera del campo ReplyTo de la cabecera de MQMD del mensaje de entrada.
Destino Esta propiedad tiene siempre el valor respuesta.
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:19


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