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® WebSphere® MQ group ID as the previous message written to the destination queue by the agent
- has the IBM WebSphere MQ LAST_MSG_IN_GROUP flag set
- contains additional IBM WebSphere 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.