MFT agent status message format

When a Managed File Transfer Agent is created or started, the agent publishes its details to the SYSTEM.FTE topic on its coordination queue manager (on the SYSTEM.FTE/Agents/agent name topic).

The following information is included:

  • Agent name
  • Platform the agent is running on
  • Agent description (if provided)
  • Agent's queue manager
  • Time zone that the agent is running in
  • Agent version
  • Agent transfer limits
  • State of each of the agent's current transfers. These states are listed in Agent transfer states
  • Type of agent

If the agent is a protocol bridge agent the following information is also included:

The agent status is republished whenever the agent transfer states change, but by default no more than every 30 seconds. We can change this default setting using the agentStatusPublishRateLimit agent property, which is described in: Advanced agent properties.

The following example output shows the keys used for each data element in the agent status:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
    <entry key="agentOsName">Windows 7</entry>
    <entry key="agentDescription"/>
    <entry key="queueManager">QM1</entry>
    <entry key="agentTimeZone">Europe/London</entry>
    <entry key="agentVersion">1.00</entry>
    <entry key="agentName">FTEAGENT</entry>
    <entry key="maxDestinationTransfers">25</entry>
    <entry key="maxSourceTransfers">25</entry>
    <entry key="maxQueuedTransfers">100</entry>
    <entry key="DestinationTransferStates">414d51204d554e474f20202020202020d857374a60a72622=RunningTransfer
                                           414d51204d554e474f20202020202020d857374a69a72622=RunningTransfer
                                           414d51204d554e474f20202020202020d857374a75a72622=RunningTransfer
    </entry>
    <entry key="SourceTransferStates">414d51204d554e474f20202020202020d857374a93a72622=NegotiatingTransfer
                                      414d51204d554e474f20202020202020d857374a78a72622=RunningTransfer
                                      414d51204d554e474f20202020202020d857374aaba72622=NewSenderTransfer
                                      414d51204d554e474f20202020202020d857374a63a72622=RunningTransfer
    </entry>
</properties>
The following example output shows the keys used for each data element in the agent status of a protocol bridge agent:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
    <entry key="agentOsName">Windows 7</entry>
    <entry key="agentDescription"/>
    <entry key="queueManager">QM1</entry>
    <entry key="agentTimeZone">Europe/London</entry>
    <entry key="agentVersion">1.00</entry>
    <entry key="agentName">BRIDGE</entry>
    <entry key="protocolBridgeType">ftp</entry>
    <entry key="protocolBridgeServerHost">ftpserver.example.org</entry>
    <entry key="maxDestinationTransfers">25</entry>
    <entry key="maxSourceTransfers">25</entry>
    <entry key="maxQueuedTransfers">100</entry>
    <entry key="DestinationTransferStates">414d51204d554e474f20202020202020d857374a60a72622=RunningTransfer
    </entry>
    <entry key="SourceTransferStates">414d51204d554e474f20202020202020d857374a93a72622=NegotiatingTransfer
    </entry>
</properties>

Parent topic: XML message formats used by MFT


Related reference