Failure of a file-to-message transfer
If a file-to- message transfer fails after the agent has started writing file data to the destination queue, the agent writes a message to the queue to indicate to an application consuming the messages that a failure has occurred.
The message written to the destination queue if a failure occurs:- Is blank
- Has the same IBM MQ group ID as the previous message written to the destination queue by the agent
- Has the IBM MQ LAST_MSG_IN_GROUP flag set
- Contains additional IBM MQ message properties, if message properties are enabled. For more information, see the topic MQ message properties set by MFT on messages written to destination queues.
Example
A transfer is requested by running the following command:
fteCreateTransfer -sa AGENT_JUPITER -da AGENT_SATURN -dq RECEIVING_QUEUE
-qmp true -qs 1K /tmp/source1.txt
The file source1.txt is 48 KB. The transfer splits
this file into 1 KB messages and writes these messages to the destination
queue RECEIVING_QUEUE.
While the transfer is in progress, after the agent has written 16 messages to RECEIVING_QUEUE, a failure occurs at the source agent.
The agent writes a blank message to RECEIVING_QUEUE. In addition to the standard set of message properties, the blank message has the following message properties set:
usr.WMQFTEResultCode = 40 usr.WMQFTESupplement = BFGTR0036I: The transfer failed to complete successfully.Parent topic: Transfer data from files to messages
Related concepts
Related tasks
Related information
- The MFT agent.properties file
- MQ message properties set by MFT on messages written to destination queues