Creating and editing tools

When you create a tool, it is added to the tools database. The tools that appear in the Tools pane are links to entries in this database.

1. From the Netcool/OMNIbus Administrator window, select the Menu menu button.
2. Click Tools.
   The Tools pane opens.
3. To add a tool, click Add Tool in the toolbar.
   The Tool Details window opens.
4. To edit a tool, select the tool to edit and then click Edit Tool in the toolbar.
   The Tool Details window opens.
5. Define the tool 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.

6. From the SQL tab, enter any SQL commands that should run on the ObjectServer when the tool is selected for use. Complete the 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.

7. From the Executable tab, enter any external commands that should run when the tool is selected for use. Complete the 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.

8. From the Journal tab, specify journal settings that should apply when the tool is selected for use. Complete the 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.

9. From the Access tab, specify alert classes to which the tool applies, and the groups of users permitted to use the tool. Complete the 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.

10. From the Platform tab, specify the operating system platforms on which the tool will be available. Complete the 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.

11. From the Description tab, enter an optional text description for this tool. This can be useful to anyone who is trying to understand how the tool works.
12. Save or cancel your changes 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.