Using the context object with actions

LogMessage(sText);

This methods allows for a message to be written to the WhatsUp Gold debug log. Messages are displayed in the Event Viewer.

Example

JScript

Context.LogMessage( "Checking action name using Context.GetProperty()");

VBScript

Context.LogMessage "Checking Address using Context.GetProperty()"

SetResult(LONG nCode, sText);

This method allows for a result code and result message to be set. This is how you can tell the WhatsUp Gold system if the action succeeded or failed.

Example

JScript

Context.SetResult(0, "Script completed successfully."); //SuccessContext.SetResult(1, "An error occurred."); //Failure

VBScript

Context.SetResult 1, "An error occurred."

NotifyProgress(sText);

This method allows for a message to be written to the actions progress dialog. Messages are displayed in the Test dialog and Running Actions dialog.

Example

JScript

Context.NotifyProgress( "Checking action name using Context.GetProperty()");

VBScript

Context.NotifyProgress "Checking Address using Context.GetProperty()"

IsCancelled();

This method tests whether the action has been canceled by the user. If the return is true, then the script should terminate.

A cancel can be issued by the user in the action progress dialog and by the WhatsUp Gold engine when shutting down.

GetProperty(sPropertyName);

This property offers access to many device specific aspects. You obtain access to these items using the names listed. Theses names are case sensitive.

Example

JScript

var sAddress = Context.GetProperty("Address");var nDeviceID = Context.GetProperty("DeviceID");