Setting Event Viewer widget preferences

To customize the appearance and setup of the Event Viewer widget, edit the widget preferences.

1. Open an Event Viewer widget.
2. Edit your widget preferences, or, as an administrator, edit the widget defaults:
   • To edit your widget preferences, click Page Actions > Personalize Page > Widget > Personalize.
   • To edit the widget defaults of all users, click Page Actions > Edit Page > Widget > Edit.
   Note: The Widget button is enabled after a widget is selected. If Event Viewer is the only widget on the page, you can select the widget by clicking the thin cyan line between the widget pallet and the Event Viewer widget.
3. In the Data tab, set the following preferences:

   Data Provider

   Select a Data Provider as the data source that will expose event data to the Event Viewer.

   Refresh rate (seconds)

   Type the rate, in seconds, at which the Event Viewer retrieves new event data from the data source.

   Minimum refresh rate (seconds)

   Type a minimum refresh time. Event Viewer users cannot specify a refresh rate that is lower than this time. The minimum refresh time can be set only as a widget default for all users, that is, on the Edit shared settings page. The minimum refresh time is useful for ensuring system performance if event volumes are high.

   Show Watch List Filters

   Select this check box to display watch list filters in the Filter list and enable watch list functionality.

   Use CURI mode for events

   By default, this check-box preference is not selected. You can only configure this check-box if the WEBGUI_HOME/etc/server.init file has a property value of eventviewer.data.provider.mode:0.

   • The default behavior is for the Use CURI mode for events preference check-box in the Event Viewer widget to be unselected. This preference selection uses AEL EDS mode to download events from the server for the Event Viewer and the following properties are enabled.
     • ael.top-n.value:-1
     • ael.top-n.mode:0
     • ael.top-n.refresh:0
   • When you select the Use CURI mode for events preference check-box in the Event Viewer widget, you enable CURI mode as the method to download events from the server for the Event Viewer and the following properties are enabled.
     • eventviewer.pagesize.max:20000
     • eventviewer.refresh.mode:0

   If you want to reduce the load on your web browser, enable this check-box preference. If you enable this preference, the following behavior can also display.

   • The browser cache has only a subset of events at one time, which can require extra requests to the server during scrolling.
   • An extra server-side copy of the events for this session and every other CURI mode session exists. This behavior is similar to older architecture.

   Filter

   Select filter that is applied to the Event Viewer when it is opened. Ensure that the filter is associated with the data source that provides the event date to the Event Viewer.

   Filter SQL

   Type the SQL syntax that is used to create a transient filter. When the filter string is applied to an Event Viewer, only the rows that meet the criteria set by the filter are displayed. If any value is typed in this field, the Filter list is disabled.

   Transient filter name

   Type the name to assign to the transient filter generated by the SQL expression in the Filter SQL field. This name is displayed as the title for the associated Event Viewer. If any value is typed in this field, the Filter list is disabled.

   View

   Select a view to apply to the Event Viewer. The view determines the columns that appear in the Event Viewer and overrides any default view that is defined for the filter.

   Data Sources

   Select one or more data sources from which the event data is retrieved. At least one data source must be selected, otherwise an error message is displayed when you click Save.

   If a remote data provider connection to the IBM Tivoli Netcool/Impact product is defined in Dashboard Application Services Hub, you can select the connection from the Data provider list. If you select this connection the Data tab contains the following preferences:

   Data Set

   The collection of data that will be used to display event data in the Event Viewer.

   Report

   The report showing the seasonal or historical events to display in the Event Viewer.

4. In the Appearance tab, set the following preferences:

   Portlet Title

   Type the label to be displayed at the top of the widget.

   Use Customizer

   Select this check box to be able to resize the Event Viewer on a page with multiple widgets by dragging the mouse pointer. If you clear this check box, use the Height field to specify an alternative height in pixels.

   Height

   Set the height of the widget frame in pixels.

   Toolbar Configuration

   Select this check box to display the toolbar in the Event Viewer. You can also display or remove the following individual components on the toolbar:

   • Refresh
   • Freeze
   • Filters and Views
   • Event Summary
   • Preferences
   • Quick Filter

   Menu Bar

   Select this check box to display the menu bar above the toolbar in the Event Viewer.

   Status Bar

   Select this check box to display the status bar below the event list in the Event Viewer. The status bar displays the following information:

   • The total numbers of rows and the number of selected rows.
   • A summary information icon. When clicked this icon displays configuration information about the Event Viewer, such as the data sources, filters, and views.
   • A status message pane displays significant messages to the operator. Click this area to view a history of previous messages.
   • A timer displays the time remaining until the next Event Viewer refresh. Click the timer to pause the countdown, and click it again to refresh the Event Viewer and resume the periodic refresh.
   • Additional status messages are provided via pop-up notifications from the status bar, for example when tools are executed.

5. In the Actions tab, set the following preferences:

   Single-click action

   Select the action to perform when you click an event in the Event Viewer once. You can select default tools to be run on event data. Tools can be created in the Tool Creation editor.

   If no tool is specifically assigned for a single-click action, a default single-click action will be activated in order to send a NodeClickedOn event to any wires that are configured for a page. If another tool is assigned for a single-click action, that tool will run, and automatic sending of a NodeClickedOn event will then not be performed.

   Double-click action

   Select the action to perform when you double-click an event in the Event Viewer. You can select default actions, such as opening the information window for the selected event, or you can select tools to be run on event data. You can create tools in the Tool Creation editor.

6. In the BiDi Settings tab, specify the settings for the display of bidirectional text:

   Component direction

   Select the arrangement of items in the widget, left-to-right, or right-to-left. The default setting uses the value that is defined for the page or the console. If the page and console both use the default setting, the locale of your browser determines the layout.

   Text direction

   Select the direction of text on the widget. The default settings use the value that is defined for the page or the console. If the page and console both use the default setting, the locale of your browser determines the text direction. The Contextual Input setting displays text that you enter in the appropriate direction for your globalization settings.

   Any change that you make to these settings is effective only if you enabled bidirectional support in your user preferences. Changes come into effect the next time you use the widget.

7. Click Save to save and apply the new settings.
8. To restore the default widget settings, click Reset to default settings.