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:

Type of protocol bridge agent
Host name or IP address of the protocol bridge server

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>

MFT agent transfer states
A Managed File Transfer Agent that is started publishes its details to the SYSTEM.FTE topic on its coordination queue manager. These details include the states of each of the current transfers that involved that agent.

Parent topic: XML message formats used by MFT

MFT agent status message format

Related reference