Agent Polling

UEC periodically polls each agent in order to retrieve its status information. The polling request is made on the listening port for the agent's Universal Broker (default 7887).

When UEC polls a agent, it determines whether or not a change in status of the agent has occurred since the last poll. If the agent status has changed, UEC sends this information to the I-Activity Monitor to notify users.

The values specified for the following configuration options affect how polling occurs:

• BKR_QUERIES_PER_THREAD
• BKR_QUERY_THREADS
• BKR_QUERY_TIMEOUT
• POLLING_INTERVAL

These configuration values can be modified, allowing UEC to fit your monitoring needs.

Optimally, UEC attempts to poll every agent in the time interval specified by POLLING_INTERVAL. However, you can define an independent polling interval for a specific agent via the I-Administrator application. For example, if I-Administrator defines a polling interval of 10 seconds for agent 123, UEC will poll agent 123 every 10 seconds and all other agents at the interval specified by POLLING_INTERVAL.

If, upon a poll, UEC is unable to complete communication with a agent in the number of seconds specified by BKR_QUERY_TIMEOUT, an error is reported which indicates that the agent has timed out.

Use the following equation to calculate the number of agents that UEC can poll at any given time:

Number of agents = BKR_QUERIES_PER_THREAD x BKR_QUERY_THREADS

SAP System Polling

UEC periodically polls each SAP system in order to retrieve its status information. The polling request is performed via an RFC connection to the SAP system. When UEC polls a SAP system, it determines if a change in status of the system has occurred since the last poll. If the SAP system status has changed, UEC sends this information to the I-Activity Monitor to notify users.

In order to prevent the accidental locking of SAP accounts used by UEC, an SAP system will be dropped from the polling cycle if a logon authentication error occurs. This will prevent UEC from exceeding the number of failed logon attempts allowed by the SAP system.

When an SAP system is disabled due to a logon authentication error, a UNV4363T message is written to the UEC log and an alert is sent to I-Administrator clients monitoring for alerts.

SAP system definitions that have been disabled due to a logon authentication error can be re-enabled by modifying the User ID, Password, or Client field via the I-Administrator client. When an SAP system is re-enabled, a UNV1059T message is written to the UEC log and the associated alert is removed from I-Activity Monitor clients.