Transferring data from messages to files

The message-to-file feature of IBM® MQ Managed File Transfer enables you to transfer data from one or more messages on an IBM MQ queue to a file, a data set, or a user file space. If you have an application that creates or processes IBM MQ messages, you can use the message-to-file capability of IBM MQ Managed File Transfer to transfer these messages to a file on any system in your IBM MQ Managed File Transfer network.

For information about file-to-message transfers, see Transfer data from files to messages.
Attention: The source agent for a message-to-file transfer cannot be a protocol bridge agent or a Connect:Direct® bridge agent.

You can transfer IBM MQ message data to a file. The following types of message-to-file transfer are supported:

  • From a single message to a single file
  • From multiple messages to a single file
  • From multiple messages with the same IBM MQ group ID to a single file.
  • From multiple messages to a single file, including a text or binary delimiter between the data from each message written to the file.

If you are transferring files from large messages, or many small messages, you might need to change some IBM MQ or IBM MQ Managed File Transfer properties. For more information about, see Guidance for setting IBM MQ attributes and IBM MQ Managed File Transfer properties associated with message size.

[V8.0.0.8 Nov 2017]From Version 8.0.0, Fix Pack 8, Managed File Transfer is updated to restore the comparison check, previously removed by APAR IT18213 at Version 8.0.0, Fix Pack 5, of the transfer identifier and the value of the groupId attribute within the transfer request XML payload. If these two identifiers are equivalent, the source agent uses the identifier as a message identifier match option (as opposed to a group identifier match option) for the first MQGET attempt that is made on the input queue for the message-to-file transfer.