Event Viewer

Table of Contents

Viewing Events from the Event Viewer

You can view all the events generated by the CommCell from the Event Viewer. The Event Viewer window displays the following information about each event.

Column Name Description
Severity Indicates the severity levels of the events, such as Critical, Major, Minor and Information.
Event ID A unique identifier indicating the order in which the events are received by the CommServe. The most recent events are displayed at the beginning of the Event Viewer window.
Job ID A unique identifier for each job.
Date The date and time when the event was generated based on the CommServe time zone.
Program The subsystem that generated the event.
Computer The computer name from which the event was generated.
Event Code The code assigned to the generated event.
Description Detailed description of the event.
  1. From the CommCell Console toolbar, click Event Viewer.
  2. You can view all the generated events in the Event Viewer window.

Changing the Default Event Viewer Display

By default, all the events are displayed in the Event Viewer. However, you can customize the default display using the following ways:

Setting the Severity Levels

By default, the event viewer displays events of all severity levels. Use the following steps to view events with specific severity level:

  1. From the CommCell Console toolbar, click Control Panel.
  2. Under the Tools section, click User Preferences.
  3. Select the Event Filter tab.
  4. Select the severity levels to be displayed.
  5. Click OK to save your changes.

Setting Maximum Number of Events

By default, the event viewer displays a maximum of 200 events. To modify, use the following steps to customize the Event Viewer display:

  1. From the CommCell Console toolbar, click Control Panel.
  2. Under the Tools section, click User Preferences.
  3. Select Event Filter tab.
  4. In the Maximum number of events in Event Viewer box, type or select the maximum number of events to be displayed.
  5. Click OK to save your changes.

Viewing Details of a Specific Event

Use the following steps to view details of a specific event from the Event Viewer:

  1. From the CommCell Console toolbar, click Event Viewer.
  2. Right-click the event and select Detail.
  3. In the Event Details dialog box, the details of the selected event such as Event ID, Severity, Event Code, Job ID, etc. are displayed.

    You can use up and down arrows to view the details of the next and previous events respectively.

  1. Click OK.

Creating a Search Query

You can create a search query to view only selected events from the Event Viewer. You can use the following criteria to create search queries.

By Time Range

You can create search queries to get results which correspond to a particular Time Range.

Use the following steps to create a search query to view events created within a specific time range:

  1. From the CommCell Browser, right-click the CommServe, point to All Tasks and click Event Search.

    Alternatively, you can right-click an event in the Event Viewer and select Search Events.

  2. In the Events Selection dialog box, select Create a search query.
  3. In the View From pane, click Events On and select the starting date and time.

    In the View To pane, click Events On and select the ending date and time.

  4. Click OK.

  5. All Found Events dialog box displays the events filtered from the search query.

By Severity Level

You can create search queries to get results which correspond to the selected Severity levels.

Use the following steps to create a search query to view events with specific severity levels:

  1. From the CommCell Browser, right-click the CommServe, point to All Tasks and click Event Search.

    Alternatively, you can right-click an event in the Event Viewer and select Search Events.

  2. In the Events Selection dialog box, select Create a search query.
  3. Select Severity tab, select Information, Major and Critical.
  4. Click OK.

  5. All Found Events dialog box displays the events filtered from the search query.

By Job ID

You can create a search query to get results which correspond to a particular Job ID.

Use the following steps to create and save a search query to view events generated by a specific job:

  1. From the CommCell Browser, right-click the CommServe, point to All Tasks and click Event Search.

    Alternatively, you can right-click an event in the Event Viewer and select Search Events.

  2. In the Events Selection dialog box, select Create a search query.
  3. Under Job ID tab, select the All events associated with this Job ID checkbox and enter a job ID in the box.
  4. Click OK.

  5. All Found Events Associated with Job ID: <Job ID> dialog box displays the events filtered from the search query.

Saving a Search Query

When you created search queries, you can save it to your local computer and use it later to display events based on the search query. You can save the search queries created based on Time Range and Severity Level. Search queries based on a Job ID cannot be saved.

Use the following steps to save search based on Time Range and Severity:

  1. From the CommCell Browser, right-click the CommServe, point to All Tasks and click Event Search.

    Alternatively, you can right-click an event in the Event Viewer and select Search Events.

  2. In the Events Selection dialog box, select Create a search query.
  3. Under Time Range tab,
    • In the View From pane, select First Event.
    • In the View To pane, select Last Event.
  4. Under Severity tab, select Information, Minor, Major and Critical.
  5. To save the search query, select Save this search query as checkbox and provide a name for the query.
  6. Click OK to save your changes.

  7. All Found Events Associated with Query: <query name> dialog box displays the events filtered from the search query.

Viewing Events Based on a Saved Search Query

Use the following steps to view events based on a saved search query:

  1. From the CommCell Browser, right-click the CommServe, point to All Tasks and click Event Search.

    Alternatively, you can right-click an event in the Event Viewer and select Search Events.

  2. In the Events Selection dialog box, select a saved query from the Select from this search query box.
  3. Click OK.

  4. All Found Events Associated with Query: <query name> dialog box displays the events filtered from the saved search query.

Deleting a Search Query

Use the following steps to delete a saved search query:

  1. From the CommCell Browser, right-click the CommServe, point to All Tasks and click Event Search.

    Alternatively, you can right-click an event in the Event Viewer and select Search Events.

  2. In the Events Selection dialog box, select a saved query from the Select from this search query box.
  3. Click Delete.

Managing Events

The following table describes the available additional options to further refine and view the events from the Event Viewer.

Option Description image
Auto Resize All Columns Auto Resize All Columns option resizes all columns in the selected window to the default size.

To auto resize all columns of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Auto Resize All Columns.

All the windows will be resized automatically.

Horizontal Scroll Horizontal Scroll option resizes all columns to fit the data displayed in the column's fields.

To resize and view all columns in a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Horizontal Scroll.

All the windows will be resized automatically to fit the data displayed in all the column's fields.

Choose Columns Choose Columns option provides the facility to select or deselect columns to be viewed in the selected window.

To resize and view all columns in a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Choose Column and select the columns to be displayed.

All the selected column's will be displayed in the window.

Save Save option saves the status of all entities in the active window to a file. You can choose to save this information in .csv or .xls formats.

To save the contents of a window to a file:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Click Save.

    The Save dialog box is displayed.

  3. Navigate to the folder to which you wish to save the file.
  4. Choose a name and format for the file (if you do not wish to use the default name and format).
  5. Click OK.
Email Email option provides the facility to create a new email message and select a file format in which the component will be attached to the message (.pdf or .xls).

To email the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Email.
  3. Enter one or more email addresses to send the contents of the window to in the SMTP Parameters dialog box.
  4. Modify the SMTP settings, if necessary.
  5. Click OK.
Print Print option prints the status of all entities in the active window.

To print the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Print.
  3. A dialog box with the available printers will appear.

  4. Edit the printing options, if necessary.
  5. Click Print.
Paragraph Paragraph option changes the columns to a paragraph view.

To change to paragraph view:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Paragraph.

Column view of the table changes to paragraph view. To change back to the column view, click Paragraph again.

Find Find option provides space at the bottom of the window in which you can type the entity you wish to find.

To find an entity in a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Find.

    A space to enter the entity you wish to find appears at the bottom of the associated window.

  3. Type the entity you wish to find in the space provided.

If the entity exists in the associated window, it will be highlighted.

Filter Filter option provides the facility to narrow information in the active window down to a specific entity.

To filter the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Filter.

    An arrow will appear in the upper right hand corner of each field in the associated window.

  3. Click on the arrow of each field containing the entities you wish to filter.

    A pull-down menu with all available entities in the associated field is displayed.

  4. Select the entities by which you wish to filter the Event Viewer.

The window is filtered by the entity selected.

Group By Group By option groups entities together based on the column title selected.

To group the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Group By and select the fields to group entities together.

The window is grouped according to the entities selected.

Viewing the Events of a Job from the Job Controller Window

You can view the events associated with a particular job in the Job Controller window.

Use the following steps to view the events of an active job in the Job Controller:

  1. From the CommCell Console ribbon, click the Home tab and then click Job Controller.
  2. Right-click any running job and click View Events.

    All the events associated with the selected job will be displayed.

Viewing the Events of a Job from the Job History Window

You can view the events associated with a particular job in the Job History window.

Use the following steps to view the events occurred for a specific job:

  1. In the CommCell Browser, right-click the appropriate entity and click View | Job History.
  2. Click OK.
  3. From the Job History window, right-click the job and then click View Events.
  4. The All Found Events window appears, displaying all events.
  5. Click Close.

Viewing Existing Alerts for an Event

You can view existing alerts for an event from Alerts dialog box.

Use the following steps to view alerts for an event:

  1. Right-click an event in the Event Viewer and select View Alerts from the shortcut menu.
  2. In the Alerts dialog box, view all the alerts of the selected event.

Adding Alerts for an Event

You can add alerts for an event from Alerts dialog box.

Use the following steps to view alerts for an event:

  1. Right-click an event in the Event Viewer and select Add Alert from the shortcut menu.

    Alternatively, right-click an event in the Event Viewer, select View Alerts from the shortcut menu and then click Add.

  2. In the Add Alert Wizard dialog box, enter a name for the alert in the Display Name box.
  3. Select a Category and Alert Type and click Next.
  4. Select the clients or client groups that you want to associate with this alert and click Next.
  5. Select the notification criteria to be used and click Next.
  6. Select the required notification types and click Next.
  7. Select the notification recipients and click Next.
  8. Click Finish after reviewing the summary.
  9. Click OK.

Setting the Retention Criteria for Events

By default, the event log will retain a maximum of 10000 events that are less than 7 days old. However, you can set the maximum number of events to be retained by the event log. If the number of events exceed the maximum number set or days, then the older events are pruned.

Use the following steps to set retention criteria for events:

  1. From the CommCell Console toolbar, click Control Panel.
  2. Under the Configure section, click System.
  3. In the Keep box, type the number of events to be retained in the event log.
  4. In the And all events less than box, type or select the number of days.
  5. Click OK to save your changes.

Related Reports

Event Report

The Event Report displays a list of events that includes the severity of each event, the time at which the event occurred, the computer on which the event occurred, and a description of the event.

Use the following steps to generate an Event Report:

  1. From the Reports menu in the CommCell Console, click Summary.
  2. In the Report Selection dialog box, click Event under CommServe.
  3. Select suitable options and click Run.

    Event Report appears in your default browser.

For more information, see Event Report.