5 Mapping

32.3533GPPCommon Object Request Broker Architecture (CORBA) Solution Set (SS)Communication Surveillance (CS) Integration Reference Point (IRP)Release 9Telecommunication managementTS

5.1 Operation and Notification mapping

CSIRP: IS 3GPP TS 32.352 [6] defines semantics of operation and notification visible across the CSIRP. Table 1 indicates mapping of these operations and notifications to their equivalents defined in this SS.

Table 1: Mapping from IS Operations and Notification to SS equivalents

IS Operations/ notification TS 32.352 [6]

SS Method

Qualifier

getHeartbeatPeriod

get_heartbeat_period

M

setHeartbeatPeriod

set_heartbeat_period

O

triggerHeartbeat

trigger_heartbeat

M

notifyHeartbeat

push_structured_event (See clause 6.1)

M

getIRPVersion (see note)

get_cs_irp_versions

M

getOperationProfile (see note)

get_cs_irp_operations_profile

O

getNotificationProfile (see note)

get_cs_irp_notification_profile

O

NOTE: This operation is of ManagedGenericIRP IOC specified in 3GPP TS 32.312 [4].
The CSIRP IOC of TS 32.352 [6] inherits from it.

5.2 Operation parameter mapping

The CSIRP: IS 3GPP TS 32.352 [6] defines semantics of parameters carried in operations across the CSIRP. The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS.

Table 2: Mapping from IS getHeartbeatPeriod parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

heartbeatPeriod

CSIRPConstDefs::HeartbeatPeriod heartbeat_period

M

status

Return value of type CSIRPConstDefs::Result

Exception:

GetHeartbeatPeriod

M

Table 3: Mapping from IS setHeartbeatPeriod parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

heartbeatPeriod

CSIRPConstDefs::HeartbeatPeriod heartbeat_period

M

status

Return value of type CSIRPConstDefs::Result

Exception:

SetHeartbeatPeriod, InvalidHeartbeatPeriod, ConflictingHeartbeatPeriod, ManagedGenericIRPSystem::ValueNotSupported, ManagedGenericIRPSystem::OperationNotSupported

M

Table 4: Mapping from IS triggerHeartbeat parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

managerIdentifier

CSIRPConstDefs::ManagerIdentifier manager_identifier

M

status

Return value of type CSIRPConstDefs::Result

Exception:

TriggerHeartbeat, InvalidManagerIdentifier

M

NOTE: For CORBA SS, the managerIdentifier of triggerHeartbeat operation shall be mapped to managerReference which is same as what IRPManager used to subscribe notifications [7].

Table 5: Mapping from IS getIRPVersion parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

versionNumberSet

Return value of type ManagedGenericIRPConstDefs::VersionNumberSet

M

status

Exception:

GetCSIRPVersions

M

Table 6: Mapping from IS getOperationProfile parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

iRPVersion

ManagedGenericIRPConstDefs::VersionNumber irp_version

M

operationNameProfile, operationParameterProfile

Return value of type ManagedGenericIRPConstDefs::MethodList

M

status

Exception:

GetCSIRPOperationsProfile, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter

M

Table 7: Mapping from IS getNotificationProfile parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

iRPVersion

ManagedGenericIRPConstDefs::VersionNumber irp_version

M

notificationNameProfile, notificationParameterProfile

Return value of type ManagedGenericIRPConstDefs::MethodList

M

status

Exception:

GetCSIRPNotificationProfile, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter

M

5.3 Notification parameter mapping

The semantics of parameters carried in notifications are defined in CSIRP IS (3GPP TS 32.352 [6]).

Table 8 indicates the mapping of these parameters to their OMG CORBA Structured Event [8] equivalents.

The composition of OMG Structured Event, as defined in [8] is:

Header

Fixed Header

domain_name

type_name

event_name

Variable Header

Body

filterable_body_fields

remaining_body

Table 8 lists in the second column all OMG Structured Event attributes. The first column identifies the notification parameters defined in CSIRP IS (3GPP TS 32.352 [6]).

Table 8: Mapping for notifyHeartBeat

IS Parameters

OMG CORBA Structured Event attribute

Qualifier

Comment

There is no corresponding IS attribute.

domain_name

M

It carries the IRP document version number string. See clause 3.1.

It indicates the syntax and semantics of the Structured Event as defined by the present document.

notificationType

type_name

M

This is the ET_HEARTBEAT of module of CSIRPConstDefs.

There is no corresponding IS attribute

event_name

M

It carries no information.

There is no corresponding IS attribute.

Variable Header

objectClass, objectInstance

One NV pair of filterable_body_fields

M

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 [7].

notificationId

One NV pair of remaining_body

M

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 [7].

eventTime

One NV pair of filterable_body_fields

M

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 [7].

systemDN

One NV pair of filterable_body_fields

M

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 [7].

heartbeatPeriod

One NV pair of remaining_body

M

Name of NV pair is the HEARTBEAT_PERIOD of interface NotifyHeartbeat of module CSIRPNotifications.

Value of NV pair is a CSIRPConstDefs::HeartbeatPeriod.

triggerFlag

One NV pair of remaining_body

M

Name of NV pair is the TRIGGER_FLAG of interface NotifyHeartbeat of module CSIRPNotifications.

Value of NV pair is a CSIRPConstDefs::TriggerFlag.

locator

One NV pair of remaining_body

M

Name of NV pair is the CHANNEL_ID of interface NotifyHeartbeat of module CSIRPNotifications.

Value of NV pair is a CSIRPConstDefs::ChannelId.

This parameter shall be mapped to an identifier of channel. For definition of channel, see OMG Notification Service [8].

The CHANNEL_ID carry the same meaning but may or may not carry the same value used by OMG defined Channel ID.

managerIdentifier

One NV pair of remaining_body

M

Name of NV pair is the MANAGER_IDENTIFIER of interface NotifyHeartbeat of module CSIRPNotifications.

Value of NV pair is a CSIRPConstDefs::ManagerIdentifier.