Configure an agent to perform file-to-message transfers

By default agents cannot perform file-to-message or message-to-file transfers. To enable this function you must set the agent property enableQueueInputOutput to true. To enable writing to IBM MQ clustered queues, you must also set the agent property enableClusterQueueInputOutput to true.


If you attempt to perform a file-to-message transfer to a destination 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 write to a queue was rejected by the destination agent. The 
agent must have enableQueueInputOutput=true set in the agent.properties file to 
support transferring to a queue.
To enable the agent to write to and read from queues perform the following steps:


Procedure

  1. Stop the destination 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/destination_agent_name.
  3. Optional: Edit the agent.properties file to include the line enableClusterQueueInputOutput=true. The agent.properties file is located in the directory MQ_DATA_PATH/mqft/config/coordination_queue_manager/agents/destination_agent_name.
  4. Start the destination agent using the fteStartAgent command.