Ensuring Each Agent Instance has a Unique ID

In order for the TIBCO Hawk system to function correctly, every concurrently running agent instance must have a unique agent ID. The console will attempt to detect violations of this condition and produce a warning. However, this may not be detectable in all circumstances and so the system administrator must insure that every agent has a unique agent ID.

If a console client is interested in tracking agent status across agent instances or console agent instances then it may do so using the console agent ID, that is, the AgentID class. If a agent is restarted several times (without changing its ID attributes) then this will result in the creation of several distinct instances of AgentInstance in the console. These different instances, however, will all have equal AgentID values to reflect the fact that they all relate to the same logical agent. Note that these multiple instances of AgentInstance will never be referenced simultaneously by the console. This is because the console will never hold two AgentInstance objects with equal AgentID attributes at any one time.