Job Management Partner 1/Integrated Management - Manager GUI Reference

2.17 Event Search Conditions window

The Event Search Conditions window is used to specify the search conditions for JP1 events. The search results are displayed on the Search Events page of the Event Console window. The Event Search Conditions window is displayed when the user chooses View from the menu bar of the Event Console window and then chooses Search Events. The last search conditions specified in the Event Search Conditions window are saved and displayed when the window is displayed the next time.

When the user specifies search conditions and clicks the OK button, the specified conditions are converted into a filter condition statement that JP1/IM - View uses to perform the search. The maximum length of the filter condition statement is 64 KB. However, when the event service version of the host to be searched is 06-00 or earlier, the maximum length is 4 KB. If the filter condition statement 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.

Restrictions on the search function by JP1/Base versions

If the version of the JP1/Base event service on the host to be searched is 06-51 or earlier, the following searches cannot be performed:
- A Search with Regular expression selected
If the version of the JP1/Base event service on the host to be searched is 06-00 or earlier, in addition to the above search, the following searches cannot be performed:
- A Search with Is contained or Is not contained selected
- A Search with multiple event statuses selected in the Severe events area

If the version of the JP1/Base event service on the host to be searched is 08-00 or earlier, a search with exclusion conditions specified cannot be performed.

Reference note

For conditions required when searching for events, see 3.5.2 Event search conditions in the Job Management Partner 1/Integrated Management - Manager Overview and System Design Guide.

The figure below shows an example of the Event Search Conditions window.

Note that the window in this example is the window that appears when the integrated monitoring database is not used.

Figure 2-21 Event Search Conditions window

The following describes the items displayed in the Event Search Conditions window.

Search host

Specifies the name of the host on which a JP1 event search is to be performed (name of the event server to be searched). The default is the name of the connected host. Note that when the integrated monitoring database is used, if the Event database radio button is selected in the Search object area, the host name specified last time as the name of the host to be searched is displayed. In addition, if the Integrated monitoring database radio button is selected in the Search object area, the user cannot specify Search host. Instead, the name of the host to which the user is logged in is specified.

If the user changes the radio button selection from Event database to Integrated monitoring database, and then selects the Event database radio button again, the name of the host specified the first time the user selected the Event database radio button is displayed in the Search host area.

Search direction

Specifies the direction of the JP1 event search.

When Past direction is selected, JP1/IM - View searches the event database (or the integrated monitoring database if the user has selected the Integrated monitoring database radio button in the Search object area) from the last (most recent) JP1 event to the first (oldest) JP1 event.

When Future direction is selected, JP1/IM - View searches the event database (or the integrated monitoring database if the user has selected the Integrated monitoring database radio button in the Search object area) from the first (oldest) JP1 event to the last (most recent) JP1 event.

The default is Past direction.

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 five condition groups can be set. When five condition groups have been specified, the Add and Copy buttons are disabled.

Exclusion-conditions group

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 five condition groups can be set. When five 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-conditions 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 Are you sure you want to delete this condition group?

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.

If the user selects an existing condition group and specifies a new name, the name of the condition group is replaced with the new name. The same name cannot be specified for a pass-conditions group and an exclusion-conditions group.

If the user attempts to specify an existing condition group name, a message 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. If no conditions are listed, this button is disabled.

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 5.1.3 Displaying extended attributes of JP1 events in the Job Management Partner 1/Integrated Management - Manager Administration Guide.

Source host

Specifies the name of a host (event server name) that issues a JP1 event. 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.

From the drop-down list on the right, the user selects a condition for the specified character strings from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

If Regular expression is selected, only one condition can be set.

Event level

Specifies the severity levels of the JP1 events to be defined as severe events from Emergency, Alert, Critical, Error, Warning, Notice, Information, and Debug.

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.

From the drop-down list on the right, the user selects a condition for the specified character string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

Object name

Specifies the object name of a JP1 event. Multiple object names require a comma as a separator. A maximum of 100 object 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.

From the drop-down list on the right, the user selects a condition for the specified characters string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

If Regular expression is selected, only one condition can be set.

Root object type

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

From the drop-down list on the right, the user selects a condition for the specified character string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

Root object name

Specifies the root object name of a JP1 event.

From the drop-down list on the right, the user selects a condition for the specified character string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

Occurrence

Specifies the occurrence type of a JP1 event.

From the drop-down list on the right, the user selects a condition for the specified character string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

User name

Specifies the user name of a JP1 event.

Multiple user names require a comma as a separator. A maximum of 100 user names can be specified. If a user name 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.

From the drop-down list on the right, the user selects a condition for the specified character string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

If Regular expression is selected, only one condition can be set.

Message

Specifies the message text of a JP1 event.

From the drop-down list on the right, the user selects a condition for the specified character string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression. The recommended option is First characters or Is contained. If Regular expression is selected, make sure that control characters used in the message text are not included in the expression. When specifying a regular expression, specify the portion other than the control code for the message text.

Product name

Specifies the name of the program that issues a JP1 event.

From the drop-down list on the right, the user selects a condition for the specified character string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

Event ID

Specifies the event ID of a JP1 event. Multiple event IDs require a comma as a separator.

From the drop-down list on the right, the user selects a condition for the specified character strings from Match and Does not match.

Start timeframe

Specifies the search range for JP1 events as a timeframe based on a start time. The search range is determined by using this base time and either a period or a specific time.

To use a period to specify the search range, the user first enters the base time after From:. Next, the user selects Period: and specifies a time period (in minutes, hours, or days) before or after the base time.

To use a time to specify the search range, the user first enters the base time after From:. Next, the user selects Time: and specifies a date and time.

The current date and time can be set as the base time by clicking the Current Time button.

End timeframe

Specifies the search range for JP1 events as a timeframe based on an end time. The search range is determined by using this base time and either a period or a specific time.

To use a period to specify the search range, the user first enters the base time after From:. Next, the user selects Period: and specifies a time period (in minutes, hours, or days) before or after the base time.

To use a time to specify the search range, the user first enters the base time after From:. Next, the user selects Time: and specifies a date and time.

The current date and time can be set as the base time by clicking the Current Time button.

Registered timeframe

Specifies the search range for JP1 events as a timeframe based on the time at which JP1 events were registered in the event database on the event-issuing host. The search range is determined by using this base time and either a period or a specific time.

To use a period to specify the search range, the user first enters the base time after From:. Next, the user selects Period: and specifies a time period (in minutes, hours, or days) before or after the base time.

To use a time to specify the search range, the user first enters the base time after From:. Next, the user selects Time: and specifies a date and time.

The current date and time can be set as the base time by clicking the Current Time button.

Arrived timeframe

Specifies the search range for JP1 events as a timeframe based on the times at which JP1 events arrived at the host where the search will be performed. The search range is determined by using this base time and either a period or a specific time.

To use a period to specify the search range, the user first enters the base time after From:. Next, the user selects Period: and specifies a time period (in minutes, hours, or days) before or after the base time.

To use a time to specify the search range, the user first enters the base time after From:. Next, the user selects Time: and specifies a date and time.

The current date and time can be set as the base time by clicking the Current Time button.

Status

Specifies the event statuses of JP1 events as search conditions. Multiple statuses can be specified. If the user selects Processed, only events whose status is set to Processed are retrieved. If the user selects Unprocessed, only events whose status is set to Unprocessed are retrieved. If the user selects Processing, only events whose status is set to Processing are retrieved. If the user selects Held, only events whose status is set to Held are retrieved.

Action

For JP1 events for which an automated action is defined, this item enables a search based on whether the defined automated action has been executed.

When linkage with JP1/IM - Rule Operation has been set up, the Action area is expanded to display the additional options shown below.

When linkage with JP1/IM - Rule Operation has been set up, the action type can be specified as a filter condition. For details about the setup for linkage with JP1/IM - Rule Operation, see 8.1.1 Settings for enabling the JP1/IM - Rule Operation linkage function in the Job Management Partner 1/Integrated Management - Manager Configuration Guide.

Extended attribute

When the user specifies specific extended attribute values as search conditions, clicking the Configure button displays the Event Search Conditions (Program-Specific Information in Extended Attribute) window.

When the integrated monitoring database is used

The following items are displayed when the integrated monitoring database is used:

Search object

Includes the Integrated monitoring database radio button and the Event database radio button for selecting which database will be searched. The database that the user selected last time is selected as the search object. If the search is the first time a search has been performed, the Integrated monitoring database radio button is selected.

Memo

If the function for setting memo entries has been enabled, the Memo area is displayed.

In this area, the user specifies memo entries for JP1 events. From the drop-down list on the right, the user selects a condition for the specified characters string from Match, Does not match, First characters, Is contained, Is not contained, and Regular expression.

New severity level

If the function for changing the severity level has been enabled, the New severity level column is displayed.

The user specifies whether changes to the severity level of events are to be retrieved. If the Target radio button is selected, JP1 events whose severity level has changed are retrieved. If the Not target radio button is selected, JP1 events whose severity level has not changed are retrieved.

Original severity level

If the function for changing the severity level has been enabled, the Original severity level area is displayed.

The user specifies the severity level of JP1 events in effect before the level was changed. The severity levels that can be selected are Emergency, Alert, Critical, Error, Warning, Notice, Information, and Debug.

[Contents][Back][Next]

[Trademarks]