Configure monitor retry behavior for message-to-file transfers
If a message-to-file transfer that is triggered by a resource monitor fails and leaves the message group that triggered the monitor on the queue, that transfer is resubmitted at subsequent poll intervals. The number of times that the transfer is resubmitted is limited by the monitorGroupRetryLimit property of the monitoring agent.
About this task
Each time a new message-to-file transfer is triggered a new transfer ID is generated for the transfer task.
If the agent is restarted the monitor triggers a transfer again even if the number of times the transfer has been triggered has exceeded the value of monitorGroupRetryLimit in the agent.properties file. The value of the monitorGroupRetryLimit property is the maximum number of times that a monitor triggers a message-to-file transfer again if the message group still exists on the queue. The default value of this property is 10. The value of this property can be set to any positive integer value or -1. If the value -1 is specified for this property, the monitor triggers the transfer again an unlimited number of times, until the trigger condition is not satisfied.
If a transfer attempt causes the number of times that the transfer has been triggered to exceed the value of monitorGroupRetryLimit, the agent writes an error to its event log.
A single message is treated as if it was a single group, and the transfer is triggered again at each poll interval while the message remains on the queue and while the number of times the transfer has been triggered is less than the value of monitorGroupRetryLimit.
To set the monitorGroupRetryLimit property on the monitoring agent, perform the following steps:
Procedure
- Stop the monitoring agent, using the fteStopAgent command.
-
Edit the agent.properties file for the monitoring agent to include the following line:
monitorGroupRetryLimit=number_of_retries
The agent.properties file is located in the directory MQ_DATA_PATH/mqft/config/coordination_qmgr_name/agents/monitoring_agent_name. - Start the monitoring agent, using the fteStartAgent command.
Parent topic: Monitor MFT resources
Related tasks