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.
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.