Nodo MQReply

Este tema contiene las secciones siguientes:

Finalidad

Utilice el nodo MQReply para enviar una respuesta al emisor del mensaje de entrada. MQReply es una forma especializada del nodo MQOutput que coloca el mensaje de salida en la cola de WebSphere MQ identificada por el campo ReplyToQ 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 respeta las opciones establecidas en el campo Informe del MQMD. Por omisión (si no se establece 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.

En la publicación WebSphere MQ Application Programming Reference puede encontrar más información sobre el campo Informe.

El nodo MQReply se representa 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 puede utilizar este nodo:

Es posible que encuentre apropiado utilizar este nodo al recibir 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

Una vez ha puesto una instancia del nodo MQReply en un flujo de mensajes, puede configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Aparecen las propiedades básicas del nodo.

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

Configure el nodo MQReply de la manera siguiente:

  1. Seleccione el recuadro 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.

    En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.

  2. Seleccione la Modalidad de persistencia que desea para el mensaje de salida.
    • Si selecciona Automática (el valor por omisión), 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 por omisión), 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.
  4. Seleccione Validación en el navegador del diálogo de propiedades si desea que el analizador MRM valide el cuerpo de los mensajes contra el diccionario generado del conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

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

  5. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción corta, una descripción larga, o ambas.
  6. Pulse Aplicar para efectuar los cambios en el nodo MQReply sin cerrar el diálogo de propiedades. Pulse Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse Cancelar para cerrar el diálogo y descartar todos los cambios que ha efectuado en las propiedades.

El mensaje de respuesta se coloca (utilizando MQPUT) en la cola definida en el MQMD del mensaje de entrada, en ReplyToQ. 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 si desea procesar adicionalmente el mensaje, procesar errores o enviar el mensaje a un destino adicional.

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

  • 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)

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

Si no conecta uno 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 se define un nodo MQReply, la opción seleccionada para la propiedad Modalidad de transacción indica si el mensaje se graba bajo punto de sincronización o no:

  • Si tiene el valor , el mensaje se graba bajo punto de sincronización (es decir, dentro de una unidad de trabajo de WebSphere MQ).
  • Si el valor es Automática (el valor por omisión), el mensaje se grabará bajo punto de sincronización si el mensaje de entrada está marcado como persistente.
  • Si es No, el mensaje no se grabará bajo punto de sincronización.

Otra propiedad del nodo MQReply, Modalidad de persistencia, indica si el mensaje de salida se marca como persistente cuando se transfiere a la cola de salida:

  • Si el valor es , el mensaje se marca como persistente.
  • Si es Automática (el valor por omisión), la persistencia del mensaje se determina por las propiedades del mensaje de entrada, según lo definido en MQMD (el descriptor de mensajes de WebSphere MQ).
  • Si el valor es No, el mensaje no se marca como persistente.
  • Si es Según lo definido para la cola, la persistencia del mensaje será la definida en la cola de WebSphere MQ por el nodo MQReply especificando la opción MQPER_PERSISTENCE_AS_Q_DEF en MQMD.

Terminales y propiedades

Los terminales del nodo MQReply se describen 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 del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si tiene que entrar un valor cuando no hay definido ningún valor por omisión), 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 avanzadas del nodo MQReply se describen en la siguiente tabla.

Propiedad O C Valor por omisión Descripción
Segmentación permitida No No seleccionado Si resulta adecuado, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. Si selecciona el recuadro, se realizará esta acción.
Modalidad de persistencia No Automática Define si el mensaje se transfiere de forma persistente. Los valores válidos son Automática, , No y Según lo definido para la cola.
Modalidad de transacción No Automática Define si el mensaje se transfiere transaccionalmente. Los valores válidos son Automática, y No.

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

Consulte el apartado Propiedades de validación para mensajes del dominio MRM para obtener una descripción completa de estas propiedades.

Propiedad O C Valor por omisión Descripción
Validar Heredar Determina si se realiza la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar.
Acción para anomalía No Excepción Determina 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. La acción por omisión, indicada por el recuadro de selección marcado, es que se incluyan 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.

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

Propiedad O 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 el propósito del nodo en el flujo de mensajes.

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, identificado 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, 2006 Última actualización: 22/08/2006
ac04580_