Using the Configuration Manager

You can access most Cisco Info Center configuration tasks from the Configuration Manager window. Figure 3-1 shows the Configuration Manager Win dow with the Automations tab selected.

Figure 3-1: The Configuration Manager Window

The tabs on the Configuration Manager window allow you to select the following areas of configuration:

Automations. Allows you to define event conditions that trigger automatic responses by the system.
Users. Allows you to manage user access to Cisco Info Center.
Properties. Allows you to edit the settings in the properties file for the current Info Server.
Menus. Allows you to configure how system menus appear to end users.
Classes. Allows you to define event classes.
Conversions. Allows you to specify data conversion for data fields in events.
Column Visuals. Allows you to specify how the information in event fields appears on the event list display and in other tools.

Each tab has its own toolbar and menu bar which are displayed at the top of the Configuration Manager window.

For information on the Users option and user administration, refer to "User Administration."

For information on the Automations option, refer to "Automation."

This chapter describes all of the other configuration options.

Starting the Configuration Manager

You can start the Configuration Manager in two ways:

by clicking the Configuration icon on the Conductor window.
from the UNIX command line

To start the Configuration Manager from the Conductor, click the Configuration icon.

To start the Configuration Manager from the UNIX command line, enter one of the following commands:

$OMNIHOME/bin/nco_admin

$OMNIHOME/bin/nco_admin -option

where option specifies the option you want to appear when the Configuration Manager starts.

In this form of the command, -option is one of the following:

-automations
-users
-properties
-menus
-classes
-conversions
-visuals

The Configuration Manager window tabs display an icon and text. To select a configuration category, click on the tab in the left column frame of the Configuration Manager window.The selected tab appears in front of the other tabs.

Toolbars and Menu Bars

The Configuration Manager window toolbar and menu bar are different for each tab. The menu bar contains drop down menus. The toolbar contains buttons for the most frequently used functions.

Resizing a Window

You can resize the Configuration Manager window by dragging an edge or corner. If the window content is too large for the resized window, scroll bars appear. If the tabs on the left of the Configuration Manager window do not fit in the window, scrolling arrows appear. Click on the arrows to scroll through the tabs.

Conversions

When Cisco Info Center displays information in the event list, it can translate numeric values into strings for readability. This translation is called a conversion. It is associated with a named column in the Info Server status table.

The Conversions Tab

To edit the specification for converting numeric data, select the Conversions icon on the Configuration Manager window. The Conversions tab appears, shown in Figure 3-2.

Figure 3-2: The Conversions Tab

The Conversions tab displays a list of columns in the alerts.status database table that have conversions set. Double-click on the column icon to display the conversions currently applied. The conversions are shown indented below each column name.

Adding a Conversion

To add a conversion, complete these steps:

Step 1 Do one of the following:

From the Conversion menu, select New.
Click on the New Conversion button:.

The Add Conversion window appears, shown in Figure 3-3:

Figure 3-3: The Add Conversion Window

Step 2 To select the database column for which to convert the data, click on the Class button and then select the column to convert from the pull-down menu.

Step 3 In the Value field, enter the numeric value that you want to convert.

Step 4 In the Conversion field, enter the string value that you want to replace the numeric value.

Step 5 Click OK to save the converson entry.

Editing a Conversion

To edit a conversion, complete these steps:

Step 1 Do one of the following:

Double-click on a conversion entry on the Conversions tab to select it.
Select a conversion with the mouse and then select Edit from the Conversion menu.
Select a conversion with the mouse, click the right mouse button to bring up the popup menu, and then select Edit.
Select a conversion with the mouse and then click on the Edit Conversion button:

The Edit Conversion window appears.

The Edit Conversion and New Conversion windows are identical, except that you cannot modify the Column and Value fields in the Edit Conversion window.

Step 2 In the Conversion field, edit the string to which the value is to be converted.

Step 3 Click OK to save your changes.

Deleting a Conversion

To delete a conversion, complete these steps:

Step 1 Select the conversion that you want to delete.

Step 2 Do one of the following:

Click on the Delete Conversion button:
Select Delete from the Conversion menu.
Click the right mouse button to bring up the popup menu and then select Delete.

The conversion is removed from the column.

Refreshing the Conversions Display

To refresh the display and update the list of conversions from the Info Server, select Refresh Conversions from the View menu.

Column Visuals

When information about alerts in the Cisco Info Center system is displayed in the event list and other tools, the visual appearance is defined by the settings for the column visuals. Using the Column Visuals tab, you can control the following settings for each field in an alert:

title text
title justification
data justification
the default and maximumcolumn widths

The Column Visuals Tab

To edit the column visuals, select the Column Visuals tab on the Configuration Manager window. Figure 3-4 shows the Column Visuals tab.

Figure 3-4: The Column Visuals Tab

The Column Visuals tab has two columns. The left column lists the fields in the alerts.status table. The right column lists the associated column title displayed in the event list. The icon on the left of the field name indicates the justification of the column.

Table 3-1 shows examples of column visual table field icons

Table 3-1: Examples of Column Visual Table Field Icons

Icon Description

Title and column justified left.

Title justified center and column justified right.

Icon	Description
	Title and column justified left.
	Title justified center and column justified right.

Adding a Column Visual

To add a column visual, complete these steps:

Step 1 Do one of the following:

Select New from the Column Visual menu.
Right click on the list to display the popup menu, then select New.
Click on the New Column Visual button:

The New Column Visual window appears, shown in Figure 3-5.

Figure 3-5: The New Column Visual Window

Step 2 Select the Column button and choose the column whose appearance you want to edit from the drop down list.

Step 3 Specify the column visual attributes that you want. You can specify the following:

The Title that appears at the top of the column in the event list.
The Default Width of the column in characters.
The Maximum Width of the column in characters.
The Column Justification. Select Left, Right or Center from the drop down list.
The Title Justification. Select Left, Right or Center from the drop down list.

Step 4 Click OK to accept the settings you have added.

Editing a Column Visual

Complete these steps to edit a column visual setting.

Step 1 Do one of the following:

Double-click on the item you want to edit.
Select the item that you want to edit and then select Edit from the Column Visual menu.
Select the item that you want to edit, right click on the list to display the popup menu, and then select Edit.
Select the item that you want to edit and then click on the Edit Column Visual button:

The Edit Column Visual window appears. This window is identical to the New Column Visual window (shown in Figure 3-5) except that you cannot modify the Column field in the Edit Column Visual window. It appears in gray.

Step 2 Specify the values that you want to change. You can specify the following:

The Title that appears at the top of the column in the event list.
The Default Width of the column in characters.
The Maximum Width of the column in characters.
The Column Justification. Select Left, Right or Center from the drop down list.
The Title Justification. Select Left, Right or Center from the drop down list.

Step 3 Click OK to accept the settings you have changed.

Deleting a Column Visual

To delete a selected column visual definition, do one of the following:

Select Delete from the Column Visual menu.
Right click on the list to display the popup menu, then select Delete.
Click on the Delete Column Visual button:

The column visual definition is removed from the window.

Refreshing the Column Visual Display

To refresh the display, select Refresh Column Visuals from the View menu.

Classes

Alerts in the Info Server have a class assigned by the Info Mediator. Each class can be associated with a tool menu that contains useful tools for alerts of that class.

The Classes Tab

To edit the classes, select the Classes tab on the Configuration Manager window. Figure 3-6 showsthe Classes tab.

Figure 3-6: The Classes Tab

Each entry in the tab displays a unique identifier number and the name of the class.

Adding a Class

To add a class, complete these steps:

Step 1 Do one of the following:

Select New from the Class menu.
Right click on the list to display the popup menu, then select New.
Click on the New Class button:

The New Class window appears, shown in Figure 3-7.

Figure 3-7: The New Class Window

Step 2 In the Identifier field, enter the identifier for the new class. This identifier must be defined in the rules file for each Info Mediator that will use the class.

Step 3 In the Name field, enter a name for the class.

Step 4 If you want to associate an image with the class, select an image from the image frame by using the slider to move from one image to the next. Then click on the image you want to select it.

Step 5 Click OK to create the new class.

Editing a Class

To edit an existing class, complete these steps:

Step 1 Do one of the following:

Double-click on an existing class to select it.
Select Edit from the Class menu.
Right click on the list to display the popup menu, then select Edit.
Click on the Edit Class button:

The Edit Class window appears

The Edit Class window is identical to the Add Class window, except that you cannot modify the Identifier field in the Edit Class window. It appears in gray.

Step 2 If you want to change the name for the class, change the name that appears in the Name field.

Step 3 If you want to associate an image with the class or change an existing image, select an image from the image frame by using the slider to move from one image to the next. Then click on the image you want to select it.

Step 4 Click OK to modify the class.

Deleting a Class

To delete a class, complete these steps:

Step 1 Select the class that you want to delete.

Step 2 Do one of the following:

Select Delete from the Class menu.
Right click on the list to display the popup menu, then select Delete.
Click on the Delete Class button:

The class definition is removed from the Classes tab.

Menus and Tools

Tools allow you to control all alert management functions within Cisco Info Center. Each tool has an associated SQL statement, an executable, or both. You can group tools in tools menus, which you can associate with a class or classes of alert.

You can assign access settings that ensure only authorized users are able to use a particular tool.

You create and edit tools using the Tools window. When you create a tool, it is added to the Info Server tools database. The tools which appear in the Menus tab on the Configuration Manager window and the Tools window are links to entries in this database.

You can configure the menus from the Menus tab in the Configuration Manager window. You can assign menus to the following:

The Alerts menu and popup menu in the Event List window.
The Tools menu in the Event List window.
The Tools menu in the monitor box window.
The Tools menu on the Map Page window.
The Tools menu on the Objective View window.
The Tools menu on the Conductor window.

The alert is assigned a class by the alert source. This class can be associated with a menu using the Classes tab of the Configuration Manager window.

Each menu comprises a menu name and a list of menu items. These menu items can be a tool, a separator, or a submenu.

Menus Tab

To set up menus, select the Menus tab of the Configuration Manager window.

Figure 3-8 shows an example of the Menus tab.

Figure 3-8: The Configuration Manager Menus Tab

The Menus tab contains a list of available menus.

Double-click on a menu item to display its associated tools and submenus, if any. Tools and submenus are displayed below the menu name, indented to the right. Click on a sub-menu to display its associated tools.

Each tool has a menu item name and an associated tool name. The tool name is the link to the tool in the tools database. The menu item name appears when the menu is opened. You can modify the menu name as required.

Menu items are tools, separators and sub menus. The status of a tool is indicated by its icon as shown in the "Icons in Tool List" section.

The view can be filtered by selecting a specific group or class from the Configuration Manager window toolbar. See the "Filtering Views" section for more information.

Cisco Info Center Menus and Tools

Table 3-2 shows the customized menus that are provided with Cisco Info Center 2.0 and the tools that are associated with them. You can add items to these menus, or remove items from them, but you cannot delete them

Table 3-2: Cisco Info Center Menus and Tools

Menu Menu Description and Associated Tools

Conductor Menu:Tools

Tools menu on the main Conductor menu. Includes the following tools:

Create Event List. Allows users to create an event list including events that have a specified field.

Ping Host. Allows users to ping a specified host.

Event List: AlertsMenu

Alerts menu on the event list. This menu appears when you select an alert and includes the following tools:

Acknowledged. Acknowledges that the alert was received.

Deacknowledged. Cancels a previously initiated acknowledge action.

Prioritise. Allows users to reset the severity level of the alert.

Take Ownership. Allows users to take ownership of an alert.

Assign Action. Allows users to assign an action to a specified user.

Group Assign. Allows users to assign the event to a specified user group.

Delete. Allows deletion of the event.

Resolve. Initiates a Telnet connection to the host that is running the Info Server that received the alert and opens a Telnet console window.

MainEventListMenu : Tools

Tools menu on the Monitor Box window of the event list. Lists the following tools:

Desktop Information. Displays information about the host that the Conductor is running on.

Create Event List. Allows users to create an event list by entering a specified field.

HP Network Node Manager. Accesses HP OpenView on a specified host.

Cisco View. Launches the Cisco View tool, which manages BPX, IGX, and MGX switches.

MainOVMenu

Tools menu on the objective view main window.

SubEventListMenu: Tools

Tools menu on any window of displayed alerts. Lists the CWM Desktop tool, which starts the Cisco WAN Manager desktop on a specified host.

MapPageOVMenu

Tools menu on any open objective view map page and the Unplaced Events window.

SymbolToolsMenu

Tools menu on right click on an objective view symbol.

.

The following sections describe the Cisco tools that are listed on the menus described in Table 3-2.

Cisco Wan Manager CiscoView Tool

This tool displays the 4.11 CiscoView tool that manages Switch Software releases BPX 8600 8.4/8.5/9.1, IGX 8400 8.5/9.1, and MGX 8220 4.1.

This tool is available only for events reported by the BPX 8600, IGX 8400, and MGX 8220 4.0.15 NEType network elements and runs on the Cisco Wan Manager (CWM) machine. This CWM machine and to display to the Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

The variables passed to the CWM Equipment Manager tool are:

$DISPLAY
@NEAddress

Administration GUI

This tool uses the CWM machine to Telnet to the network element using the IP address in the Event List and displays an Xterm with a Telnet session to the network element.

This tool displays an error message when the network element is not reachable.

This tool uses the External Action in Automations to launch the tool remotely on the
CWM machine and to display to the Cisco Info Admin Desktop. See the"Using Automation to Run Tools" section for more information.

The variables passed to the Administration GUI are:

$DISPLAY
@NEAddress

Get Configuration

This tool displays the configuration of the alarmed resource as stored in the CWM database. The data reported from the Informix OnLine database is dependent upon the value in the ObjectType field. For example, for all card events, (ObjectType = card), the Get Configuration script displays the configuration for the card as stored in the CWM Informix OnLine database.

This tool uses the External Action in Automations to launch the tool remotely on the CWM machine and to display to the Cisco Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

Table 3-3 lists the Informix tables used by the Get Configuration tool.

Table 3-3: Informix Tables Used for Get Configuration

Object Type Informix Table

network element

node

card

card

connection

user_connection

port.ATM

NEType=MGX 8220: ausm_port
NEType=BPX 8600: asi_port

port.FR

SubObjectType=frp: FRP
SubObjectType=ftc: FTC port

line.access

MGX 8220: line
BPX 8600: asi_line
IPX/IGX 8400: circuit_line

line.trunk

MGX 8220: line
IPX/IGX 8400/BPX 8600: packet_line

endpoint.ATM

atm_connection

endpoint.FR

MGX 8220: connection
IPX/IGX 8400: user-connection

endpoint.CE

user_connection

endpoint.VoiceData

user_connection

Object Type	Informix Table
network element	node
card	card
connection	user_connection
port.ATM	NEType=MGX 8220: ausm_port NEType=BPX 8600: asi_port
port.FR	SubObjectType=frp: FRP SubObjectType=ftc: FTC port
line.access	MGX 8220: line BPX 8600: asi_line IPX/IGX 8400: circuit_line
line.trunk	MGX 8220: line IPX/IGX 8400/BPX 8600: packet_line
endpoint.ATM	atm_connection
endpoint.FR	MGX 8220: connection IPX/IGX 8400: user-connection
endpoint.CE	user_connection
endpoint.VoiceData	user_connection

The variables passed to the Get Configuration tool are:

$DISPLAY
@ObjectType
@NEType
@NEName
@Slot
@PSAP
@LSAP
@DSAP

Real Time Counters

This tool is useful for diagnosing resources that are in an alarm state. For example, for a port alarm, this tool can launch either an SNMP grapher or an ASCII display that shows the real time counters for frames/cells transmitted and received on that port, to verify that indeed, the port is not passing traffic.

The Real Time Counters tool launches a GUI that allows you to pick a list of the counters you would like to monitor. The list is dynamically created based on the value in the ServiceType field. This selection tool provides you with the option to pick an interval for launching the polls to the network element and the display mechanism, grapher or textual.

This tool uses the External Action in Automations to launch the tool remotely on the CWM machine and to display to the Cisco Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

The variables passed to the Real Time Counters tool are:

$DISPLAY
@NEName
@Slot
@NEType
@ServiceType
@ObjectType
@PSAP
@LSAP
@DSAP
@NEAddress

Test Delay

The Test Delay tool uses the ConnProxy SNMP Agent on the CWM machine to check the delay for a connection. This tool sends an SNMP request to determine the delay for a connection and displays the time taken for the delay on the Cisco Info Admin Desktop.

This tool uses the External Action in Automations to launch the tool remotely on the
CWM machine and to display to the Cisco Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

The variables passed to the Test Delay tool are:

$DISPLAY
$Proxy - ConProxy Agent
@NEType
@Node
@NEName
@Slot
@PSAP
@LSAP
@DSAP
@ObjectType
@ServiceType
Delay (Conn|Delay)

Test Connection

The Test Connection tool uses the ConnProxy SNMP agent on the CWM machine to test the connectivity for a connection. This tools send an SNMP request to determine the status of the connection and displays the result of the test on the Cisco Info Admin Desktop.

This tool uses the External Action in Automations to launch the tool remotely on the CWM machine and to display to the Cisco Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

The variables passed to the Test Connection tool are:

$DISPLAY
$Proxy - ConProxy Agent
@NEType
@Node
@NEName
@Slot
@PSAP
@LSAP
@DSAP
@ObjectType
@ServiceType
Delay (Conn|Delay)

Add Loopback

The Add Loopback script provides a mechanism for you to add a soft loopback on the network element port. This tool is very useful in trouble shooting problems with connectivity. This tool prompts you for a user name and password for the CWM machine, followed by the user name and password for the network element.

The tool performs the loopback addition by logging into the CWM machine using the user name and password provided above, and then logging into the network element from the CWM machine and sending the appropriate Add Loopback Command. An Xterm window is displayed on the Cisco Info Admin Desktop machine from where the tool is launched, indicating the progress of this tool.

This tool is run in two parts. The Cisco Info Admin Desktop launches the tool loopback.desktop in the $OMNIHOME/utils/loopback/loopback.desktop script. This script performs an nco_sql insert into the Cisco Info Server, which in turn, executes the loopback.server script.

This tool uses the External Action in Automations to launch the tool remotely on the CWM machine and to display to the Cisco Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

Table 3-4 lists the commands used to add loopback

Table 3-4: Commands to Add Loopback

ObjectType NEType Command Parameters

Port.ATM, Port.FR

IPX,IGX 8400,BPX 8600

addlp

@Slot, @PSAP

Connection

IPX,IGX 8400,BPX 8600

addlocrmptlp

@Slot, @PSAP, @DSAP

Endpoint Connection

BPX 8600

addlocl

@Slot, @PSAP, @DSAP

Endpoint Connection

IPX/IGX 8400

addlocl

@Slot, $Port, @DSAP

Endpoint Connection

MGX 8220

addchanloop

Channel number, returned from query into Informix database.

Port.CE

MGX 8220

addlp

@Slot, @PSAP

Port.VoiceData

Not applicable

Not applicable

Not applicable

ObjectType	NEType	Command	Parameters
Port.ATM, Port.FR	IPX,IGX 8400,BPX 8600	addlp	@Slot, @PSAP
Connection	IPX,IGX 8400,BPX 8600	addlocrmptlp	@Slot, @PSAP, @DSAP
Endpoint Connection	BPX 8600	addlocl	@Slot, @PSAP, @DSAP
Endpoint Connection	IPX/IGX 8400	addlocl	@Slot, $Port, @DSAP
Endpoint Connection	MGX 8220	addchanloop	Channel number, returned from query into Informix database.
Port.CE	MGX 8220	addlp	@Slot, @PSAP
Port.VoiceData	Not applicable	Not applicable	Not applicable

Table 3-5 lists the variables passed to the Add Loopback tool.

Table 3-5: Variables Passed to the Add Loopback Tool

Parameters

<Cisco Info Server Name>

<Cisco Info Server User Name>

<Cisco Info Server Password>

$DISPLAY

<CWM+ Host Name>

<CWM+ User ID>

<CWM+ Password>

@ObjectType

@ServiceType

@NEType

@NEName

@NEAddress

<network element Login ID>

<network element Login Password>

@Slot

@PSAP

@LSAP

@DSAP

<Type> (Add|Del)

Loopback Command

Parameters
<Cisco Info Server Name>
<Cisco Info Server User Name>
<Cisco Info Server Password>
$DISPLAY
<CWM+ Host Name>
<CWM+ User ID>
<CWM+ Password>
@ObjectType
@ServiceType
@NEType
@NEName
@NEAddress
<network element Login ID>
<network element Login Password>
@Slot
@PSAP
@LSAP
@DSAP
<Type> (Add\|Del)
Loopback Command

Delete Loopback

The Delete Loopback script provides a mechanism for you to delete a soft loopback that may have been added on the network element port. This tool is very useful in trouble shooting problems with connectivity. This tool prompts you for a user name and password for the CWM machine, followed by the user name and password for the network element.

The tool performs the loopback deletion by logging into the CWM machine using the user name and password provided above, and then logging into the network element from the CWM machine and sending the appropriate Delete Loopback command. An Xterm window is displayed on the Cisco Info Admin Desktop machine from where the tool is launched, indicating the progress of this tool.

This tool uses the External Action in Automations to launch the tool remotely on the
CWM machine and to display to the Cisco Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

Table 3-6 lists the commands used to delete a loopback.

Table 3-6: Commands to Delete Loopback

ObjectType NEType Command Parameters

Port.ATM, Port.FR

IPX, IGX 8400, BPX 8600

dellp

@Slot, @PSAP

Endpoint Connection

BPX 8600

dellp

@Slot, @PSAP, @DSAP

Endpoint Connection

IPX/IGX 8400

dellp

@Slot, $Port, @DSAP

Endpoint Connection

MGX 8220

delchanloop

Channel number, returned from query into Informix database.

Port.CE

MGX 8220

dellp

@Slot, @PSAP

Port.VoiceData

Not applicable

Not applicable

Not applicable

ObjectType	NEType	Command	Parameters
Port.ATM, Port.FR	IPX, IGX 8400, BPX 8600	dellp	@Slot, @PSAP
Endpoint Connection	BPX 8600	dellp	@Slot, @PSAP, @DSAP
Endpoint Connection	IPX/IGX 8400	dellp	@Slot, $Port, @DSAP
Endpoint Connection	MGX 8220	delchanloop	Channel number, returned from query into Informix database.
Port.CE	MGX 8220	dellp	@Slot, @PSAP
Port.VoiceData	Not applicable	Not applicable	Not applicable

Table 3-7 lists the variables passed to the Delete Loopback tool.

Table 3-7: Variables Passed to the Delete Loopback Tool

Parameters

<Cisco Info Server Name>

<Cisco Info Server User Name>

<Cisco Info Server Password>

$DISPLAY

<CWM+ Host Name>

<CWM+ User ID>

<CWM+ Password>

@ObjectType

@ServiceType

@NEType

@NEName

@NEAddress

<network element Login ID>

<network element Login Password>

@Slot

@PSAP

@LSAP

@DSAP

<Type> (Add|Del)

Loopback command

Parameters
<Cisco Info Server Name>
<Cisco Info Server User Name>
<Cisco Info Server Password>
$DISPLAY
<CWM+ Host Name>
<CWM+ User ID>
<CWM+ Password>
@ObjectType
@ServiceType
@NEType
@NEName
@NEAddress
<network element Login ID>
<network element Login Password>
@Slot
@PSAP
@LSAP
@DSAP
<Type> (Add\|Del)
Loopback command

Decode BitMap

This tool provides you the ability to decode the bitmap that is sent as an SNMP VarBind from the network element and received by the Cisco Info Mediators. The value stored in the BitMap field is dependent upon the trap. For example, for some traps, the BitMap field contains values indicating the status of the trap, while for other traps, it contains the starting DS0 port.

The tool converts the value stored in the BitMap by using the contents of the Convert field, which stores a pointer to an external lookup file. Upon conversion, this tool displays the converted values with the set bit positions on the Cisco Info Admin Desktop screen.

This tool uses the External Action in Automations to launch the tool remotely on the Cisco Info Server machine and to display to the Info Admin Desktop. See the "Using Automation to Run Tools" section for more information.

The variables passed to the Decode BitMap Tool are:

$DISPLAY
@BitMapField
@Convert

Create Event List

The Create Event List tool, available from the Tools and Main Event List Tools menus, provides a quick way of creating filtered Event Lists based on any single fields in the Cisco Info Server, by prompting for the field name.

For example, to create a filtered Event List with monitor boxes for all ObjectTypes present in the Cisco Info Server alerts table, specify the field name ObjectType when prompted with:

Pick Database Field

This tool runs on the Cisco Info Admin Desktop and creates an Event List configuration with monitor boxes for all ObjectTypes named by_ObjectType.elc in the user's Personal Library. See the Cisco Info Center User Guide for more information.

Cisco Info Admin Desktop Information

The Cisco Info Admin Desktop Information tool provides you with information regarding the Cisco Info Admin Desktop. This tool is available from the Main Event List Tools menu.

This tools runs on the Cisco Info Admin Desktop and provides the following information:

Info Center User - user name logged into the Cisco Info Server
Cisco Info Server - name of Cisco Info Server connected to
License Servers - indicates where the Cisco Info Admin Desktop is getting the license
UNIX User - UNIX user that started the Conductor
Internal X Display - X display set by the Conductor
External X Display - X display as set in shell that executed the Conductor
Calculated Display - X display where the tools send the display
UNIX Host Info - architecture, operating system, and name of the UNIX host
Info Center version and patch information.

HP OpenView Network Node Manager

This tool launches the HP OpenView Network Node Manager application from the CWM machine onto the Cisco Info Admin Desktop. This tool is available from the Main Event List Tools menu. The $DISPLAY variable is passed to the HP OpenView Network Node Manager.

This tool uses the External Action in Automations to launch the tool remotely on the CWM machine and to display to the Cisco Info Admin Desktop. See Section, "Using Automation to Run Tools", for more information.

Cisco WAN Manager Desktop

This tool launches the CWM Desktop from the CWM machine onto the Cisco Info Admin Desktop. This tool is available from the Sub Event List Tools menu. The $DISPLAY variable is passed to the CWM Desktop Tool.

Note Each display can only invoke one Desktop.

This tool uses the External Action in Automations to launch the tool remotely on the CWM machine and to display to the Cisco Info Admin Desktop. See the "Using Automation to Run Tools" section, for more information.

Using Automation to Run Tools

Tools, by default, run on the local Desktop, that is, the server running the Desktop. As Cisco Info Center is designed to be a client/server application, it is necessary to install the application in the tool to be installed, and configure it on every client Desktop. As this is difficult to administer, the remote launching of tools has been configured using Automation so as to centralize the management of these tools.

The tool is normally configured to run on every Cisco Info Admin Desktop, using the command:

host% xterm -e telnet @NEAddress

This launches Xterm locally, and within the Xterm, spawns the Telnet session.

While the xterm and telnet commands (and applications) are available on all X sessions running client/server, there is no guarantee of a route from the Desktop to the network elements. There may be security constraints in adding these routes, and as a result, this tool has been configured to run on the CWM machine using Automation, with the results displayed back to the Desktop that had originated the request.

This process works by the Desktop adding an Automation in the auto.triggers and auto.actions tables. The auto.actions for each event performs a data effect and an external effect. See , "Automation," for more information.

Data effect deletes the trigger and the action, as the external action would have already been passed to the Process Control on the host specified in the external effect host parameter.

External effect queues the external action, passed as a parameter from the tool executed from the Event List to the Process Control specified in the external effect host parameter. One of the arguments passed is the DISPLAY variable, which provides the executable on the host to run the application and display the results back to the DISPLAY variable.

Mandatory requirements for launching processes using Automation are:

1. The DISPLAY variable must always be passed.

2. Process Control must always be configured and running on the application server.

3. Process Control record must be configured on the Cisco Info Server host when the application servers are different than the Cisco Info Server host.

Menu Management

This section describes how to create, copy, rename and delete sub-menu entries.

Creating a Submenu

To create a new submenu, complete these steps:

Step 1 Do one of the following:

Select New Sub-Menu from the Menu menu.
Right click on the list to display the popup menu, then select New Sub Menu.
Click on the New Menu Item button (shown in the left margin) and select New Sub-Menu from the popup menu:

The New Sub-Menu window appears

Step 2 Enter a submenu name and click OK.

If the name already exists, you are prompted to enter an alternative name.

Once the window has closed, a new sub-menu entry appears below the parent menu. The sub-menu does not yet contain any tools.

Deleting a Submenu

To delete a submenu, complete these steps:

Step 1 Select the sub-menu on the Menus tab.

Step 2 Do one of the following:

Select Delete from the Menu menu.
Right click on the list to display the popup menu, then select Delete.
Click on the Delete Menu Item button:

The submenu is removed from the list.

Note You cannot delete default menus.

Copying or Moving a Submenu

To copy a submenu, complete these steps:

Step 1 Select the sub-menu from the Menus tab.

Step 2 Do one of the following:

Select Copy from the Menu menu.
Right click in the list to display the popup menu, then select Copy.

Step 3 To paste the sub-menu, select the destination menu and do one of the following:

Select Paste from the Menu menu.
Right click on the list to display the popup menu, then select Paste.

Note You can move the submenu by cutting it, using the Cut option, instead of copying it.

Renaming a Submenu

To rename a submenu, complete these steps:

Step 1 Select the submenu from the Menus tab.

Step 2 Do one of the following:

Select Rename from the Configuration Manager window menu.
Right click on the list to display the popup menu, then select Rename.

Step 3 The Rename Menu Label window appears.

Step 4 In the Name field, enter the new name for the submenu.

Step 5 Click OK.

When the window closes, the submenu name is updated.

Tool Management

You can control how the menus are populated, change the order of items in a menu, filter the tools displayed, and test the menu display. All tools are linked to entries in the Info Server tools database.

When you add a new tool to a menu, you create a new tool in the tools database. An entry for this tool automatically appears in the Tools window, if open, and in the selected menu.

When you create a new tool in the Tools window, no entry appears in a menu.

When you modify a tool, the change is made to the entry in the tools database. The modification affects the entries in the Menus tab and the entries in the Tools window that are linked to this modified tool.

The Tools window contains the master version of each tool. Menu items are links to the tool.

Icons Assigned to Menu Items

Tools that appear as menu items on the Menus tab of the Configuration Manager window are automatically assigned an icon based on the enable status of the tool.

Table 3-8 shows the icons that can be assigned to a menu item.

Table 3-8: Icon s in Tool List

Icon Description

Enabled Tools.
Color red.

Disabled Tools.
Color gray.

The broken icon represents an item which is linked to a tool which does not exist in the tools.actions table.

Icon	Description
	Enabled Tools. Color red.
	Disabled Tools. Color gray.
	The broken icon represents an item which is linked to a tool which does not exist in the tools.actions table.

Creating a New Tool from the Menus Tab

When you create a tool using options from the Menus tab, the tool is added to the tools database. In addition, the tool appears in the selected menu and in the Tools window if open.

To add a tool to a menu or sub-menu, complete these steps:

Step 1 Select the menu or sub-menu.

Step 2 Do one of the following:

Select New Tool from the Menu menu and then select New.
Right click in the list to display the popup menu, then select New Tool and New.
Click on the New Menu Item button:

The New Tool window appears.

For details on the use of the New Tool window see the "Creating and Editing Tools" section.

Adding an Existing Tool to a Menu

To add an existing tool to a menu, complete these steps:

Step 1 Select a menu.

Step 2 Do one of the following:

Select New Tool from the Menu menu.
Right click on the Menus tab and then select New Tool from the popupmenu.

Click on the New Menu Item button
and then select New Tool from the popup menu that appears.

: A popup list appears. This list shows the available tools.

Step 3 Select a tool from the list of tool names.

The new tool appears in the list of items under the menu.

Changing the Tool Label in the Menu

The tool entry in the menu consists of the tool name, which refers to the tool in the tools database, and a label that appears in the menu.

To change the label for a tool, complete these steps:

Step 1 Select the tool on the Menus tab.

Step 2 Do one of the following:

Right-click on the tool and select Rename from the popup menu.
Select Rename from the Configuration Manager Menu menu.

The Rename Menu Label window appears.

Step 3 Enter the new name for the menu label and click OK.

The Menus tab displays the new name for the tool.

Editing Tools from the Menus Tab

To edit a tool, complete these steps:

Step 1 On the Menus tab. select the tool to be edited.

Step 2 Do one of the following:

Right click on the tool and select Edit from the popup menu.
Select Edit from the Menu menu.
Click on the Edit Menu Item button:

The Edit Tool window appears.

For information on using the Edit Tool window see the "Creating and Editing Tools" section.

Deleting Tools from a Menu

When you delete a tool from a menu, only the menu entry is removed. The tool remains in the database. The tool also remains in the Tools window, and in any other menu in which it appears.

To delete a tool, complete these steps:

Step 1 Select the tool on the Menus tab.

Step 2 Do one of the following:

Select Delete from the Menu menu.
Right click on the tool and select Delete from the popup menu.
Click on the Delete Menu Item button:

You are prompted to delete the selected tool.

Step 3 If you are sure that you want to delete the tool, click OK; otherwise click Cancel.

The tool is removed from the listing on the Menus tab.

Adding a Separator

You can add a horizonal line that separates menu items. To add a separator to a menu, complete these steps:

Step 1 Select the menu to which you want to add a separator.

Step 2 Do one of the following:

Select New Separator from the Menu menu.
Right click in the Menus tab and then select the New Separator icon.
Click on the New Menu Item button and select New Separator from the popup menu.

A separator appears at the bottom of the menu. You can change the position of the separator by using the reposition buttons. For information on the reposition buttons, see the "Arranging Items in a Menu" section.

Arranging Items in a Menu

To rearrange the order of the tools, the separators, or submenus, select the item to be moved and then click on one of the reposition buttons in the toolbar. Table 3-9 shows the buttons that you can use to reposition the menu items.

Table 3-9: Reposition Buttons

Button Description

Move item up one position

Move item down one position

Move item to top

Move item to bottom

Button	Description
	Move item up one position
	Move item down one position
	Move item to top
	Move item to bottom

The window is refreshed automatically with the item in its new position.

Filtering Views

You must assign class access and group access to each tool. For detailed information on assigning access to tools, see the "Tool Window Access Tab" section.

The Configuration Manager window toolbar includes two filter drop down lists. The first list allows you to select a group. The default entry is (All Groups). The second list allows you to select a class. The default entry is (All Classes).

When the filters are changed from these default options, the text is grayed on any tool that does not match the filter. This shows the menu items that are available for use when the specified group or class does not apply to the alert with which the tool is associated.

Testing Menus

You can test menus by clicking on the Test button:

When you choose the Test button, the selected menu appears as a popup menu.

Not all menu items in the Menus tab are displayed. The class or group filter in use affects the menu as follows:

When a user group filter has been applied, any tool not enabled for the selected group does not appear in the test menu.
When a class filter is applied, any tool not enabled for the selected class appears in gray. Tools which are disabled also appear in gray.

Broken tools do not appear in the menu. Tools that appear in the test menu do not run when selected.

Tools Window

To open the Tools window, click on the Tools Window button:

The Tools window displays all available tools in the left hand column. The other columns show whether the tool has been enabled to do the following:

Start an internal effect. For more information, see the "New Tools Window SQL Tab" section.
Start an external effect. For more information, see the "Tool Window Executable Tab" section.
Force a journal entry for an alert. For more information, see the "Tool Window Journal Tab" section.

Tools that are disabled appear in gray.

Figure 3-9 shows an example of the Tools window.

Figure 3-9: The Tools Window

Creating a Copy of a Tool

To copy a tool, complete these steps:

Step 1 Select the tool on the Tools window.

Step 2 Do one of the following:

Select Copy from the Tool menu.
Click on the Copy button:
Right click on the list to display the popup menu, then select Copy.

The new tool is added, named Copy of toolname where toolname is the source tool. You do not need to paste it.

The content of the new tool is identical to the source tool. You can now edit the new tool and add it to menus as required.

Editing Tools

To edit an existing tool, select the tool and then do one of the following:

Select Edit from the Tool menu.
Right click anywhere in the Tools window and select Edit from the popup menu.
Click on the Edit Tool button:

For details on the use of the Edit Tool window see the "Creating and Editing Tools" section.

Creating New Tools

To create a tool, do one of the following:

Select New from the Tool menu.
Right click anywhere in the Tools window and select New from the popup menu.
Click on the New Tool button:

For details on the use of the New Tool window, see the "Creating and Editing Tools" section.

Deleting Tools

To delete a tool, do one of the following:

Highlight the tool and press the Delete key on the keyboard.
Select Delete from the Tool menu.
Right click anywhere in the Tools window and select Delete from the popup menu.
Click on the Delete Tool button:

The tool selected is deleted from the Tools window, from the tools database and from every menu which uses the tool.

Creating and Editing Tools

The New Tool and Edit Tool windows are identical except that you cannot modify the Name field in the Edit Tool window. It appears in gray.

This section describes the New Tool window. You can also refer to it when editing tools.

The New Tool window is divided into five areas. Each is assigned a tab. These tabs are:

SQL
Executable
Journal
Access
Description

Figure 3-10 shows an example New Tool window with the SQL tab selected.

Figure 3-10: New Tool Window---SQL Tab

The Name field appears above every tab in the New Tool window. Enter a unique name for the new tool.

The Enable button appears above every tab in the New Tool window. Tools are not available on the Menus tab until they are enabled and the window is closed.

There are separate enable buttons for the SQL command, the executable command and the forced journal entry.

Click OK to close the New Tool window and update the tools.actions table. If SQL has been enabled, the SQL statement is checked. If any errors are found the window remains open until they have been corrected.

New Tools Window SQL Tab

By default, the New Tools window is opened with the SQL tab displayed. Figure 3-10 shows an example of the SQL tab.

Type the SQL text or build the SQL statement using the tools provided by the buttons on the right of the frame. The SQL statement appears in the main frame of the SQL tab.

Enabled

Click this button to enable the SQL effect.

Execute for all Selected Rows

When this button is enabled, the tool is executed once for each row in an event list row selection.

A tool can also be executed for each selected row using an expansion tab. Enter the expansion tab $selected_rows.field, where field is the database table field to be selected.

When the tool is executed the expansion tab expands to a string of comma separated values. The string is populated by values from the specified field of each selected row in the event list.

The expansion keyword must not be used with the Execute for All Selected Rows button enabled.

SQL Button

When you click on the SQL Statement Builder button

a popup list appears that contains the following SQL commands:

Delete
Insert
Select
Service Update
Sync
Update
Use

Click on one of these options to open the associated window.

Delete

The delete statement requires a database name and a table name. Enter the details in this window and select the OK button.

Insert

The insert statement requires a database name, a table name, and entries for all of the fields in the specified table. When the table is selected, the lower frame changes to show a list of every field name in the selected table. If you do not complete a field, the default value is used. Default values are:

0 for integers
An empty string for varchar and char fields
The current time for time fields

Figure 3-11 shows an example SQL Insert window.

Figure 3-11: SQL Insert Window

Select

The select statement requires a database name, a table name and a list of fields from the table for selection. When you choose a select statement, the Select window appears. Figure 3-12 shows an example Select window.

Figure 3-12: SQL Select Window

Use the arrows to move fields in the Available Fields list to the Selected Fields list, or to remove them from the Selected Fields list. Table 3-10 describes the function of each of these buttons.

Table 3-10: Field Selection Buttons

Button Description

Copy all fields to the Selected list.

Remove all fields from the Selected list.

Copy selected fields to the Selected list.

Remove selected fields from the Selected list.

Button	Description
	Copy all fields to the Selected list.
	Remove all fields from the Selected list.
	Copy selected fields to the Selected list.
	Remove selected fields from the Selected list.

Service Update

The service update statement requires a service name and a value. The value can be selected from the options in the drop down list. Values can be Good, Marginal or Poor.

Sync

If you select the Sync option, the Sync window appears. In the Sync window, first select either Database or Table. If Database is selected, enter only the database name. If Table is selected, enter the database and table names.

Update

If you select the Update option, the Update window appears, shown in Figure 3-13. The Update window allows you to create an SQL expression, edit an existing expression, or delete an expression.

Figure 3-13: SQL Update Window

To update an expression, complete these steps:

Step 1 From the New Tool menu, select the SQL Icon and then select Update from the pull-down menu.

The Update window appears.

Step 2 Select a database name from the drop down list.

Step 3 Select a table name from the drop down list.

Step 4 Click the New button.

The Edit Expression window appears. Figure 3-14 shows an example of an Edit Expression window.

Figure 3-14: Edit Expression

You use the Edit Expression window to edit and create value and prompt expressions. The next two sections describe how to do this.

Creating or Editing a Prompt Expression

To create or edit a prompt expression, complete these steps:

Step 1 Select the Prompt radio button.

Step 2 Select a field name from the drop down list.

Step 3 Select a prompt name from the drop down list.

Step 4 Do one of the following.

To edit an existing expression, select the the Edit button.
To delete an existing expression, select the Delete button.
To create a new expression, select the New button.

If you select the New... button, the New Prompt window appears. For information on this window, see the "Prompt Definitions" section.

Creating or Editing a Value Expression

To create or edit a value expression, complete these steps:

Step 1 Select the Value radio button.

Step 2 Select the field name from the drop down list.

Step 3 Enter a default value in the Value field.

The Value field only allows you to enter values that match the field type.

Use

The use statement specifies the database name to use in the SQL statement.

Column Names

To open a list of available field names in the alerts.status table, click on the Column Names button:

Click on a column name to add the name to the SQL statement.

The column name is substituted for the corresponding event list row value when the tool is executed.

Column names appear in the SQL script as the expansion keyword @name, where name is the name of the selected field.

Conversion Names

To open a list of available conversions, click on the Conversion Names button:

When an option is selected it opens a popup window showing the list of conversions. Select a conversion name from the list.

Internal Value Names

To open a list of Internal Values, click on the Internal button:

Table 3-11 lists and describes the internal values.

Table 3-11: Internal Values Description

Internal Value Description

display

The current display running the application.

password

The password of the user running the application.

server

The name of the Info Server to which the tool is currently connected.

UID

The user identifier of the user running the application.

username

The username of the user running the application.

Internal Value	Description
display	The current display running the application.
password	The password of the user running the application.
server	The name of the Info Server to which the tool is currently connected.
UID	The user identifier of the user running the application.
username	The username of the user running the application.

Internal values appear in the SQL script as an expansion keyword %name, where name is the name of the internal value.

Prompt Names

To add a prompt name,. click on the Prompt Names button and select a prompt from the list of prompt names in the popup list:

Prompts appear in the SQL script as the expansion keyword $prompt.name, where name is the name of the prompt.

Filter Builder

To open the Filter Builder window, click on the Start Filter Builder button:

See theCisco Info Center User Guide for details on the Filter Builder window.

Tool Window Executable Tab

You use the Executable tab to create external executable commands for a tool.

Figure 3-15 shows an example of an Executable tab on a New Tool window. The Platform frame in the lower part of the tab and the selection arrows to the right of the Platform frame allow you to specify which platform(s) the tool can function on.

Figure 3-15: New Tool - Executable Tab

Click the Enabled button to enable the executable action.