IBM Tivoli Netcool/OMNIbus Version 8.1

Tool Details

Use this window to set up a new tool or edit the details of an existing tool.

The Tool Details window contains the following areas:

Tool setup area

Complete this area as follows:

Name: Type a unique name for the tool. If you are editing a tool, you cannot change the name.
Enabled: Select this check box to activate the tool on the system and make it available for operators to use. Clear this check box to create the tool without activating it at the present time, or to make the tool unavailable.

Use this tab only if you want to run SQL commands on the ObjectServer when the tool is selected for use. Complete this tab as follows:

Enabled: Select this check box to specify that the SQL commands entered must run when the tool is used.
Execute for each selected row: Select this check box to specify that the SQL commands must run once for each row in an event list row selection.
SQL Commands: Type the SQL commands that must run when the tool is used.; You can use the SQL helper buttons shown to the right of this field to construct the SQL commands.
Tip: You can include a prompt in an SQL statement so that when the tool runs, it calls up a prompt window or a pop-up menu for users to enter or select information.

Use this tab only if you want to run external commands when the tool is selected for use. Complete this tab as follows:

Enabled: Select this check box to specify that the executable commands entered must run when the tool is used.
Execute for each selected row: Select this check box to specify that the executable commands must run once for each row in an event list row selection.
Redirect output: Select this check box to specify that output must be echoed through a read-only window when the commands are run. Clear this check box to discard the output.
Redirect errors: Select this check box to specify that any error messages must be echoed through a read-only window when the commands are run. Clear this check box to discard the error messages.
Executable Commands: Type the commands that must run when this tool is used.; You can use the SQL helper buttons shown to the right of this field to construct the executable commands.
Tip: You can include a prompt in an external command so that when the tool runs, it calls up a prompt window or a pop-up menu for users to enter or select information.

Use this tab to specify journal settings that must apply when the tool is selected for use. Complete this tab as follows:

Force Journal Entry: Select this check box to force users to enter journal text before running the tool. This text is appended to the journal of the selected alert or alerts when the tool is used.
Execute for each selected row: Select this check box to enter journal information once for each row in an event list row selection.
Journal Entry: Type the text for the journal entry.; You can use the helper buttons shown to the right of this field to construct the journal text.
Tip: You can include a prompt in a journal entry so that when the tool runs, it calls up a prompt window or a pop-up menu for users to enter or select information.

Use this tab to specify alert classes to which the tool applies, and the groups of users permitted to use the tool. Complete this tab as follows:

Class Access: Select the alert classes for which the tool can be used. To select all alert classes, click Tick All to the immediate right of this list. To clear all your selections, click Tick None to the immediate right of this list. You can also individually select each check box required.
Group Access: Select the user groups that can use this tool. To select all groups, click Tick All to the immediate right of this list. To clear all your selections, click Tick None to the immediate right of this list. You can also individually select each check box required.

Use this tab to specify the operating systems on which the tool is available. Complete this tab as follows:

Available Platforms: Select the check boxes for the operating systems on which the tool will be available. To select all operating systems, click Tick All to the right of this list. To clear all your selections, click Tick None to the right of this list.
Important: You must always specify the operating systems on which the tool can be used. The tool is only available on platforms that are selected.

Use this tab to enter an optional text description for this tool. This can be useful to anyone who is trying to understand how the tool works.

After creating or editing a tool, you can save or cancel the changes made by clicking the relevant button as follows:

OK: Click this button to save the tool details and close the window. New tools are added to the Tools pane.
Cancel: Click this button to close the window without saving your changes.