IBM Tivoli Netcool/OMNIbus, Version 7.4

CGI tools

CGI tools are typically used by clients to process ObjectServer field information and return useful information about the data to the client browser.

For example, the CGI script nco_ping provided with Web GUI sends specially marked packets from the local computer to a remote device to determine whether the remote computer is currently available. The script uses the IP address contained in the Node field of the selected alert (or alerts) as its target. The source file for nco_ping is located in the following directory:

webgui-home/etc/cgi-bin

Query string for nco_ping

The following example shows the URL for the nco_ping CGI script run on an event generated from a device with the node name zen1 and data source NCOMS. The GET query string is as follows.

selected_rows.Node=zen1&datasource=NCOMS

This data is passed to the CGI script.

protocol://server:port/ibm/console/webtop/cgi-bin/
nco_ping.cgi?%24selected_rows.Node=zen1&datasource=NCOMS

CGI tools do not have to run CGI scripts. CGI tools can also be used to open a local or remote Web page. Be aware that a remote script or page that contains SmartPage commands cannot be presented correctly within Web GUI. Pages that contain SmartPage commands must be hosted on the local Web GUI server.

CGI scripts can use different kinds of variables, including HTTP variables, ObjectServer fields, and browser cookie values.

Note: If any required resources, for example, Perl, are installed in nonstandard locations, ensure that the paths to the resources in any CGI scripts are correct.