What to do if the fteListAgents command shows an agent status of UNREACHABLE

Your agent is running and responds successfully to the ftePingAgent command, and files are being transferred normally, but the agent is listed as UNREACHABLE by the fteListAgents command.

Why this problem occurs

Periodically, the agent publishes its status to the coordination queue manager. The frequency that the agent publishes its status is controlled by the following two agent properties:

agentStatusPublishRateLimit: The maximum rate in seconds that the agent republishes its status because of a change in file transfer status.
agentStatusPublishRateMin: The minimum rate in seconds that the agent publishes its status. This value must be greater than or equal to the value of the agentStatusPublishRateLimit property.

Using the default settings, clocks that are out-of-sync between the agent system and the coordination queue manager system cause this issue, if the difference between the times is greater than 303 seconds. Agent status messages are considered stale if the message was sent more than the value of agentStatusPublishRateMin + the value of agentStatusJitterTolerance seconds ago. An agent with a stale status message is reported as UNREACHABLE by the fteListAgents command.

By default, the value of the agentStatusJitterTolerance property is 3000 milliseconds and the value of the agentStatusPublishRateMin property is 300 seconds. If the time difference between the machines plus the effective publish rate is greater than the sum of agentStatusPublishRateMin + agentStatusJitterTolerance, the time difference causes the UNREACHABLE agent status.

Resolving the problem

You can resolve this problem in either of the following ways:

Correct the time setting differences between the agent host machine and the machine hosting the coordination queue manager, so that they are in sync.
Increase the value of the agentStatusJitterTolerance property to account for the time difference. When you run the fteListAgents command, the value of agentStatusJitterTolerance is determined by the coordination.properties configuration file in the MQMFTconfig directory. Therefore, set the property in the coordination.properties file of the MQMFT installation that the fteListAgents command is being run on.