Desktop and Webtop tools

The probe is supplied with tools that enable you to acknowledge and resolve events in Microsoft SCOM 2012 from the Windows desktop and from IBM® Tivoli® Netcool/Webtop.

Note: The desktop and Webtop tools require Perl 5.6 (or later) with the Telnet module installed, and a local copy of the Netcool/OMNIbus SQL interactive interface tool (nco_sql).

The following table describes the tools files supplied for use with UNIX and Linux® operating systems:

Table 1. UNIX and Linux desktop and Webtop tools files
User interface	File name	Description and operation
Desktop	UnixScomTools.sql	This file creates a UI menu called Microsoft SCOM that contains two menu items, Acknowledge Alert and Resolve Alert. Both menu items call TelnetScomProbe.pl and pass it the `@AlertKey` of the event and the socket address of the probe (as specified by `@NodeAlias`) as arguments.
	TelnetScomProbe.pl	This script is called by the Acknowledge Alert and Resolve Alert menu items. It starts Telnet using the specified socket address of the probe (`@NodeAlias`). It then connects to the probe's command port and issues either an `acknowledge_alarm` or `resolve_alarm` command using the `@AlertKey`. The Acknowledge Alert tool sets the event status to `Acknowledged` (1) in the `alert.status` ObjectServer table. The Resolve Alert tool sets the event severity to `Cleared` (0) in the `alert.status` ObjectServer table.
Webtop	CreateScomGroup.xml	This file creates a group called `Microsoft_SCOM` and adds the user account that you specify.
	UnixScomTools.xml	This file registers the UnixScomTools.cgi script tool in Webtop. This creates a UI menu called Microsoft SCOM that contains two menu items, Acknowledge Alert and Resolve Alert. Both menu items call UnixScomTools.cgi and pass it the `@AlertKey` of the event and the socket address of the probe (as specified by `@NodeAlias`) as arguments.
	UnixScomTools.cgi	This script is called by the Acknowledge Alert and Resolve Alert menu items. It starts Telnet using the Perl module, connects to the probe's command port, and then issues either an `acknowledge_alarm` or `resolve_alarm` command using the `@AlertKey` value. The Acknowledge Alert tool sets the event status to `Acknowledged` (1) in the `alert.status` ObjectServer table. The Resolve Alert tool sets the event severity to `Clear` (0) in the `alert.status` ObjectServer table.

The following table describes the tools files supplied for use with Windows operating systems:

Table 2. Windows desktop and Webtop tools files
User interface	File name	Description and operation
Desktop	WindowsScomTools.sql	This file creates a UI menu called Microsoft SCOM that contains two menu items, Acknowledge Alert and Resolve Alert. Both menu items call TelnetScomProbe.VBS and pass it the `@AlertKey` of the event and the socket address of the probe (as specified by `@NodeAlias`) as arguments.
	TelnetScomProbe.VBS	This file is called by the Acknowledge Alert and Resolve Alert menu items. It starts Telnet using the netcool_tivoli_socket.dll library. It then connects to the probe's command port and issues either an `acknowledge_alarm` or `resolve_alarm` command using the event identifier provided. The Acknowledge Alert tool sets the event status to `Acknowledged` (1) in the `alert.status` ObjectServer table. The Resolve Alert tool sets the event severity to `Cleared` (0) in the `alert.status` ObjectServer table.
	netcool_tivoli_socket.dll	This is a Win32 library that provides an implementation of the Telnet client for use on Windows.
Webtop	CreateScomGroup.xml	This file creates a group called `Microsoft_SCOM` and adds the user account that you specify.
	WindowsScomTools.xml	This file registers the WindowsScomTools.cgi script tool in Web GUI. This creates a UI menu called Microsoft SCOM that contains two menu items, Acknowledge Alert and Resolve Alert.
	WindowsScomTools.cgi	This script is called by the Acknowledge Alert and Resolve Alert menu items. It starts Telnet using the Perl module, connects to the probe's command port, and then issues either an `acknowledge_alarm` or `resolve_alarm` command using the event identifier provided. The Acknowledge Alert tool sets the event status to `Acknowledged` (1) in the `alert.status` ObjectServer table. The Resolve Alert tool sets the event severity to `Clear` (0) in the `alert.status` ObjectServer table.