Viewing Task results

The Task Results dialog displays results for tasks that have been run using the Scheduled Task Library's Run Now option.

To view Task Results for a task:

1. On the WhatsUp Gold console, select Configure > WhatsConfigured Task Library. The WhatsConfigured Task Library appears.
2. Select a task, then click Run Now. A dialog displaying the task's progress appears.
3. When the task completes, click View Results. The Task Results dialog appears.

The dialog displays the following result for a task that was ran using the Run Now option:

• Task status. The result of the entire task. A task is considered to be successful only if the task completes successfully for all devices for which it runs. In the event that the task fails, the task message displays information regarding the failure.
• Task Message. A message that explains why the task failed. If the task runs successfully for all devices, this field is empty.
• Task Devices. The devices for which the task was run.

Tip: Select a device to view its result information in the following section of the dialog.

Below, the dialog displays device-specific results in six tabs.

Tip: Select a dialog tab to view information for its specific dialog fields.

The Output tab displays the task's result, relevant messages, and a trace of all communication between the device and the WhatsConfigured service.

For each task it displays:

• Result. The result of the task for the selected device.
• Message. Any message pertaining to the task for the selected device. In some instances, this field may be empty.
• Trace. A history of all communication that takes place between the device and the WhatsConfigured service during the task's attempted completion. If the task collects a configuration file as part of the task, it is included in the trace. If the task was successful for this device, the trace displays what the command prompt would have looked like if the user consoled into the device and run the commands manually using a command prompt.
• If the task failed and no communication took place between the device and the WhatsConfigured service due to communication or configuration errors, the box displays "No communication with the device was recorded." Finding the cause of this failure may be accomplished by reviewing the credentials listed on the Settings tab, reviewing device configurations, attempting to communicate with the device manually, or by checking the log.

The Script tab displays the task script assigned to this task as it is saved in the Task Script Library, and how the task looks after it is processed through the WhatsConfigured task runner.

For each task it displays:

• Script Text. The script assigned to be run by the task. If this script is a custom script, it appears exactly as it did when it was configured in the New/Edit WhatsConfigured Task Script dialog. If this is a predefined password or backup task, the script displayed is the script chosen for this device based on the WhatsConfigured script registry.

Note: Scripts for predefined WhatsConfigured tasks are looked up based on the OID associated with the device. If there is no OID assigned to the device, the lookup fails and no script is listed. OID's can be assigned to a device from the Device Properties - Tasks dialog, or collected by discovering the device. Due to the large number of devices and their varying commands this script to device mapping may fail.

• Processed Text. The WhatsConfigured scripting language allows for variable replacement within scripts. WhatsConfigured pre-defined scripts utilize this ability when running password tasks. Before the script is run the script is processed and all variable references are replaced with the variables corresponding value. The processed text displays the resulting script after processing. This field allows the user to ensure variable declarations are being assigned and interpreted properly.

Tip: If you are experiencing a problem with a script, Save the results listed in the script tab to a text (.txt) file. If you contact Technical Support, this file will aid in troubleshooting your script problem.

The Variables tab displays the name and value of all variables associated with the task script.

For each task it displays:

The Commands tab displays a list of the commands as they were interpreted by the WhatsConfigured script runner. It also displays the results of those commands if they were run against the device when the task was run.

For each task it displays:

• Command. The specific command; for example, login or show configuration.
• Result. The success or failure of the command when it was ran by the task.
• Output. The results of the responses declared by the WhatsConfigured script language.

The Log tab displays any error messages that were logged as the task ran.

The Settings tab displays the protocol credentials used to complete the task.

For each task it displays:

• Type. The type of protocol credentials; for example, SSH or Telnet.

Note: WhatsConfigured defaults to SSH credentials when available. If SSH credentials are not assigned to a device, WhatsConfigured will look for/use Telnet credentials.

• Name. The name of the credentials as assigned in the Credentials Library.
• Description. The description of the credentials as assigned in the Credentials Library.