Ipswitch WhatsUp Gold User Guide - Ipswitch Documentation Server

Ipswitch WhatsUp Gold User Guide
Configuring an action
There are two aspects of fully configuring an action. First, you create the action itself in the
Action Library dialog or through the Action Builder wizard. The setup consists of:
Defining the target of the action (for example, a pager or email address)
Entering the notification variables or program arguments (that specify what
information to report in the action message, or to pass to another program).
Next, you assign the action or action policy to a device or active monitor and to link it to a
state change (action policies are already linked to a state change during the policy definition).
For more information see:
Assigning an action to a device (on page 296)
Assigning an action to an active monitor (on page 297)
Creating a custom action policy (on page 299)
After the actions have been completely configured, WhatsUp Gold launches the action as
soon as the proper state change is reached.
Adding and editing an Active Script Action
This action allows you to write either VBScript or JScript code to perform a customized action.
If the script returns an error code, the action failed.
To add or edit an active script action:
1 Click the Admin tab, then click Action Library.
2 Click New to create a new active script action, and then select Active Script Action
from the list. Click OK.
- or -
From the list of current actions, select the action you want to change, and then click
Edit.
3 Type or select the appropriate information in the following fields.
Name. Type a name for the action. This name displays in the Action Library.
Description. Type a short description. This description displays next to the action in
the Action Library.
Timeout. The amount of time (in seconds) WhatsUp Gold should wait for the action
script to run.
Note: Though the maximum timeout is 60 seconds, you are highly discouraged from using a
timeout longer than the default of 10 seconds. You are encouraged to use the shortest
timeout possible.
Script type. Select the scripting language that you want to use to write this active
script (either VBScript or JScript).
Script text. Write or insert your action code here.
274