MFT agent status values
The fteListAgents and fteShowAgentDetails commands produce agent status information. There are several possible values for this status.
- ACTIVE
- The agent is running and is sending or receiving files. The agent is publishing its status at regular intervals. The last update was received within the expected time period.
- READY
- The agent is running, but is not sending or receiving files. The agent is publishing its status at regular intervals. The last update was received within the expected time period.
- STARTING
- The agent is starting, but is not yet ready to perform transfers.
- UNREACHABLE
- Agent status updates were not received at the expected time intervals. The agent might have stopped running due to an error, have been shut down abruptly, or might be running but is experiencing communication problems. For more information, see What to do if the fteListAgents command shows an agent status of UNREACHABLE.
- STOPPED
- The agent has been stopped. It was shut down in a controlled manner.
- ENDED UNEXPECTEDLY
- The agent has ended unexpectedly. The agent will be automatically restarted, unless there have been more than maxRestartCount restarts within the maxRestartInterval time period and the maxRestartDelay value is less than or equal to 0. For more information about these properties, see The agent.properties file.
- NO_INFORMATION
- The agent version might be WebSphere MQ File Transfer Edition Version 7.0.2 or earlier. The agent is not publishing updates in a form that this command can process.
- UNKNOWN
- The status of the agent cannot be determined. It might have published a status which is not
recognized by this tool. If we have mixed product versions on your network, upgrading the
installation version of this tool might fix this problem.
From Version 9.1.0, when you run commands or look at the list of agents connecting to a coordination manager and their individual properties, we can see a new Status Age value for the agent that shows the age of their last reported status. For more information, see What to do if the fteListAgents command shows an agent status as UNKNOWN.
- PROBLEM
- The agent command handler might not be working. The agent is publishing status messages, but these status messages are out of date.
Parent topic: Managed File Transfer administration reference
Related reference
- MFT agent transfer states
- fteListAgents: list the MFT agents for a coordination queue manager
- fteShowAgentDetails: display MFT agent details
Related information
- What to do if you think that your file transfer is stuck
- What to do if the fteListAgents command shows an agent status as UNKNOWN
- What to do if the fteListAgents command shows an agent status of UNREACHABLE