Example: Starting a transient event list from a tool

These examples show how to run the transient event list from a tool, on both UNIX and Windows.

Tip: In a dual server desktop (DSD) configuration, use the %desktopserver internal value in place of the %server value that is shown in the following example commands. This is to ensure that the ObjectServer sends its message to the correct client.

Example: nco_elct command on UNIX

The following example shows how to use the nco_elct utility in the Show Related FE Node tool that is shipped with Tivoli Netcool/OMNIbus.

$NCHOME/omnibus/bin/nco_elct -server "%server" -username "%username" 
-password "%password" -vfile "$NCHOME/omnibus/desktop/default.elv" 
-ftext "( RemoteNodeAlias != '' and RemoteNodeAlias = '@LocalNodeAlias' ) 
or ( LocalNodeAlias != '' and LocalNodeAlias = '@RemoteNodeAlias') 
or Node = '@RemoteNodeAlias' or RemoteNodeAlias = '@Node'"

Example: NCOelct command on Windows

The following example shows how to use the NCOelct.exe utility in the Show Related FE Node (Windows) tool that is shipped with Tivoli Netcool/OMNIbus.

"$(NCHOME)/omnibus/desktop/NCOelct.exe" -server "%server" -username "%username" 
-password "%password" -vfile "$(NCHOME)/omnibus/ini/default.elv" 
-elf "$(NCHOME)/omnibus/ini/tool.elf" -params "( RemoteNodeAlias != \\'\\' 
and RemoteNodeAlias = \\'@LocalNodeAlias\\' ) 
or ( LocalNodeAlias != \\'\\' and LocalNodeAlias = \\'@RemoteNodeAlias\\') 
or Node = \\'@RemoteNodeAlias\\' or RemoteNodeAlias = \\'@Node\\'"

The tool.elf file, which is referenced in the preceding NCOelct command, has the following content:

filter_name = 'ToolFilter';
filter_text = '@FilterText';
filter_metric = 'avg(Severity)';
# End of file

The NCHOME environment variable for Windows is expressed differently in a tool than the normal usage (%NCHOME%). This difference occurs because the variable is interpreted and resolved by the built-in tools parser and not by the Windows operating system.

When you run the tool from the event list, the entire string that follows the -params option replaces the @FilterText placeholder in the tool.elf file. The @LocalNodeAlias, @RemoteNodeAlias, and @Node placeholders are replaced in the -params string by values from the event that is currently selected in the event list.