Este tema contiene las secciones siguientes:
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:
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.
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:
En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.
Si desea ver más información detallada, consulte los apartados Validar mensajes y Propiedades de validación para mensajes del dominio MRM.
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.
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:
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.
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:
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:
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 | Sí | 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 | Sí | No | Automática | Define si el mensaje se transfiere de forma persistente. Los valores válidos son Automática, Sí, No y Según lo definido para la cola. |
Modalidad de transacción | Sí | No | Automática | Define si el mensaje se transfiere transaccionalmente. Los valores válidos son Automática, Sí 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 | Sí | Sí | 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 | Sí | 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 | Sí | 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 | Sí | 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. |