Configure an agent to perform message-to-file transfers

By default agents cannot perform message to file, or file to message, transfers. To enable this function we must set the agent property enableQueueInputOutput to true.

About this task

If you attempt to perform a message to file transfer from a source agent that does not have the enableQueueInputOutput property set to true, the transfer fails. The transfer log message that is published to the coordination queue manager contains the following message:

BFGIO0197E: An attempt to read from a queue was rejected by the source agent. 
The agent must have enableQueueInputOutput=true set in the agent.properties file 
to support transferring from a queue.

To enable the agent to write to and read from queues perform the following steps:

Procedure

1. Stop the source agent using the fteStopAgent command.
2. Edit the agent.properties file to include the line enableQueueInputOutput=true. The agent.properties file is located in the directory MQ_DATA_PATH/mqft/config/coordination_queue_manager/agents/source_agent_name.
3. Start the source agent using the fteStartAgent command.

Parent topic: Transfer data from messages to files

Related concepts

• Transfer data from messages to files

Related tasks

• Example: Transferring from a queue to a single file
• Example: Transferring a group of messages from a queue to a single file
• Example: Inserting a text delimiter before the data from each message
• Example: Inserting a binary delimiter after the data from each message
• Monitor a queue and using variable substitution
• Example: Failing a message-to-file transfer using IBM MQ message properties

Related information

• The MFT agent.properties file