Set a timeout for recovery of stalled transfers

We can set a transfer recovery timeout for stalled file transfers that applies to all the transfers for a source agent. We 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.


From Version 9.1, we 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. We 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.

Set the file transfer recovery timeout is optional. If we 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 Version 9.1, where the agent keeps trying to recover a stalled transfer until it is successful.

  • Transfer recovery timeout concepts
    We can set the amount of time, in seconds, during which a source agent keeps trying to recover a stalled file transfer. If the transfer is not successful when the agent reaches the timeout for the retry interval, the transfer fails.
  • Set the transfer recovery timeout for all transfers for one source agent
    We can set a transfer recovery timeout that applies to all the transfers for a source agent by adding the transferRecoveryTimeout parameter to the agent.properties file.
  • Set the transfer recovery timeout for individual transfers
    We can set the 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 set in the agent.properties file.

Parent topic: Administer Managed File Transfer


Related concepts