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, defina 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 MsgId y un nuevo CorrelId en el 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 del flujo de mensajes establezca las opciones de informe 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.

Inicio del cambioHay más información sobre el campo Informe que está disponible en la secció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.Fin del cambio

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

Utilización de este nodo en un flujo de mensajes

Consulte el ejemplo siguiente para ver cómo se debe utilizar este nodo: Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.

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.

Configuración del nodo MQReply

Cuando haya colocado una instancia del nodo MQReply 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 en el diálogo Propiedades, 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 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 redenominar 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.

      Inicio del cambioPuede ver más información sobre las opciones relacionadas con esta propiedad en la publicación Application Programming Reference del 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 MQFin del cambio

    2. Seleccione la Modalidad de persistencia que desea 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. Seleccione la Modalidad de transacción que desea 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 si desea que el analizador MRM valide el cuerpo de los mensajes con el diccionario que se genera a partir del conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

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

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 de este flujo de mensajes para procesar adicionalmente el mensaje, procesar errores oenviar el mensaje a un destino adicional.

Si conecta un terminal de salida a otro nodo del flujo de mensajes, se añade información sobre el destino en el que se ha colocado el mensaje al Entorno local que está asociado al mensaje. Los valores siguientes se graban en WrittenDestination dentro de la estructura del árbol Entorno local:
  • 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)

Si no conecta uno de estos terminales de salida, el árbol Entorno local no se modifica.

Si utiliza agregación en los flujos de mensajes, debe utilizar 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 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 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 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 MQReply 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. 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 Avanzadas del nodo MQReply están descritas en la siguiente tabla.

Propiedad O C Valor por omisión 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 por omisión Descripción
Validar No Heredar Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar.
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.
Incluir todas las limitaciones de valor No Seleccionado Esta propiedad no se puede editar. Si selecciona este recuadro de selección, se incluyen las 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.

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 entorno de trabajo. 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 del 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 del MQMD del mensaje de entrada.
Destino Esta propiedad tiene siempre el valor respuesta.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:53:38

ac04580_