13.5 AgentSelfMon

Use this Knowledge Script to monitor the health of the scripting engine in the AppManager agent on a Windows computer. In some cases, the scripting engine does not run jobs properly but the AppManager agent may respond to remote procedure calls from AppManager diagnostic utilities. In this case, restarting the AppManager agent and the scripting engine resolves the problem. This script is not applicable on UNIX computers.

This script monitors the health of the scripting engine on the agent by running a job that updates a timestamp value in the Windows registry. If the age of the timestamp value exceeds the threshold you specify, the Client Communication Manager service (netiqccm.exe) automatically restarts the AppManager agent service (netiqmc.exe).

During the first monitoring interval, the Client Communication Manager service (netiqccm.exe) writes the current timestamp value to the Windows registry; subsequent job iterations compare and then update the timestamp value.

The timestamp and threshold values are stored in the registry under HKEY_LOCAL_MACHINE\SOFTWARE\NetIQ\AppManager\4.0 as follows:

Registry Entry	Registry Location
Timestamp value that is written each time the job runs	NetIQmc\Admin\LastMCCheck
Threshold, in seconds, for the maximum age of timestamp value	NetIQccm\Admin\MCFreezeThreshold

13.5.1 Resource Objects

Windows 2003 Server or later

13.5.2 Default Schedule

The default interval for this script is Every 5 minutes.

The interval you select must be less than or equal to the value you specify in the Threshold - Maximum age of timestamp value parameter.

13.5.3 Setting Parameter Values

Set the following parameters as needed:

Parameter	How to Set It
Threshold - Maximum age of timestamp value	Specify a threshold, in seconds, for the maximum age of the timestamp value. If the elapsed time exceeds the threshold, the Client Communication Manager service (netiqccm.exe) automatically restarts the managed client (netiqmc.exe). If you specify 0, the current value of the MCFreezeThreshold registry key is used. This feature allows you to configure the threshold value a single time. If a value of 0 is specified, the job will not run if the value of MCFreezeThreshold is less than the job's scheduled interval. The default value is 0. NOTE:If you specify a threshold other than 0, the threshold must be greater than or equal to the scheduled job interval. If the threshold is less than the interval, the job does not run and an event (severity level 40) is raised.

Parameter

How to Set It

Threshold - Maximum age of timestamp value

Specify a threshold, in seconds, for the maximum age of the timestamp value. If the elapsed time exceeds the threshold, the Client Communication Manager service (netiqccm.exe) automatically restarts the managed client (netiqmc.exe).

If you specify 0, the current value of the MCFreezeThreshold registry key is used. This feature allows you to configure the threshold value a single time. If a value of 0 is specified, the job will not run if the value of MCFreezeThreshold is less than the job's scheduled interval. The default value is 0.

NOTE:If you specify a threshold other than 0, the threshold must be greater than or equal to the scheduled job interval. If the threshold is less than the interval, the job does not run and an event (severity level 40) is raised.