Actions and Test Wizard

After you complete the initial configuration screen for your test, the Specify the Actions to take for this Test screen appears. If the test meets the criteria, the specified action for that test is triggered.

Note: You can specify more than one action for each test.

From this screen, you can:

• Add - Add a new action to your test (see Adding an action).
• Remove - Remove an action from your test.
• Properties - Modify the properties for an action

When you click Add on the Specify the Actions to take for this Test screen, the Add Test Action screen appears.

Note: You can specify more than one action for each test.

You can select one of the following actions.

• Email - Sends an email to the specified recipient email addresses (see Sending an email).
• Event Log - Sends a configurable text message to the event log with the specified status (see Writing to the Windows event log).
• Service Status - You can select to stop single, multiple, or all services (see Changing service status).

After you finish adding actions, click Next to proceed to the final screen of the wizard. See Completing the Test Wizard.

When you select the Email action, the Send an E-mail screen appears. This action sends an email to the specified recipient email addresses. Multiple recipient email addresses are allowed.

• From and To - You defined the default From and To email addresses when you added the server to the Server Monitor Administrator. You can override the defaults on this screen, otherwise, do not change the values.

You can enter multiple email addresses in the To field by separating each email address with a semicolon (;), or you can enter a distribution list address. Distribution list aliases are not supported.

• Subject and Message - You can use the following variables in the Subject and Message body:

• %EMAILFROM% - Maps to the default From email address.
• %EMAILTO% - Maps to the default To email address.
• %SERVER% - Maps to the name of the server you are monitoring.
• %CATEGORY% - Maps to the test category (for example: Composers or Connector Manager).
• %TESTDESCRIPTION% - Maps to the test name itself. You define the test name on the final page of the wizard.
• %PROBLEM% - Maps to the list of issues generated during testing.

After you configure the Send an Email screen, click Finish to return to the Specify the Actions to take for This Test screen.

The following messages are generated when you select the Email action and the action is triggered. Any text within < > are the variables, the value of which is generated during execution of the program. Any text within [ ] is conditional text, depending on the test settings.

When you select the Event Log action, the Write to Windows Event Log screen appears. This action sends a configurable text message to the Event Log with the specified status. The three available status options are:

• Information
• Warning
• Error

Note: Server Monitor writes events to the Event Log located on the server that is running the Server Monitor Service.

Enter your configurable text in the Message field.

Note: You must enter a message in the Message field before you can complete the screen.

After you configure the Write to Windows Event Log screen, click Finish to return to the Specify the Actions to take for This Test screen.

When you select the Service Status action, the Change Service Status screen appears. This action stops all or selected services.

Note: If you select the Selected Services option, you must select at least one service before you can finish the screen. In a clustered environment, this action stops the specified services. The HP Cluster Service, however, starts the services again, usually within 45 seconds.

In the Timeout field, select the amount of time (in seconds) for the amount of time it should take for the service to stop before the Server Monitor writes a message to the Event Log. For example, if you are stopping the Address Book service and you have chosen a 60 second timeout, the Server Monitor will write a message in the Event Log if the Address Book service has not stopped at the end of 60 seconds.

After you configure the Change Service Status screen, click Finish to return to the Specify the Actions to take for This Test screen.

Note: Stopping services can cause other applications to experience problems.

After you finish specifying the actions to take for the test, you need to configure the properties for the test on the final screen of the wizard. The Create New Test Criteria screen appears. The available options on this screen are:

• Specify a name for this test - A default name is generate for each test type. You can change the default or accept it.

Note: Click Update if you want to replace a modified test name with the generated default name.

• Enable this test - The icon in the details pane changes so you can easily tell if a test is enabled or disabled.
• Execute this test every x minutes - Set the minimum time for executing this test. The default is 5 minutes.
• Execute the actions for a failed test every x minutes until the condition is corrected - Set the minimum time for executing the actions when a test meets the specified criteria. The default is 15 minutes.

Note: The action is taken the first time the test criteria is met, and every x minutes after that if the criteria continues to be met.

Click Finish to complete the wizard and add the test to the details pane of the Server Monitor Administrator.