Mapping Common Base Event attributes to Enterprise Console event attributes

An attribute name in a CBE event is converted to an attribute name in a Enterprise Console event according to the rows in table 1. Attribute names that are not available in table 1 are not mapped to a Enterprise Console event:

CBE event attribute

Enterprise Console event attribute

extensionName

CLASS

msg
msgDataElement.msgId (if set)

msg

severity

severity

creationTime

date

repeatCount

repeat_count

sourceComponentId.component

source

sourceComponentId.subComponent

sub_source

sourceComponentId.location

  • fqhostname (when the CBE sourceComponentId.locationType attribute equals to "FQHostname")
  • hostname (when the CBE sourceComponentId.locationType attribute equals to "Hostname")
  • origin (when the CBE sourceComponentId.locationType attribute equals to "Devicename")

globalInstanceId

globalInstanceId (if defined in the active rule base)

  • version
  • localInstanceId
  • priority
  • elapsedTime
  • sequenceNumber
  • msgDataElement (sub-fields not listed above)
  • sourceComponentId (sub-fields not listed above)
  • reporterComponentId (and sub-fields)
  • situation (and sub-fields)
  • associatedEvents (and sub-fields)

Not mapped

Table 1. Mapping of attributes between CBE and Enterprise Console event format


The following sections explain in details how each attribute is mapped from the CBE event to a Enterprise Console event:

extensionName

Mapped to the CLASS attribute. If there is no extensionName in the CBE event, then the CLASS attribute is set to EVENT, which is the default value for TEC event classes.

Note:

The value of the extensionName attribute in the CBE event may need to be converted to fit the character space used for the CLASS attribute in the Enterprise Console event.

msg

If both the msg attribute and the msgId field of the msgDataElement attribute are set in the CBE event, the Enterprise Console msg attribute is set with a concatenation of these two fields, resulting in a value with the following structure: msgId: msg

If only the msg attribute is set in the CBE event, it is copied directly to the Enterprise Console event msg attribute.

severity

The Enterprise Console event severity slot is an optional slot and can be represented by a numeric value or by one of the predefined keywords: UNKNOWN, HARMLESS, WARNING, MINOR, CRITICAL and FATAL. The severity will be mapped as follows:

If the CBE severity matches the enumerated list then the Enterprise Console event severity slot will be set to the CBE severity numeric value.

If there is no severity enumeration match then the following mapping will occur. Note, this mapping works best if the default Enterprise Console severities have not been changed. However, custom severities can be defined in addition to the default Enterprise Console severities.

repeatCount

Mapped directly to the Enterprise Console event repeat_count slot.

creationTime

The Enterprise Console event date slot is optional. It usually follows the pattern "MMM dd HH:mm:ss yyyy".The value will be created from the CBE creationTime pattern "yyyy-MM-dd'T'HH:mm:ss".

Note:

If there is a top-level extended data element in the CBE event named date, that value will be used for the Enterprise Console event date slot instead of creationTime.

sourceComponentId

The sourceComponentId is a complex CBE attribute, which means it contains other internal attributes. Its internal attributes are mapped to attributes in the Enterprise Console event according to the following table:

CBE attribute

Enterprise Console attribute

sourceComponentId.component

source (the value is not set if the CBE attribute contains an empty string or the value "N/A")

sourceComponentId.subcomponent

sub_source (the value is not set if the CBE attribute contains an empty string or the value "N/A")

sourceComponentId.location

fqhostname (the value is only set if sourceComponentId.locationType is "FQHostname")

sourceComponentId.location

hostname (the value is only set if sourceComponentId.locationType is "Hostname")

sourceComponentId.location

origin (the value is only set if sourceComponentId.locationType is "Devicename")

Table 2. Mapping of sourceComponentId attribute from a CBE event to a Enterprise Console event

Note:

If any of the sourceComponentId fields are not present then the corresponding Enterprise Console Event slot will not be created.

globalInstanceId

If present in the type for the event class in the rule base, this field is copied from the CBE event to the Enterprise Console event.


Downloads | Library | Support | Terms of Use | Feedback

(C) Copyright IBM Corporation 1999,2005. All Rights Reserved.