Use the MQReply node to send a response to the originator of the input message.
This topic contains the following sections:
The MQReply node is a specialized form of the MQOutput node that puts the output message to the WebSphere® MQ queue that is identified by the ReplyToQ field of the input message header. If appropriate, you can define the queue as a WebSphere MQ clustered queue or shared queue.
The MQReply node uses the options that are set in the Report field in the MQMD. By default (if no options are set), the MQReply node generates a new MsgId field in the reply message, and copies the message ID from the input message to the CorrelId field in the reply message. If the receiving application expects other values in these fields, ensure that the application that puts the message to the message flow input queue sets the required report options, or that you set the appropriate options in the MQMD during message processing in the message flow; for example, use a Compute node to set the Report options in the message.
More information about the Report field is available in the Application Programming Reference section of the WebSphere MQ Version 7 product documentation online.
The MQReply node is contained in the WebSphere MQ drawer of the palette, and is represented in the IBM® Integration Toolkit by the following icon:
You can view information about samples only when you use the product documentation that is integrated with the IBM Integration Toolkit or the online product documentation. You can run samples only when you use the product documentation that is integrated with the IBM Integration Toolkit.
You can use this node when you receive an order from a customer. When the order message is processed, a response is sent to the customer acknowledging receipt of the order and providing a possible date for delivery.
WrittenDestination = (
MQ = (
DestinationData = (
queueName = 'OUT'
queueManagerName = 'MYQUEUEMANAGER'
replyIdentifier = X'4d...2e'
msgId = X'3c...2c'
correlId = X'2a...00'
GroupId = X'3a...00'
)
)
)
When you have put an instance of the MQReply node into a message flow, you can configure it; see Configuring a message flow node. The properties of the node are displayed in the Properties view.
Configure the MQReply node as follows:
More information about the options to which this property maps is available in the Application Programming Reference section of the WebSphere MQ Version 7 product documentation online.
For more details, see Validating messages.
The reply message is put (using MQPUT) to the queue named in the input message MQMD as the ReplyTo queue. You cannot change this destination.
Connect the Out or Failure terminal of this node to another node in the message flow to process the message further, process errors, or send the message to an additional destination.
If you use aggregation in your message flows, you must connect these output terminals.
The MQReply node terminals are described in the following table.
Terminal | Description |
---|---|
In | The input terminal that accepts a message for processing by the node. |
Failure | The output terminal to which the message is routed if a failure is detected when the message is put to the output queue. |
Out | The output terminal to which the message is routed if it has been successfully put to the output queue, and if further processing is required in this message flow. |
The following tables describe the node properties. The column headed M indicates whether the property is mandatory; the column headed C indicates whether the property is configurable (you can change the value when you add the message flow to the BAR file for deployment).
The MQReply node Description properties are described in the following table.
Property | M | C | Default | Description |
---|---|---|---|---|
Node name | No | No | The node type. | The name of the node. |
Short Description | No | No | A brief description of the node. | |
Long Description | No | No | Text that describes the purpose of the node in the message flow. |
The MQReply node Advanced properties are described in the following table.
Property | M | C | Default | Description |
---|---|---|---|---|
Segmentation Allowed | Yes | No | Cleared | If you select this check box, WebSphere MQ breaks the message into segments in the queue manager. |
Persistence Mode | Yes | No | Automatic | This property controls whether the message is put persistently. Valid values are Automatic, Yes, No, and As Defined for Queue. |
Transaction Mode | Yes | No | Automatic | This property controls whether the message is put transactionally. Valid values are Automatic, Yes, and No. |
The Validation properties of the MQReply node are described in the following table.
For a full description of these properties, see Validation properties.
Property | M | C | Default | Description | mqsiapplybaroverride command property |
---|---|---|---|---|---|
Validate | No | Yes | Inherit | This property controls whether validation takes place. Valid values are None, Content and Value, Content, and Inherit. | validateMaster |
Failure Action | No | No | Exception | This property controls what happens if validation fails. You can set this property only if you set Validate to Content or Content and Value. Valid values are User Trace, Local Error Log, Exception, and Exception List. |
The MQReply node also has the following properties that you cannot access or modify through the IBM Integration Toolkit interface. However, these values are used by the broker when the message is processed in the message flow.
Property | Description |
---|---|
Queue Manager Name | The name of the WebSphere MQ queue manager to which the output queue, identified in Queue Name, is defined. This name is retrieved from the ReplyTo field of the MQMD header of the input message. |
Queue Name | The name of the WebSphere MQ queue to which the output message is put. This name is retrieved from the ReplyTo field of the MQMD header of the input message. |
Destination | This property always has the value reply. |
Property | M | C | Default | Description |
---|---|---|---|---|
Events | No | No | None | Events that you have defined for the node are
displayed on this tab. By default, no monitoring events are defined
on any node in a message flow. Use Add, Edit,
and Delete to create, change or delete monitoring
events for the node; see Configuring monitoring event sources using monitoring properties for details. You can enable and disable events that are shown here by selecting or clearing the Enabled check box. |