3.12 Event Acquisition Settings window

The Event Acquisition Settings window is used to set the event acquisition filter conditions (the conditions for acquiring events from the event service).

Any of the following operations displays the Event Acquisition Settings window:

In the System Environment Settings window, the user uses the Event acquisition conditions drop-down list to select an event acquisition filter, and then clicks the Configure button.
In the Event Acquisition Conditions List window, the user selects a filter in the list, and then clicks the Edit button.
In the Event Acquisition Conditions List window, the user clicks Add.
In the Event Acquisition Conditions List window, the user selects and double-clicks a filter in the list.

Note that a user must have JP1_Console_Admin permission to display the Event Acquisition Settings window. If the function for restricting reference permissions and operation permissions is enabled for business groups, this operation might not be performed depending on the combination of the JP1 resource group and permission level. For details, see 4.1.4(2) Assigning a JP1 resource group and permission level to a JP1 user in the JP1/Integrated Management 2 - Manager Overview and System Design Guide.

When the user sets filter conditions and clicks the OK button in this window, the filter conditions are converted into a filter condition statement. The statement takes effect when Apply is clicked in the System Environment Settings window. The maximum length of the event acquisition filter is 64 KB when exclusion-conditions groups have been set. When they have not been set, the maximum length is 60 KB. If the event acquisition filter is longer than the maximum length, an error dialog box displaying the message KAVB0246-E appears when the OK button is clicked. If the error dialog box appears, the filter condition settings must be reviewed. For details about how to estimate the length of a filter condition statement, see the Release Notes for JP1/IM - View.

If no conditions (items under Conditions) have been specified for one or more of the pass-conditions groups set in this window, all JP1 events will be displayed (acquired). On the other hand, if no conditions (items under Conditions) have been specified for one or more of the exclusion-conditions groups set in this window, no JP1 events will be displayed (acquired). At least one condition must be specified for each condition group in order to filter events.

If JP1/IM - Manager on the connected host uses an event acquisition filter in Compatible mode, the Event Acquisition Settings (for compatibility) window appears instead of the Event Acquisition Settings window.

For acquiring events for which specific severity level has been defined and JP1/SES events

For the Event Acquisition Settings (for compatibility) window, a filter for acquiring the following types of events can be created at one time, for the Event Acquisition Settings window, multiple condition groups are needed:

To acquire both Error-level events and JP1/SES events, the user sets condition groups as follows:

To acquire Error-level events, the user creates Condition group 1, and then in the Event level area, selects the Specify the severity radio button and the Error check box.
To acquire JP1/SES events, the user creates Condition group 2, and then in the Event level area, selects the JP1/SES events radio button.

The following figure shows an example of the Event Acquisition Settings window.

Figure 3‒28: Event Acquisition Settings window

The following describes the items displayed in the Event Acquisition Settings window.

Filter name

If an event acquisition filter is being added, the user enters the name of the filter in this text box.

Any characters other than control characters can be used. A character string from 1 to 50 bytes can be specified.

If an event acquisition filter is being edited, the name of the filter selected from the list of filters is displayed. If the user renames the event acquisition filter, the new name is displayed. Note that a new filter is not created with the new name.

The same filter name cannot be assigned to multiple filters.

Space characters before and after a filter name are recognized as part of the name. Therefore, filter names that either begin or end with a space, that neither begin nor end with a space, and that both begin and end with a space are different despite identical filter names.

Filter ID

The user selects the filter ID of an event acquisition filter from the drop-down list.

If a new event acquisition filter is being added, an unused filter ID in the event acquisition filter list is automatically assigned in ascending order.

If an event acquisition filter is being edited, the filter ID selected from the list of filters is displayed in the text box. If the user changes the ID of the event acquisition filter, the new ID is displayed. Note, however, that a new filter has not been created with the new ID.

The same filter ID cannot be assigned to multiple filters.

Show List (or Hide List)

Clicking the Show List button displays the list of condition groups. When the list is displayed, the button changes to the Hide List button, which, if clicked, hides the list.

Pass-conditions groups

This area displays the pass-conditions groups. If the user selects a condition group from the list, the name of the selected group is displayed in the Condition group name area, and the condition settings are displayed in the Conditions area. The user can edit these condition settings.

A maximum of 30 condition groups can be set. When 30 condition groups have been specified, the Add and Copy buttons are disabled.

Exclusion-conditions groups

This area displays the exclusion-conditions groups. If the user selects a condition group from the list, the name of the selected group is displayed in the Condition group name area, and the condition settings are displayed in the Conditions area. The user can edit these condition settings.

A maximum of 30 condition groups can be set. When 30 condition groups have been specified, the Add and Copy buttons are disabled.

Add

Clicking this button adds a new condition group. For pass-conditions groups, the default name Condition group n (n is a number) is assigned to the new pass-conditions group that is added. For exclusion-conditions groups, the default name Exclusion-condition group n (n is a number) is assigned to the new exclusion-conditions group that is added. Each time a new condition group is added, the focus moves to the text box in the Condition group name area so that the user can assign a name.

Copy

Clicking this button copies the selected condition group. When the user selects a condition group and clicks this button, a new condition group in which the same conditions as those defined in the selected condition group is created. The new condition group that is created is assigned the default name Copy original-condition-group-name, and is added to the list of condition groups. After creating a copy of a condition group, if the user creates another copy of the same condition group, a number is added after the string Copy in CopyN original-condition-group-name (N is a number). The first number used is 2, which is incremented each time the same condition group is copied. Note that, each time a new condition group is added to the list, the focus moves to the text box in the Condition group name area so that the user can assign a name.

Delete

Clicking this button deletes the selected condition group. When this button is clicked, a message dialog box displaying the following message appears:

KAVB0257-I

Clicking the Yes button in the message dialog box deletes the selected condition group.

Condition group name

This box is used to specify the name of a condition group. Any characters other than control characters can be used. A character string from 1 to 50 bytes can be specified.

If the user selects a condition group that already appears in the Pass-conditions groups or Exclusion-conditions group area and specifies a new name, the condition group is renamed. The same name cannot be specified for a pass-conditions group and an exclusion-conditions group.

If the user attempts to specify a condition group name that already appears in the Pass-conditions groups or Exclusion-conditions group area, a dialog box displaying the following message appears:

KAVB0256-E The specified condition group name already exists.

Clear

Clicking this button clears all condition settings displayed under Conditions.

Read From Selected Event

Clicking this button applies the attribute values of the JP1 event selected in the Event Console window to the corresponding items under Conditions. The following describes how the attribute values are applied:

When an event attribute value includes a control character (such as a linefeed or tab character)

The part before the first control character is applied. If an option condition can be specified for the event attribute, First characters is selected.
When an event attribute value does not include a control character

The entire event attribute value is applied. If an option condition can be specified for the event attribute, Match is selected.

If the information of the selected JP1 event is mapped in the Event-Information Mapping Definitions window, the attribute values for the display items and program-specific extended attribute values that have been mapped are not applied. For details about the Event-Information Mapping Definitions window, see 6.9.2 Displaying extended attributes of JP1 events (mapping of event information) in the JP1/Integrated Management 2 - Manager Administration Guide.

Source host

Specifies the name of a host (event server name) that issues a JP1 event. No business groups can be specified. Multiple host names require a comma as a separator. A maximum of 100 host names can be specified. If a character string that includes a comma (,) or backslash (\) is specified, a backslash (\) must be added before the comma (\,) or backslash (\\). A linefeed or tab character cannot be specified.

Alphabetic characters are case sensitive regardless of the -ignorecasehost option specification of the jcoimdef command.

Event level

Specifies the severity levels of the JP1 events to be acquired.

The user can acquire all events for which a severity level has been defined by selecting the All events for which severity has been defined radio button.

If the user wants to acquire only events for specific severity levels, the user can select the Specify the severity radio button and then select the check boxes for the desired severity levels from Emergency, Alert, Critical, Error, Warning, Notice, Information, and Debug.

If the user wants to acquire JP1/SES events, the user can select the Acquire the JP1/SES events radio button.

Note that if the user enables the function for changing the severity level when the integrated monitoring database is used, the column header is displayed as Original severity level.

[Figure]

Object type

Specifies the object type of a JP1 event. The character string can be typed in the text box or selected from the drop-down list.