Adding 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.

Note: This script action has a context object you can use to get specific information about the context of the action.

Note: We have provided several code samples for you to create useful script actions for your devices.

Note: All script features in WhatsUp Gold utilize the SNMP API.

To add a new Active Script action:

1. From the WhatsUp Gold web interface, go to APM > Actions, then click Actions in the Actions Management tree. The Actions page appears.
2. Click Add Action. The Edit Action page appears.
3. Select Active Script from the Action type list. The boxes for the Active Script action appear.
4. Enter or select the appropriate information:
   • Name. Enter a unique name for the action. This name displays in the Action Library.
   • Description. (Optional) Enter additional information about the action. This description displays next to the action in the Action Library.
   • Timeout (seconds). Enter the length of time WhatsUp Gold attempts to connect to the selected device. When the time you enter is exceeded without connecting, a timeout occurs and WhatsUp Gold stops trying to connect to the SMTP server. This is considered a failed connection.

   Note: Though the maximum timeout is 60 seconds, you are 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. Enter your action code here.

   Note: We do not recommend that you use percent variables in script text, because they may resolve to text containing special characters (' ' (quotes), " " (double-quotes), % (percent), new line characters, and the like) that may break your script.

5. Click Save. The action is added to the Actions list.

See Also Creating an action in APM Adding an E-mail action Adding a Log-to-Text File action Adding a Windows Event Log action Adding a PowerShell Script action Adding a Program action Adding a Service Restart action Adding an SMS action Adding an SMS Direct action Adding an SSH action Adding a Syslog action Adding a VMware action