FlushAgentEvents – Flush Local Agent Queues


Article ID: 179877


Updated On:


Management Platform (Formerly known as Notification Server)


When the Notification Server queues have reached the maximum number of NSEs and the Altiris Agent is directed to back off, the agent will queue its NSE to send at a later time. Over a period of time it is possible that many agents will have queued NSEs that could overwhelm the Notification Server. It may be useful to disregard all incoming NSEs and also to direct the Altiris Agents to flush their local queues.


The registry key FlushAgentEvents (Reg_Dword located under HKEY_LOCAL_MACHINE > SOFTWARE > Altiris > eXpress > Notification Server) controls the ability to flush the local queue for the Altiris Agent. When set to 1, the Notification Server's Event Router will send the Altiris Agent an error response that will activate "flush local queues" on the Altiris Agent side. By default, this value is 0.

Note: This registry setting exits only on the Notification Server.

If the FlushAgentEvents registry key does not exist on your Notification Server, you can create it. In REGEDIT, click My Computer > HKEY_LOCAL_MACHINE  >  SOFTWARE > Altiris > eXpress. Right-click Notification Server, click New, click DWORD Value, type FlushAgentEvents and press Enter. Change the value to 1 to stop the Altiris Agents from reporting in. Change it back to 0 to have the Altiris Agents report in. 


REM Value of 0 Allows Agents to report it.
reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Altiris\eXpress\Notification Server" /v "FlushAgentEvents" /t REG_DWORD /d 0 /f 

Additional Information

This Reg Key could be added to the SMP using the methods shown in the Altiris Diagnostic Tasks: KB 181029