7 Use of OMG Structured Event

32.6633GPPCommon Object Request Broker Architecture (CORBA) Solution Set (SS)Configuration Management (CM)Kernel CM Integration Reference Point (IRP)Release 9Telecommunication managementTS

In CORBA SS, OMG defined StructuredEvent (see OMG Notification Service [6]) is used to carry notifications. This clause identifies the OMG defined StructuredEvent attributes that carry the attributes of notifications defined in 3GPP TS 32.662 [4].

The composition of OMG Structured Event, as defined in OMG Notification Service [6], is:

Header

Fixed Header

domain_name

type_name

event_name

Variable Header

Body

filterable_body_fields

remainder_of_body

The following table in this clause lists all OMG Structured Event attributes in its leftmost column. The second column identifies the SS attributes, if any, that shall be carried there.

Attributes that are denoted as "optional" may be absent from the OMG Structured Event. As an example, if the optional additionalText attribute is not used for a particular notification, then the IRPAgent may exclude additionalText from the filterable body fields for that particular notification. Individual notifications from the same IRPAgent may include or exclude the same optional attribute.

Table 7.1: Use of OMG Structured Event

IS Parameters

OMG CORBA Structured Event attribute

Comment

There is no corresponding IS parameter

domain_name

It contains the supported SS document version (see clause 4). This version is defined by the string constant KernelCmIRPSystem::VERSION defined in this specification.

notificationType

type_name

It is an attribute of notificationHeader. It shall indicate one of the following: Object Creation, Object Deletion, Attribute Value Change, State Change and CM Synchronization Recommended. It is a string. Its value is either defined by KernelCmNotifications::MOCreation::EVENT_TYPE, KernelCmNotifications::MODeletion::EVENT_TYPE, KernelCmNotifications::AttributeValueChange::EVENT_TYPE,

KernelCmNotifications::StateChange::EVENT_TYPE or

KernelCmNotifications::CMSynchronizationRecommended::EVENT_TYPE

There is no corresponding IS parameter

event_name

It shall be set to an empty string.

There is no corresponding IS parameter

variable Header

objectClass, objectInstance

One NV pair of filterable_body_fields

NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded in string.

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [9]).

notificationId

One NV pair of remainder_of_body

Name of NV pair is the NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a long. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [9]).

eventTime

One NV pair of filterable_body_fields

Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is IRPTime. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [9]).

systemDN

One NV pair of filterable_body_fields

Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS [9].

correlatedNotifications

One NV pair of remainder_of_body

It is an attribute of the Object Creation, Object Deletion and Attribute Value Change notifications.

Name of NV pair is the KernelCmNotifications::NotificationCommon::CORRELATED_NOTIFICATIONS.

Value of NV pair is a NotificationIRPConstDefs::CorrelatedNotificationSet defined in 3GPP TS 32.303 [9].

additionalText

One NV pair of remainder_of_body

It is an attribute of the Object Creation, Object Deletion, Attribute Value Change and CM Synchronization Recommended notifications.

Name of NV pair is the KernelCmNotifications::NotificationCommon::ADDITIONAL_TEXT

Value of NV pair is a string.

sourceIndicator

One NV pair of remainder_of_body

It is an attribute of the Object Creation, Object Deletion and Attribute Value Change notifications.

Name of NV pair is the KernelCmConstDefs::AttributeNameValue::SOURCE_INDICATOR.

Value of NV pair is the KernelCmNotifications::NotificationCommon::RESOURCE_OPERATION or MANAGEMENT_OPERATION or UNKNOWN_OPERATION.

attributeList

remainder_of_non_filterable_body (see 3GPP TS 32.303 [9])

It is used to transport attribute information.

For Object Creation notification, this is defined by KernelCmNotifications::MOCreation::InitialAttributeValues.

For Object Deletion notification, this is defined by KernelCmNotifications::MODeletion::AttributeValues.

The name component of InitialAttributeValues and AttributeValues will be set to attribute names defined in KernelCmNRMDefs.

attributeValueChangeDefinition

remainder_of_non_filterable_body (see 3GPP TS 32.303 [9])

For Attribute Value Change notification, this is defined by KernelCmNotifications::AttributeValueChange::ModifiedAttributeSet.

The name component of ModifiedAttributeSet will be set to attribute name defined in KernelCmNRMDefs.

StateManagementIRPConstDefs::AttributeNameValue

A set of up to 9

Name-value pairs

See table 7.2. All these 9 NV pairs are part of the remainder_of_body

For state change notifications a series of up to 9 name-value pairs might be sent corresponding with the new and old values of each state/status attribute which has changed it’s value.

The new values of each state/status attributes that have changed are sent.

The IRP agent may optionally send the old state/status changes.

The name of the name-value pairs are defined by StateManagementIRPConstDefs::AttributeNameValue

baseMOClass

One NV pair of remainder_of_body

It is an attribute of the CMSynchronizationRecommended notification.

Name of NV pair is a string,

KernelCmNotifications::CMSynchronizationRecommended::BASE_MO_CLASS.

Value of NV pair is a string. This string conveys the semantics of the Managed Object Class.

baseMOInstance

One NV pair of remainder_of_body

It is an attribute of the CMSynchronizationRecommended notification.

Name of NV pair is the KernelCmNotifications::CMSynchronizationRecommended::BASE_MO_INSTANCE.

Value of NV pair is a string. This is the DN string of the Managed Object Instance.

scope

One NV pair of remainder_of_body

It is an attribute of the CMSynchronizationRecommended notification.

Name of NV pair is the KernelCmNotifications::CMSynchronizationRecommended::SCOPE.

Value of NV pair is KernelCmConstDefs::ScopePara.

Table 7.2 Name – value pairs for state change notifications

Name

Value

OPERATIONAL_STATE

StateManagementIRPConstDefs::OperationalStateOldNewValue

USAGE_STATE

StateManagementIRPConstDefs::UsageStateOldNewValue

ADMINISTRATIVE_STATE

StateManagementIRPConstDefs::AdministrativeStateOldNewValue

ALARM_STATUS

StateManagementIRPConstDefs::AlarmStatusOldNewValue

PROCEDURAL_STATUS

StateManagementIRPConstDefs::ProceduralStatusOldNewValue

AVAILABILITY_STATUS

StateManagementIRPConstDefs::AvailabilityStatusOldNewValue

CONTROL_STATUS

StateManagementIRPConstDefs::ControlStatusOldNewValue

STANDBY_STATUS

StateManagementIRPConstDefs::StandbyStatusOldNewValue

UNKNOWN_STATUS

StateManagementIRPConstDefs::UnknownStatusOldNewValue