WebSphere MQ message properties read from messages on source queues
The agent reading messages from a source queue in a message to file transfer reads the WebSphere® MQ message properties from the message. The value of these properties can be used to determine the behavior of a transfer.
Headers used to cancel message to file transfers
Set the following WebSphere MQ message properties on the last message in a group to cancel the message to file transfer of that group:- usr.UserReturnCode
- Required. The return code of the transfer. Set this header as a non-zero value to indicate that the transfer is to be cancelled.
- usr.UserSupplement
- Optional. Text describing why the transfer was cancelled.
Headers used by variable substitution
The value of any WebSphere MQ message property in the first message to be read from the monitored queue can be substituted into the task XML definition. User-defined message properties are prefixed with usr., but do not include this prefix in the variable name. Variable names must be preceded by a dollar sign ($) character and enclosed in braces ({}). For example, ${destFileName} is replaced with the value of the usr.destFileName message property of the first message to be read from the source queue.For example, the user or program putting messages to a monitored queue can set WebSphere MQ message properties on the first message in a group specifying which agent is to be used as the destination of the file transfer and what file name to transfer the data to.
For more information, see Monitoring a queue and using variable substitution.