+

Search Tips | Advanced Search

Transferring data from messages to files

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

For information about file-to-message transfers, see Transferring data from files to messages.

The source agent for a message-to-file transfer cannot be a protocol bridge agent or a Connect:Direct® bridge agent.

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

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

From Version 9.0.1, in a message to file transfer, the source agent browses the messages from the source queue, unlike the destructive GET, in IBM MQ versions before Version 9.0.1. The messages are removed from the source queue after all messages (in a group if message grouping is used) have been browsed and data written to the destination file. This allows messages to remain in the source queue if a transfer fails or is canceled. Due to this change, authority to BROWSE must also be provided along with GET authority to run message to file transfers.

From Version 9.0.0, Fix Pack 2, Managed File Transfer is updated to restore the comparison check, previously removed by APAR IT18213, 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.