|
|
This appendix contains reference information on desktop tools. It also contains information about editing the connections file that is used to create communications information.
It contains the following sections:
This section lists the menu options for the Java Applet Configuration Editor (JACE) and command line utilities for the Java background process.
JACE can be started with the jace command.
| Option/Parameter | Description |
|---|---|
-template | Sets the name of the template file to use. The template file contains the settings for a configuration. |
-props | Sets the properties file. |
-host | Specifies the name of the host to connect to. When not specified, defaults to NCOMS. |
-port | Sets the properties file name. |
-help | Displays help on JACE command line options and exits. |
-version | Displays version information and exits. |
| Menu | Submenu | Action |
|---|---|---|
File | Import Configuration | Imports a configuration file and displays the configuration information in the JACE display. |
File | Export Configuration | Exports the configuration information to a file. The recommended file extension is .jace. |
The Java background process can be started with the jeld command.
| Option/Parameter | Description |
|---|---|
-host <string> | Specifies the name of the host where the Info Server is located. |
-port <string> | Specifies the port setting for the Info Server. |
-listenport <string> | Sets the port number. |
-logdir <string> | Sets the directory where the log file is located. |
-logfile <string> | Specifies the name of the log file. |
-props | Sets the properties file name. |
-help | Displays Help on jeld command line options and exits. |
-version | Displays version information and exits. |
User administration is part of the configuration manager tool.
Table B-4 lists the menu options for the Users tab of the Configuration Manager window.
| Menu | Submenu | Short Cut | Description |
|---|---|---|---|
File | Exit |
| Exits Configuration Manager. |
User | New |
| Opens the New User window. |
User | Edit |
| Opens the Edit User window |
User | Security Level |
| Opens a pull down list allowing the security level to be seen and changed. |
User | Allow ISQL |
| Allows the user to login to the Info Server using the SQL Interactive Interface. |
User | Restrict Events |
| Makes the Info Server to apply the restriction filter entered for the user. |
User | Edit Restriction Filter |
| Opens the Filter Builder window to allow you to edit the restriction filter. |
User | Edit Groups |
| Opens the Edit Group window. |
User | Add to Group |
| Opens a list of groups and adds the selected user to the chosen group. |
View | Normal users | Control + N | Toggle button to enable or disable the display of normal users in the user list. (Enabled by default). |
View | Administrators | Control + A | Toggle button to enable or disable the display of administrators in the user list. (Enabled by default). |
View | Super Users | Control + S | Toggle button to enable or disable the display of super users in the user list. (Enabled by default). |
View | `Nobody' User | Control + O | Toggle button to enable or disable the display of the nobody user in the user list. (Disabled by default). |
View | Refresh Users | Control + R | Refreshes the Configuration Manager window. |
Table B-5 lists the button options for the Users tab of the Configuration Manager window.
| Button | Description |
|---|---|
| Opens the New User window. |
| Opens the Edit User window. |
| Deletes the selected user. |
| Opens the Edit Group window. |
| Opens the System Users window. |
Table B-6 lists the menu options for the Groups window.
| Menu | Submenu | Short Cut | Description |
|---|---|---|---|
Group | New |
| Opens the New Group window. |
Group | Rename |
| Renames the user group. |
Group | Close |
| Exits the User Groups window. |
View | Refresh Groups | Control + R | Refreshes the Groups window. |
Table B-7 lists the button options for the Groups window.
| Button | Description |
|---|---|
| Opens the New Group window. |
| Renames the user group. |
| Deletes the selected group or user within a group. |
| Rename a member within a group. |
The automation configuration is part of the configuration manager tool. The command line options can be found in the "Configuration Manager" section.
Table B-8 lists the menu options for the Automations tab of the Configuration Manager window.
| Menu | Submenu | Short Cut | Description |
File | Import |
| Displays the standard file manager window to allow the automation file to be selected and imported. |
File | Export |
| Displays the Export Automations window to allow the selection of triggers and actions for export. |
File | Exit | Control + Q | Exits the Configuration Manager window. |
Trigger | New |
| Opens the New Trigger window. |
Trigger | Edit |
| Opens the Edit Trigger window. |
Trigger | Rename |
| Opens a Rename Trigger window. |
Trigger | Copy |
| Opens a Copy Trigger window. |
Trigger | Delete |
| Deletes the selected trigger. |
Trigger | Active |
| Toggles the trigger enable option for the selected trigger. |
Trigger | Set Ascent Action |
| Opens a list of actions. When an action is selected it is added to the chosen trigger as an ascent action. |
Trigger | Set Descent Action |
| Opens a list of actions. When an action is selected it is added to the chosen trigger as an descent action. |
Trigger | Test Trigger |
| Test the selected trigger. |
Trigger | Edit Actions |
| Opens the Actions window. |
View | Refresh Triggers |
| Updates the Automation tab of the Configuration Manager window. |
Table B-9 lists the button options for the Automations tab of the Configuration Manager window.
| Button | Description |
|---|---|
| Opens the New Trigger window.
|
| Opens the Edit Trigger window.
|
| Deletes the selected trigger. |
| Opens the Actions window. |
Table B-10 lists the menu options for the Actions window.
| Menu | Submenu | Short Cut | Description |
File | Import |
| Displays the standard file manager window to allow the action to be selected and imported. |
File | Export |
| Displays the Export Actions window to allow the actions of triggers and actions for export. |
File | Exit | Control + Q | Closes the Actions window. |
File | Close |
| Displays the Export Actions window to allow the actions of triggers and actions for export. |
Action | New |
| Opens the New Action window. |
Action | Edit |
| Opens the Edit Action window. |
Action | Rename |
| Opens a Rename Action window. |
Action | Copy | Control + C | Opens a Copy Action window. |
Action | Clear Triggers |
| Clears the actions associated with the trigger. |
Action | Delete | Delete | Deletes the selected action. |
View | Refresh Actions | Control + R | Updates the Actions window. |
Table B-11 lists the button options for the Actions window
.
| Button | Description |
|---|---|
| Opens the New Action window. |
| Opens the Edit Action window. |
| Deletes the selected action. |
Table B-12 describes the icons that may appear beside a trigger or an action. The trigger icons appear in gray if the trigger is not active.
| Icon | Description | Icon | Description |
|---|---|---|---|
| An ascending action is identified by a blue upward pointing triangle. | | An descending action is identified by a red downward pointing triangle. |
| An active ascending action is identified by a blue upward pointing triangle with a flash. | | An active descending action is identified by a red downward pointing triangle with a flash. |
| Internal Action Enabled. | | External Action Enabled. |
| Both Internal and External Actions Enabled. | | Action Disabled. |
| Edge Trigger. Once only execution mode. | | Edge Trigger. For each matched row execution mode. |
| Level Trigger. Once only execution mode. | | Level Trigger. For each matched row execution mode. |
| Delayed Edge Trigger. Once only execution mode. | | Delayed Edge Trigger. For each matched row execution mode. |
| Delayed Level Trigger. Once only execution mode. | | Delayed Level Trigger. For each matched row execution mode. |
The Info Server Properties configuration is part of the Configuration Manager window. The command line options can be found in the "Configuration Manager" section.
Table B-13 lists the menu options for the Properties tab of the Configuration Manager window.
| Menu | Submenu | Short Cut | Description |
File | Exit | Control + Q | Exits the Configuration Manager window. |
Properties | Set Property |
| Toggles a boolean property between true and false. |
Properties | Edit Property |
| Opens a window to allow a new integer value to the entered for a property. |
Properties | Save as Defaults |
| Instructs the Info Server to save its property settings to the |
View | Refresh Properties | Control + R | Refreshes the Properties tab. |
Table B-14 lists the button options for the Properties tab of the Configuration Manager window.
| Button | Description |
|---|---|
| Toggles a boolean property between true and false. |
| Opens a window to allow a new integer value to the entered for a property. |
| Instructs the Info Server to save the current property settings to the |
The menus and tools configuration is part of the configuration manager tool. The command line options can be found in the "Configuration Manager" section.
Table B-15 lists the menu options for the Menus tab of the Configuration Manager window.
| Menu | Submenu | Short Cut | Description |
File | Exit | Control + Q | Exits the Configuration Manager window. |
Menu | New Tool |
| Opens the New Tools window or a drop down list of existing tools. |
Menu | New Separator |
| Adds a separator at the bottom of the selected menu. |
Menu | New Sub-Menu |
| Opens the Menu Name window. The new sub menu will be added to the bottom of the selected menu. |
Menu | Edit |
| Opens the Edit Tool window for the selected tool. |
Menu | Rename |
| Used to rename a selected sub menu or rename the menu item name of a selected tool. |
Menu | Cut | Control + C | Copies the selected menu item to the clipboard and removes the item from its current menu. |
Menu | Copy | Control + V | Copies the selected menu item to the clipboard and leaves the item in its current menu. |
| Menu | Submenu | Short Cut | Description |
Menu | Paste |
| Pastes the item on the clipboard to the selected menu. |
Menu | Delete |
| Deletes the selected menu item. |
Menu | Edit Tools |
| Opens the Tools window. |
Menu | Edit Prompts |
| Opens the Prompt Definitions window. |
View | Refresh Menus | Control + R | Refreshes the Properties tab. |
Table B-16 lists the button options for the Menus tab of the Configuration Manager window.
| Button | Description |
|---|---|
| Opens a pull down list with the options to create a new tool, a new sub-menu and a new separator. |
| Opens the Edit Tool window. |
| Deletes the selected menu item. |
| Cuts the selected menu item to the clipboard and removes the item from its current menu. |
| Copies the selected menu item to the clipboard and leaves the item in its current menu. |
| Pastes the item on the clipboard to the selected menu. |
| Moves the selected menu item to the top of the menu. |
| Moves the selected menu item one position up the menu. |
| Moves the selected menu item to the bottom of the menu. |
| Moves the selected menu item one position down the menu. |
| Applies a group filter to the menu items visible in the Menus tab. |
| Applies a class filter to the menu items visible in the Menus tab. |
| This opens popup menu based on the content of the selected menu and the current filter selection. |
| This opens the Tools window. |
| This opens the Prompt Definition window. |
Table B-17 lists the menu options for the Tools window.
| Menu | Submenu | Short Cut | Description |
Tool | New |
| Opens the New Tool window. |
Tool | Edit |
| Opens the Edit Tool window. |
Tool | Enable |
| Enables the currently selected tool. |
Tool | Rename |
| Opens the Rename Tool window. |
Tool | Copy |
| Opens the Copy Tool window. |
Tool | Delete |
| Deletes the currently selected tool. |
Tool | Edit Prompts |
| Opens the Prompt Definitions window. |
Tool | Paste |
| Pastes a copy of the tool. |
Tool | Close |
| Exits from the Tools window. |
View | Refresh Tools | Control + R | Refreshes the Tools window. |
Table B-18 lists the button options for the Tools window:
| Button | Description |
|---|---|
| Opens the New Tool window. |
| Opens the Edit Tool window. |
| Deletes the currently selected tool. |
| Opens the Prompt Definitions window. |
Table B-19 lists the menu options for the Prompts window.
| Menu | Submenu | Short Cut | Description |
Prompt | New |
| Opens an empty Prompt Definitions window. |
Prompt | Edit |
| Opens the Prompt Definitions window with the details of the prompt selected for editing. |
Prompt | Rename |
| Opens a Rename Tool window. |
Prompt | Copy |
| Opens the Copy Tool window. |
Prompt | Paste |
| Pastes from the clipboard. |
Prompt | Close |
| Closes the Prompt Definitions window. |
View | Refresh Tools | Control + R | Updates the tools list. |
Table B-20 lists the button options for the Prompts window
.
| Button | Description |
|---|---|
| Opens a New Prompt window. |
| Opens the Edit Prompt window with the details of the prompt selected for editing. |
| Deletes the selected prompt. |
Table B-21 lists the buttons that appear in the New Tool and Edit Tool windows.
| Button | Description | Button | Description |
|---|---|---|---|
| Select an SQL command. | | Select a field from the alerts.status table. |
| Select a conversion. | | Select from a list of internal |
| Select from a list of available prompt names. | | Open the Filter Builder window. |
| Select from a list of |
|
|
Table B-22 shows and describes the icons which may appear in a menu
.
| Icon | Description | Icon | Description |
|---|---|---|---|
| Enabled Tools. | | Tool no longer exists in the tools.actions table. |
| Disabled Tools. | | Separator. |
| SubMenu. |
|
|
The conversions configuration is part of the configuration manager tool. The command line options can be found in the "Configuration Manager" section.
Table B-23 lists the menu options for the Conversions tab of the Configuration Manager window.
| Menu | Submenu | Short Cut | Description |
File | Exit | Control + Q | Exits the Configuration Manager window. |
Conversion | New |
| Opens the New Conversion window. |
Conversion | Edit |
| Opens the Edit Conversion window. |
Conversion | Delete |
| Deletes the selected conversion. |
View | Refresh Conversions | Control + R | Updates the Conversion tab of the Configuration Manager window. |
Table B-24 lists the button options for the Conversions tab of the Configuration Manager window.
| Button | Description |
|---|---|
| Opens the New Conversion window. |
| Opens the Edit Conversion window. |
| Deletes the selected conversion. |
The classes configuration is part of the configuration manager tool. The command line options can be found in the "Configuration Manager" section.
Table B-25 lists the menu options for the Classes tab of the Configuration Manager window
.
| Menu | Submenu | Short Cut | Description |
File | Exit | Control + Q | Exits the Configuration Manager window. |
Class | New |
| Opens the New Class window. |
Class | Edit |
| Opens the Edit Class window. |
Class | Delete |
| Deletes the selected class. |
View | Refresh Classes | Control + R | Updates the Classes tab of the Configuration Manager window. |
Table B-26 lists the button options for the Classes tab of the Configuration Manager window.
| Button | Description |
|---|---|
| Opens the New Class window. |
| Opens the Edit Class window. |
| Deletes the selected class. |
The column visuals configuration is part of the configuration manager tool. The command line options can be found in the "Configuration Manager" section.
Table B-27 lists the menu options for the Column Visuals tab of the Configuration Manager window.
| Menu | Submenu | Short Cut | Description |
File | Exit | Control + Q | Exits the Configuration Manager window. |
Column Visual | New |
| Opens the New Column Visual window. |
Column Visual | Edit |
| Opens the Edit Column Visual window. |
Column Visual | Delete |
| Deletes the selected column visual. |
View | Refresh Column Visuals | Control + R | Updates the Column Visuals tab of the Configuration Manager window. |
Table B-28 lists the button options for the Column Visuals tab of the Configuration Manager window.
| Button | Description |
|---|---|
| Opens the New Column Visual window. |
| Opens the Edit Column Visual window. |
| Deletes the selected column visual. |
The column visual icon is designed to represent the justification of the column body and heading. The position can be left, centre or right justified.
| Icon | Description |
|---|---|
| Title and column justified left. |
| Title justified center and column justified right. |
This section lists the command line options for the Configuration Manager window and the help menu options for all tabs.
You can start the configuration tool by selecting the Configuration button on the Cisco Info Center Conductor of from the command line by entering the nco_admin command.
The following sections describe the syntax and usage for the nco_admin command.
Table B-30 describes the command line options for the nco_admin command.
| Option/Parameter | Description |
|---|---|
-username string | Sets the username to connect as. |
-password string | Sets the password to use (not recommended to be used as it advertises the password in the UNIX systems process list). |
-server string | Specifies the name of the Info Server to connect to. If not specified, defaults to NCOMS. |
-nlw | Do not display the license expiry warnings. |
-diagnostic | Display the extended diagnostic messages (for support only). |
-cmap | Installs a private color map. Useful for displays with limited colors available. |
-automations | Open the Configuration Manager window with the Automation tab displayed. |
-users | Open the Configuration Manager window with the Users tab displayed. |
-properties | Open the Configuration Manager window with the Properties tab displayed. |
-menus | Open the Configuration Manager window with the Menus tab displayed. |
-classes | Open the Configuration Manager window with the Classes tab displayed. |
-conversions | Open the Configuration Manager window with the Conversions tab displayed. |
-visuals | Open the Configuration Manager window with the Column Visuals tab displayed. |
-help | Displays help text on the command line options in configuration and exits. |
-version | Displays version information on configuration and exits. |
Table B-31 lists the menu options for all of the tabs in the Configuration Manager window on UNIX systems:
.
| Menu | Submenu | Short Cut | Description |
Help | On Context | Shift + Help | Opens the help page for the current tab. |
Help | On Help |
| Displays help on help. |
Help | On Keys |
| Displays help on keyboard short-cuts. |
Help | Index |
| Displays an index to help. |
Help | On Version |
| Displays a window with information about this version of Configuration Manager window. |
This section provides reference information on the objective view editor.
| Menu | Submenu | Short cut | Description |
|---|---|---|---|
File | New |
| Allows you to clear the map book and start a new map. |
File | Open |
| Displays a file selection dialog to allow the loading of an existing objective view map book. |
File | Save |
| Saves the current map book. If no map book is in use, a file selection dialog is displayed and you are prompted to save the file under a new filename. |
File | Save As |
| Displays a file selection dialog to allow saving of the current map book with a new name. |
File | Exit |
| Exits the objective view editor. |
Tools |
|
| The main objective view editor Tools menu. Only available if the administrator has created that menu. Designed for site specific options. |
Help | On Context | Shift + F1 | Changes the cursor to a question mark. The user can then click on any item in the objective view editor program and objective view editor will attempt to display help on that item. |
Help | On Help |
| Displays help on help. |
Help | On Keys |
| Displays help on keyboard short-cuts. |
Help | Index |
| Displays an index to help. |
Help | Tutorial |
| Displays a tutorial help page on using objective view editor. |
Help | On Version |
| Displays a window with information about this version of objective view editor. |
| Menu | Submenu | Short cut | Description |
|---|---|---|---|
File | Closes |
| Closes the Objective View Map Editor window. |
Edit | Delete |
| Deletes all currently selected symbols. |
Edit | Select All | Control + / | Selects all symbols on the current layer. |
Edit | Deselect All | Control + \ | Deselects any currently selected symbols. |
Edit | Group | Control + g | Groups the currently selected symbols into a symbol group. |
Edit | Ungroup | Control + u | Ungroups any symbol groups which are currently selected. |
Layer | Edit... | Control + l | Displays the Layer Manager window. |
Layer | number: layername | Control + Number | Toggles the display of the selected layer. Number can be any number in the range 0-9. |
Windows | Symbol Palette | Control + s | Displays the Symbol Palette window. |
Windows | Symbol Inspector | Control + i | Displays the Symbol Inspector window. |
Windows | Panner | Control + p | Displays the Panner window. |
Windows | Grid Options | Control + o | Displays the Grid Options window. |
Tools |
|
| The Objective View Editor window Tools menu. Only available if the administrator has created that menu. Designed for site specific options. |
Help | On Context | Shift + F1 | Changes the cursor to a question mark. The user may then click on any item in the objective view editor program and objective view editor will attempt to display help on that item. |
Help | On Help |
| Displays help on help. |
Help | On Keys |
| Displays help on keyboard short cuts. |
Help | Index |
| Displays an index to help. |
Help | On Version |
| Displays a window with information about this version of objective view editor. |
You can start the Objective View editor with the nco_ove command. The following sections describe the syntax and usage for the nco_ove command.
| Option | Description |
|---|---|
-map <string> | Specifies the name of a map book file (.map) to load at start up. The default is no configuration file. |
-server <string> | Specifies the name of the Info Server to connect to. |
-username <string> | Specifies the username to be used for connections. |
-password <string> | Sets the password to use (not recommended as it advertises the password in the UNIX systems process list). |
-cmap | Makes the Objective View editor use its own color map rather than the default color map. |
-nlw | Specifies not to display license expired warnings. |
-diagnostic | Specifies to display extended diagnostic messages (for support only). |
-help | Displays Help text on the Objective View editor command line options and exits. |
-version | Displays Objective View editor version information and exits. |
This section described how to edit the connections data file that is used to create the interfaces file for Cisco Info Center communications. The connections data file is called:
$OMNIHOME/etc/omni.dat
It is recommended you use the Server Editor window to edit this file. The omni.dat file format is designed for use with the Server Editor window, therefore, the format of the file does not suit command line editing. See the Cisco Info Center Installation and Configuration guide for more information.
However, there may be occasions where you need to edit the connections file directly, for example on systems that do not have a graphical interface. The following sections describe how to edit this file and generate the interfaces file.
The format of the $OMNIHOME/etc/omni.dat file is:
<servername> <hostname> <portnumber>
Where <servername> is the name of the Info Server or Process Control agent, <hostname> is the host name of the machine where that server or agent is running, and <portnumber> is the port number allocated to that server or agent. Where more than one process is running on one machine, the <portnumber> should be unique for each process.
For example, this file could contain the following:
NCOMS
{
Primary: darkstar 4100
Backup: mario.dev.net 4100
Backup: tribble 4100
}
NCO_PA
{
Primary: darkstar 4200
}
NCO_GATE
{
Primary: darkstar 4300
}
Edit the $OMNIHOME/etc/omni.dat file using this format and add the correct host name.
To generate a $OMNIHOME/etc/interfaces file, specify the following command:
host% $OMNIHOME/bin/nco_igen
To generate a $OMNIHOME/etc/interfaces.solaris2 file, suitable for Solaris 2.x systems, specify the following command:
host% $OMNIHOME/bin/nco_igen -arch solaris2
The -arch option takes solaris2 as its parameter. You can also use the java parameter to generate the interfaces file used specifically for Java support.
To generate all the architecture specific interfaces files and the Java interfaces file with one command, specify the command:
host% $OMNIHOME/bin/nco_igen -all
Posted: Tue Jun 13 15:26:42 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.
