Nodo MQReply

Este tema contiene los apartados siguientes:

Finalidad

Utilice el nodo MQReply para enviar una respuesta al emisor del mensaje de entrada. MQReply es un formato especializado del nodo MQOutput que transfiere el mensaje de salida a la cola de WebSphere MQ que se identifica en el campo ColaRespuestas de la cabecera del mensaje de entrada. Si procede, puede definir la cola como una cola compartida o como una cola en clúster WebSphere MQ.

El nodo MQReply acepta las opciones que se han establecido en el campo de informe de MQMD. Por omisión (si no se ha establecido ninguna opción), el nodo MQReply genera un nuevo IDMsj e IDCorrel en el mensaje de respuesta. Si la aplicación receptora espera otros valores en estos campos, debe asegurarse de que la aplicación que transfiere el mensaje a la cola de entrada del flujo de mensajes establece las opciones de informe necesarias, o bien, que establece 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.

En la publicación WebSphere MQ Application Programming Reference se proporciona más información sobre el campo de informe.

El nodo MQReply se representa en el área de trabajo mediante el icono siguiente:

icono del nodo MQReply

Utilización de este nodo en un flujo de mensajes

Consulte el ejemplo siguiente para informarse sobre cómo puede utilizar este nodo:

Es posible que considere adecuado utilizar este nodo cuando recibe un pedido de un cliente. Al procesar el mensaje del pedido, se envía una respuesta al cliente acusando recibo del pedido y proporcionando una fecha de entrega posible.

Configuración del nodo MQReply

Se puede configurar al transferir una instancia del nodo MQReply a un flujo de mensajes. Pulse el botón derecho del ratón en la vista del editor y, a continuación, pulse en Propiedades. Se muestran las propiedades básicas del nodo.

Todas las propiedades obligatorias para las que debe entrar un valor (las que no tienen un valor por omisión definido) se muestran marcadas con un asterisco en el diálogo de propiedades.

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

  1. Seleccione el recuadro de selección Segmentación permitida si desea que WebSphere MQ divida el mensaje en segmentos en el gestor de colas si procede. Para que la segmentación se lleve a cabo, también debe establecer MQMF_SEGMENTATION_ALLOWED en el campo IndicadoresMsjs de MQM.

    En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.

  2. Seleccione la Modalidad de permanencia que desea para el mensaje de salida.
    • Si selecciona Automático (el valor por omisión), la permanencia es la que se ha especificado en el mensaje entrante.
    • Si selecciona , el mensaje se transfiere de forma permanente.
    • Si selecciona No, el mensaje se transfiere de forma no permanente.
    • Si selecciona Según lo definido para la cola, la permanencia del mensaje se establece tal como se ha definido en la cola WebSphere MQ.
  3. Seleccione la Modalidad de transacción que desea para el mensaje de salida.
    • Si selecciona Automática (el valor por omisión), la transaccionalidad del mensaje se deriva del modo que se ha especificado en el nodo MQInput.
    • Si selecciona , el mensaje se transfiere de forma transaccional.
    • Si selecciona No, el mensaje se transfiere de forma no transaccional.
  4. Seleccione Descripción en el navegador del diálogo de propiedades para especificar una descripción corta, una descripción larga, o ambas.
  5. Pulse el botón en Aplicar para realizar los cambios en el nodo MQReply sin cerrar el diálogo de propiedades. Pulse el botón en Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse el botón en Cancelar para cerrar el diálogo y descartar todos los cambios que ha realizado en las propiedades.

El mensaje de respuesta se transfiere (utilizando MQPUT) a la cola denominada en el MQMD del mensaje de entrada como cola de respuestas. Este destino no se puede cambiar. Para disponer de más opciones sobre el destino del mensaje de salida, utilice un nodo de salida alternativo:

  • MQOutput
  • MQeOutput
  • SCADAOutput
  • Un nodo de salida definido por el usuario (plug-in)

Conexión del terminales de salida a otro nodo

Conecte el terminal de anomalías o el terminal de salida de este nodo a otro nodo de este flujo de mensajes si desea que continúe el proceso, se procesen errores o se envíe el mensaje a un destino adicional.

Si conecta uno de estos terminales de salida a otro nodo del flujo de mensajes, el entorno local asociado al mensaje se amplía con la información siguiente para cada destino al que se ha transferido el mensaje:

  • Nombre de cola
  • Nombre del gestor de colas
  • Identificador de respuesta del mensaje (se establece en el mismo valor que el ID del mensaje)
  • ID del mensaje (del MQMD)
  • ID de correlación (del MQMD)

Estos valores se escriben en WrittenDestination dentro de la estructura de árbol del entorno local

Si no conecta ninguno de estos terminales de salida, el árbol del 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 define un nodo MQReply, la opción que selecciona para la propiedad Modalidad de transacción define si el mensaje se escribe bajo punto de sincronismo.

  • Si se establece en , el mensaje se escribe bajo punto de sincronismo (es decir, dentro de una unidad de trabajo de WebSphere MQ).
  • Si se establece en Automática (el valor por omisión), el mensaje se escribe bajo punto de sincronismo si el mensaje de entrada entrante se ha marcado como permanente.
  • Si se establece en No, el mensaje no se escribe bajo punto de sincronismo.

Otra propiedad del nodo MQReply, Modalidad de permanencia, define si el mensaje de salida debe marcarse como permanente cuando se transfiere a la cola de salida:

  • Si se establece en , el mensaje se marca como permanente.
  • Si se establece en Automática (el valor por omisión), la permanencia del mensaje se determina según las propiedades del mensaje entrante, tal como se ha establecido en MQMD (el descriptor de mensaje de WebSphere MQ).
  • Si se establece en No, el mensaje no se marca como permanente.
  • Si se establece Según lo definido para la cola, la permanencia del mensaje se establece tal como lo ha definido el nodo MQReply en la cola WebSphere MQ al especificar la opción MQPER_PERSISTENCE_AS_Q_DEF en MQMD.

Terminales y propiedades

Los terminales del nodo MQReply se describen en la tabla siguiente:

Terminal Descripción
Terminal de entrada Terminal de entrada que acepta un mensaje para que lo procese el nodo.
Terminal de anomalías Terminal de salida al que se direcciona el mensaje si se detecta una anomalía cuando se transfiere el mensaje a la cola de salida.
Terminal de salida Terminal de salida al que se direcciona el mensaje si se transfiere correctamente a la cola de salida, y si se requieren procesos ulteriores en el flujo de mensajes.

En las tablas siguientes se describen las propiedades del nodo; la columna que tiene el encabezamiento M indica si se trata de una propiedad obligatoria (marcada con un asterisco en el diálogo de propiedades si se debe especificar un valor cuando no se ha definido ningún valor por omisión), la columna que tiene el encabezamiento C indica que se trata de una propiedad configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para su difusión).

Las propiedades avanzadas del nodo MQReply se describen en la tabla siguiente:

Propiedad M C Valor por omisión Descripción
Segmentación permitida No Deseleccionado Si procede, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. Si selecciona el recuadro de selección, se realiza esta acción.
Modalidad de permanencia No Automática Si el mensaje se transfiere de forma permanente. Los valores válidos son Automática, , No y Según lo definido para la cola.
Modalidad de transacción No Automática Si el mensaje se transfiere de forma transaccional. Los valores válidos son Automático, y No.

Las propiedades de descripción del nodo MQReply se describen en la tabla siguiente:

Propiedad M 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 la finalidad del nodo en el flujo de mensajes.

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

Propiedad Descripción
Nombre del gestor de colas Nombre del gestor de colas WebSphere MQ para el que se ha definido la cola de salida, identificada en Nombre de cola. Este nombre se recupera del campo Respuesta del MQMD del mensaje de entrada.
Nombre de cola Nombre de la cola WebSphere MQ a la que se transfiere el mensaje de salida. Este nombre se recupera del campo Respuesta del MQMD del mensaje de entrada.
Destino Esta propiedad siempre tiene el valor reply.

Conceptos relacionados
Flujos de mensajes
Árbol LocalEnvironment
Difusión de aplicaciones de flujos de mensajes

Tareas relacionadas
Cómo decidir los nodos que utilizar
Configuración de flujos de mensajes coordinados
Manejo de errores en flujos de mensajes
Utilización de colas de clúster WebSphere MQ para entrada y salida
Utilización de colas compartidas de WebSphere MQ para entrada y salida (z/OS)
Configuración de flujos de agregación

Referencia relacionada
Nodo MQeOutput
Nodo MQInput
Nodo MQOutput
Nodo SCADAOutput

página Web de la biblioteca de WebSphere MQ