Setting an Action for an Alert

Once you have added an alert, you need to set an action to be performed each time AuditMaster finds a match for the alert condition.

You can set one or both of two actions for each alert:

n	Setting an EmailAlert Action

n	Setting a RunProgram Action

Note From a viewer client on the server machine where AuditMaster is running, you can set actions both to send email or run a program on the server; however, from a remote viewer client you are unable to set an action to run a program on the server and can set only email alerts.

‰	To set an action for an alert

1	Select File  Alerts if the Alerts window is not open, and select an alert to configure.

2	Click Edit.

The Action for Alert window appears.

3	Select at least one of the built-in alerts, and click the Select button:

w	EmailAlert The EmailAlert action sends an email to a specified group of addresses when an alert condition is met. To configure the email alert action, proceed to Setting an EmailAlert Action.

w	RunProgram The RunProgram action runs a specified program on the server when an alert condition is met. To configure the program, proceed to Setting a RunProgram Action.

4

Click OK.

Selected actions are now set for the alert and will be performed if the alert condition is met.

Note After creating or changing an alert, close AuditMaster Viewer and restart the AuditMaster event handler so that the alert takes effect. See Restarting the AuditMaster Event Handler.

Setting an EmailAlert Action

‰	To set email groups and addresses for an alert

1	If the Alerts window is not open, select File  Alerts, select the alert to configure, click the Action button, click EmailAlert, and click the Select button.

The EmailAlert action moves to the Selected Actions column.

2	With the EmailAlert item selected, click the Configure button.

The Configure EmailAlert window appears.

3	If an email group to which you want to send alerts exists in the list, simply select it, click the right arrow (>) to move it to Selected Groups. You may also double-click the group name.

When the alert condition is met, addresses in this group will receive email.

4	To set the SMTP server used to send out-going mail, click Set Global SMTP Server.

5	Add the server name for the SMTP server, and click OK.

For example, if your out-going mail server is named smtp-server.companyname.com, then enter smtp-server in this field.

6	To set the global domain used by your company, click Set Global Domain.

7	Add the domain name, such as pervasive.com, and click OK. Continuing with the example from the last step, here you would enter companyname.com.

8	To configure a group, click Configure Groups.

The Configure Groups window appears. For this demonstration, sample values have been filled in.

9	In this window you can manage email groups and addresses, as described in the following table. When you are finished, click OK to return to the Configure EmailAlert window.

 

Email Task	Steps
Add New Group	Click Add New Group, enter a name for the new group, and click OK.
Edit Group Name	Select a group name, click Edit Group Name, enter a new name for this group, and click OK.
Delete Group	Select a group name, click Delete Group, and click Yes to confirm. The group is deleted only for this alert and remains in the system for use in other alerts.
Add New E-mail Address	With a group selected, click Add New E-mail Address, enter the email address, and click OK.
Edit E-mail	With a group selected, select an address from the list of email addresses for that group, then click Edit E-mail, enter a new email address, and click OK.
Remove E-mail Address	With a group selected, select an email address, click Remove E-mail Address, and click Yes to confirm.

The following sample email alert was tripped by an insert in the Demodata database. If AuditMaster monitors a database without a schema, the application record data in the alert does not display the hexadecimal content. If the schema has been imported, then column names are displayed.

Figure 7-5 Structure of an Email Alert

Setting a RunProgram Action

‰	To set a program to run as an alert action

1	If the Alerts window is not open, select File  Alerts, select the alert to configure, click the Action button, click RunProgram, and click the Select button.

The RunProgram action moves to the Selected Actions column.

2	With the RunProgram item selected, click the Configure button.

The Configure Programs window appears.

3	In the Configure Programs window you can select programs to run on the Pervasive PSQL server as alerts as described in the following table.

 

To...	Steps
Select a program to run	1. Click one of the available programs, and click the Select button. 2. The program is moved to the Selected Programs list. When the condition for this alert is met, this program will be executed on the server.
Add a new program to the list of Available Programs	1. Click the Add button. 2. The Select an Executable File window appears, pointing to the C: directory on the server. 3. Select a program, or browse and find another. 4. When you have selected the program, click OK.
Remove a program from the list of Available Programs	1. Select the program name. 2. Click Remove. 3. Click Yes to confirm.
Set parameters for a program in the Selected Programs list Use this option only if you are very familiar with program parameters.	1. Select the program name. 2. Click Set Parameters. 3. Click the buttons to Add, Remove, or Change parameters for the program to be run. 4. Enter any new or changed parameter in the field provided, and click OK.

4	When you are finished selecting and configuring a program to run as an alert, click OK to return to the Action for Alert window.

5	Click Close to exit from the Alerts window.

Editing an Existing Alert

You can edit the name and description of an alert. However, you cannot change the conditions for the alert. To monitor for a different event, delete the old alert and enter a new one.

‰	To change an alert name or description

1	In the Alerts window, select an alert from the list, and click the Edit button.

The Edit Alert window appears.

Figure 7-6 Edit Alert Window

2	Edit the name and description for this alert, and click OK.