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 we must set the agent property enableQueueInputOutput to true. To enable writing to IBM MQ clustered queues, we 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
- Stop the destination agent using the fteStopAgent command.
- 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.
- 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.
- Start the destination agent using the fteStartAgent command.
Parent topic: Transfer data from files to messages
Related concepts
Related tasks
- Example: Transferring a single file to a single message
- Example: Splitting a single file into multiple messages by length
- Example: Splitting a text file with a regular expression delimiter and including the delimiter in the messages
- Example: Splitting a text file into multiple messages using a regular expression delimiter
- Example: Setting IBM MQ message properties on a file-to-message transfer
- Example: Setting user-defined properties on a file-to-message transfer
Related reference
Related information