Utilice el nodo MQReply para enviar una respuesta al emisor del mensaje de entrada.
Este tema contiene las secciones siguientes:
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:
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.
WrittenDestination = (
MQ = (
DestinationData = (
queueName = 'OUT'
queueManagerName = 'MYQUEUEMANAGER'
replyIdentifier = X'4d...2e'
msgId = X'3c...2c'
correlId = X'2a...00'
GroupId = X'3a...00'
)
)
)
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:
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.
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.
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.
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 | Sí | No | No seleccionado | Si selecciona este recuadro, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. |
Modalidad de persistencia | Sí | No | Automática | Esta propiedad controla si el mensaje se transfiere persistentemente. 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 | Esta propiedad controla si el mensaje se transfiere transaccionalmente. Los valores válidos son Automático, Sí 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 | Sí | 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. |
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. |