Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager Administration Guide


6.9.2 Displaying extended attributes of JP1 events (mapping of event information)

By mapping a program-specific extended attribute to an item with a basic attribute or common extended attribute, you can display the content of a program-specific extended attribute in the display item (basic attribute or common extended attribute) column of the events list.

An example follows.

Mapping definition settings

The following mapping definitions are set:

Event information mapping definition 1

Mapping program-specific extended attribute LOGHOST to the registered host name.

Mapping-target event ID: 12E0

Event information mapping definition 2

Mapping program-specific extended attribute LOGTIME to the arrival time.

Mapping-target event ID: 12E0

Events generated:

Events with the following content are generated.

Table 6‒6: Event generation content

No.

Attribute

Content

1

Severity

Error

2

Registration time

2001/10/30 17:47:31

3

Arrival time

2001/10/30 17:47:39

4

Registered host name

host_A

5

User name

jp1nps

6

Event ID

000012E0

7

Message

KAJC391-E ...

8

LOGHOST

loghost_1

9

LOGTIME

1003976997#

#: In the time format, the value becomes 2001/10/25 11:29:57.

Display in the Event Console window:

Normally, the events list in the Event Console window displays the contents of Nos. 1 to 7 in the above table, but because No. 8 is mapped to No. 4 and No. 9 is mapped to No. 3, the following is displayed:

Table 6‒7: Event Console window display

Severity

Registration time

Arrival time

Registered host name

User name

Event ID

Message

Error

10/25 17:47:31

# 10/25 11:29:57

# loghost_1

jp1nps

000012E0

KAJC391-E ...

To display a program-specific extended attribute, in the Event-Information Mapping Definitions window, map a display item to the program-specific extended attribute. To start the Event-Information Mapping Definitions window, you need JP1_Console_Admin permissions. In addition, when reference and operation permissions are set for a business group, operations in the Event-Information Mapping Definitions window might not be possible depending on the combination of JP1 resource group and JP1 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.

Note

Difference between event information mapping and source host mapping

The event information mapping functionality maps the value of an extended attribute of a JP1 event to the attribute of a display item in an event list, and displays it. This functionality can display another attribute value in the registered host name field of an event list. Note, however, that the functionality can be used only for changing the display of an event list. It cannot be used for event conditions, such as actions and event correlation.

The source host mapping functionality, however, registers the host name and source host name of a JP1 event acquired by JP1/IM - Manager in order to monitor and manage JP1 events. This functionality can display information in the source host name field of an event list and can also be used for event conditions, such as actions and event correlation. Note, however, that you must use the integrated monitoring database and enable source host mapping.

To map a program-specific extended attribute:

  1. In the Event Console window, from the Options menu, choose Event-Information Mapping Definitions.

    The Event-Information Mapping Definitions window opens.

    List of definitions shows the list of mapping definition information that is currently set.

    You can create a maximum of 16 mapping definitions.

  2. To enable event information mapping, from the Mapping menu, choose Map.

  3. To create a new mapping definition, click the Add button. To modify defined mapping information, choose an item from List of definitions and then click the Edit button, or double-click the item in List of definitions.

    The Event-Information Mapping Detailed Definitions window opens.

  4. From Display items & order, select the display item in the events list to which you want to map the program-specific extended attribute.

    You can select (in the Preferences window) the following items:

    Source process ID, arrival time, source user ID, source group ID, source user name, source group name, registered host name, source serial number, severity, user name, product name, object type, object name, root object type, root object name, occurrence, start time, and end time.

    • Specification example: registered-host-name

  5. In Attribute name, specify the name of the program-specific extended attribute you want to map.

    You can specify a maximum of 32 characters consisting of uppercase letters, numbers, and underscores. You need not specify E to indicate a program-specific extended attribute.

    Each display item can be mapped to a single program-specific extended attribute.

    To map a program-specific extended attribute to arrival time, start time, or end time, specify an attribute name whose attribute value is a numeric value (from 0 to 2,147,483,647 seconds from January 1, 1970 UTC). If you specify a value other than a numeric value or an attribute with a numeric value that is outside the range, the original attribute is displayed.

    • Specification example: LOGHOST

  6. In Event ID, specify the event ID of the JP1 event you want to map.

    You can specify a maximum of 1,000 characters, consisting of letters A-F or a-f, numbers, and commas. Specify the value in hexadecimal format. The range of values that can be specified is 00000000 to 7FFFFFFF.

    You can specify a maximum of 100 event IDs, delimited by commas.

    • Specification example 1: 3FFF

    • Specification example 2: 12345B, 7FFFFFFF

  7. Click the OK button.

    The Event-Information Mapping Detailed Definitions window closes, and the specified content is committed to the Event-Information Mapping Definitions window.

  8. In the Event-Information Mapping Definitions window, click the Apply button.

    For events that arrive after the Apply button has been clicked, the program-specific extended attribute is displayed along with this mapping definition.

You can specify the mapped program-specific extended attribute to filter JP1 events when using the view filter, severe event filter, and user filter.

When a program-specific extended attribute is displayed, it is preceded by the hash mark and a space (# ).

To specify a displayed program-specific extended attribute as the filtering condition, you need not enter a hash mark and a space (# ).

In the Preferences window, if you select the Display check box of the Coloring field, the background of a line in an event list is highlighted in the color for that event level.

If you changed the settings in the Event-Information Mapping Definitions window, the change is applied to the events list of all JP1/IM - Views connected to the same JP1/IM - Manager.

To view the information prior to mapping, select the mapped event and open the Event Details window. The Event Details window displays the information prior to mapping. Note that you can use the definition file for extended event attributes to display program-specific extended attributes in the Event Details window. For details, see the following explanations:

Using the definition file for extended event attributes to display program-specific extended attributes

See 4.14 Displaying user-defined event attributes in the JP1/Integrated Management 2 - Manager Overview and System Design Guide.

About the definition file for extended event attributes

See Definition file for extended event attributes in Chapter 2. Definition Files of the manual JP1/Integrated Management 2 - Manager Command, Definition File and API Reference.

Note the following points when you are mapping program-specific extended attributes: