Setting a timeout for recovery of stalled transfers

You can set a transfer recovery timeout for stalled file transfers that applies to all the transfers for a source agent. You can also set a transfer recovery timeout for an individual transfer. If you set a specific amount of time, in seconds, during which a source agent keeps trying to recover a stalled file transfer and the transfer is not successful when the agent reaches the timeout, the transfer fails.

About this task

From IBM® MQ 9.1, you can set a transfer recovery timeout that applies to all the transfers for a source agent by adding a transfer recovery timeout parameter to the agent's agent.properties file. You can also set a transfer recovery timeout for an individual transfer from the command line, or with IBM MQ Explorer, or by using Apache Ant tasks. If there is a transfer recovery timeout value set in the agent.properties file, setting the transfer recovery timeout for an individual transfer overrides the value in the agent.properties file.

There are three options for transfer recovery timeout:
  • The agent continues to try to recover the stalled transfer until it completes successfully. This is the same as the default behavior of the agent if the transfer recovery timeout is not set.
  • The agent marks the transfer as failed immediately upon entering recovery.
  • The agent keeps retrying the stalled transfer for a specified amount of time before the transfer is marked as failed.

Setting the file transfer recovery timeout is optional. If you do not set it, transfers follow the default behavior. This is the same as the default behavior of a Managed File Transfer source agent before IBM MQ 9.1, where the agent keeps trying to recover a stalled transfer until it is successful.