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 Failure properties.


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.