Guidance for specifying a wait time on a message-to-file transfer

When specifying a message-to-file transfer you can optionally specify a wait time on the transfer using the -sqwt parameter. The value of -sqwt is the amount of time that the source agent waits either for a message to appear on the source queue if the source queue is empty or becomes empty, or for a complete group to appear on the source queue if the -sqgi attribute is specified.

This topic describes the parameters used in the fteCreateTransfer command for specifying a wait time. You can also specify the wait time using the srcqueuetimeout value of the fte:filespec parameter.

If the value of the -sqwt parameter is greater than or equal to the amount of time the destination agent waits for the transfer to be completed by the source agent, the transfer does not complete. The amount of time the destination agent waits for the transfer to complete is given by the following calculation: 

transferAckTimeout * transferAckTimeoutRetries
The properties transferAckTimeout and transferAckTimeoutRetries are set in the destination agent agent.properties file. For more information about these agent properties, see The agent.properties file.
To prevent transfers from failing to complete, you must perform one of the following steps:
  • Reduce the value of the -sqwt parameter so that it is less than the value of the destination agent transferAckTimeout property.
    Note: The default value of the transferAckTimeout property is 60,000 milliseconds. The value of the -sqwt parameter is given in seconds, set the value to 59 or less.
  • Increase the value of the destination agent transferAckTimeout property so that it is greater than the value of the -sqwt parameter.
    Note: The value of the transferAckTimeout property is given in milliseconds. The value of the -sqwt parameter is given in seconds.