Information Model for NetAct 3GPP CORBA Release 6 Northbound Interface EAL2.0

(1)

EAL 2.0

Information Model for NetAct 3GPP

CORBA Release 6 Northbound Interface

DN0978921

Issue: 1-0

Draft

(2)

The information in this document is subject to change without notice and describes only the product defined in the introduction of this documentation. This documentation is intended for the use of Nokia Siemens Networks customers only for the purposes of the agreement under which the document is submitted, and no part of it may be used, reproduced, modified or transmitted in any form or means without the prior written permission of Nokia Siemens Networks. The documentation has been prepared to be used by professional and properly trained personnel, and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes customer comments as part of the process of continuous development and improvement of the documentation. The information or statements given in this documentation concerning the suitability, capacity, or performance of the mentioned hardware or software products are given "as is" and all liability arising in connection with such hardware or software products shall be defined conclusively and finally in a separate agreement between Nokia Siemens Networks and the customer. However, Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. Nokia Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which may not be covered by the document.

Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO EVENT WILL Nokia Siemens Networks BE LIABLE FOR ERRORS IN THIS DOCUMENTATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA,THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT. This documentation and the product it describes are considered protected by copyrights and other intellectual property rights according to the applicable laws. The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark of Nokia Corporation. Siemens is a registered trademark of Siemens AG. Other product names mentioned in this document may be trademarks of their respective owners, and they are mentioned for identification purposes only. Copyright © Nokia Siemens Networks. All rights reserved.

Important Notice on Product Safety

Elevated voltages are inevitably present at specific points in this electrical equipment. Some of the parts may also have elevated operating temperatures. Non-observance of these conditions and the safety instructions can result in personal injury or in property damage. Therefore, only trained and qualified personnel may install and maintain the system. The system complies with the standard EN 60950 / IEC 60950. All equipment connected has to comply with the applicable safety standards.

The same text in German:

Wichtiger Hinweis zur Produktsicherheit

In elektrischen Anlagen stehen zwangsläufig bestimmte Teile der Geräte unter Spannung. Einige Teile können auch eine hohe Betriebstemperatur aufweisen. Eine Nichtbeachtung dieser Situation und der Warnungshinweise kann zu Körperverletzungen und Sachschäden führen. Deshalb wird vorausgesetzt, dass nur geschultes und qualifiziertes Personal die Anlagen installiert und wartet. Das System entspricht den Anforderungen der EN 60950 / IEC 60950. Angeschlossene Geräte müssen die zutreffenden Sicherheitsbestimmungen erfüllen.

(3)

1.1 Terms... 5 2 General information...7 2.1 Scope... 7 2.2 Containment relationships... 7 3 Interface IRPs... 9 3.1 Kernel CM IRP... 9 3.1.1 Supported operations... 10 3.1.2 Supported notifications... 11 3.2 Notification IRP... 15 3.2.1 Supported operations... 15 3.3 Basic CM IRP... 19 3.3.1 Supported operations... 20 3.4 Alarm IRP... 22 3.4.1 Supported operations... 23 3.4.2 Supported notifications... 26

3.5 Entry Point IRP...40

3.5.1 Supported operations... 40

3.6 Communication Surveillance (CS) IRP... 43

3.6.1 Supported operations... 43

3.6.2 Supported Notifications... 45

4 Generic... 49

4.1 Scope... 49

4.2 Generic Network Resource Model... 49

4.2.1 Object Class definitions...50

5 Core...52

5.1 Scope... 52

5.2 Core Network Resource Model... 52

6 EUTRAN...59

6.1 Scope... 59

6.2 EUTRAN Network Resource Model... 59

7 UTRAN... 62

7.1 Scope... 62

7.2 UTRAN Network Resource Model...62

8 GERAN...66

8.1 Scope... 66

8.2 GERAN Network Resource Model... 66

(4)

9 EPC... 69

9.1 Scope... 69

9.2 EPC Network Resource Model... 69

10 TN...71

10.1 Scope... 71

10.2 TN Network Resource Model... 71

(5)

1 About this document

This document describes the Information Model as part of 3GPP CORBA Northbound Interface (NBI) Release 6 offered by Nokia Siemens Networks NetAct™.

1.1 Terms

This section explains the terms used in this document. For general information on terms, see

Glossary.

Table 1: Terms and explanations

Term Explanation

3GPP 3rd Generation Partnership Project Basic CM Basic Configration Management

BSC Base Station Controller

BSS Base Station System

BTS Base Transceiver Station

CM Configuration Management

CORBA Common Object Request Broker Architecture

CS Communication Surveilance

DN Distinguished Name

EM Element Manager

EMS Element Management System

EP Entry Point

EPC Evolved Packet Core

EUTRAN evolved UTRAN

GERAN GSM/EDGE Radio Access Network

IDL Interface Definition Language IRP Integration Reference Point

Itf-N Northbound Interface

MOC Managed Object Class

NMS Network Management System

NRM Network Resource Model

OMG Object Management Group

(6)

Term Explanation

PLMN Public Land Mobile Network

RAN Radio Access Network

RNC Radio Network Controller

STN Signalling Transport Network

TN Transport Network

TS Technical Specification

UMTS Universal Mobile Telecommunications System UTRAN UMTS Terrestrial Radio Access Network

(7)

2 General information

2.1 Scope

Current supported interface IRPs are: • Alarm IRP

• Notification IRP

• Basic CM IRP (passive part) • EP IRP

• CS IRP • Kernel CM IRP

Note:

Not all features of the above IRPs are supported. For details about IRP-specific restrictions, see Functional Specification for 3GPP CORBA Release 6 Northbound Interface.

2.2 Containment relationships

The information offered to external Network Management System (NMS) consists of functional and network element related Managed Object Classes (MOCs). Based on the Network Resource Model (NRM) type, the 3GPP MOC tree comprises of the following parts:

• Generic • Core • EUTRAN • UTRAN • GERAN • EPC • TN

The figure below shows the supported containment hierarchy for MOCs.

Note:

For information on the IRPs referenced 3GPP Technical Specification (TS), see Table 2: Supported IRPs on page 9.

(8)

(9)

3 Interface IRPs

The following table lists all interface IRPs supported by NetAct 3GPP CORBA Release 6 NBI. Table 2: Supported IRPs

Integration Reference Point

(IRP) 3GPP Information Service 3GPP Corba Solution Set

KernelCmIRP 3GPP TS 32.662 V6.3.0 3GPP TS 32.663 V6.3.0

NotificationIRP 3GPP TS 32.302 V6.1.0 3GPP TS 32.303 V6.2.0

BasicCmIRP 3GPP TS 32.602 V6.0.0 3GPP TS 32.603 V6.2.0

AlarmIRP 3GPP TS 32.111-2 V6.3.0 3GPP TS 32.111-3 V6.1.0

Entry Point (EP) IRP 3GPP TS 32.362 V6.2.0 3GPP TS 32.363 V6.3.0 Communication Surveillance

(CS) IRP

3GPP TS 32.352 V6.0.0 3GPP TS 32.353 V6.1.0

The following sections provide all supported IRPs information about operations and/or notifications on northbound interface and mapping tables for all supported notifications.

Operation input and output (including exceptions) parameters and the general syntax of 3GPP-compliant parts are described in 3GPP documents (Information Service, Solution Set and IDL). Additional explanations are given to optional parameters and some notification parameters, such as

additionalInformation or additionalText, which are intentionally modeled to carry arbitrary user defined information.

Conventions

The following table describes the meaning of qualifiers used in tables throughout this section. Table 3: Meanings of qualifiers

Column Shortcuts Meaning

Y Supported by NetAct

NetAct

N Not supported

Restrictions

For the current applicable list of restrictions, see Functional Specification for 3GPP CORBA Release 6 Northbound Interface.

3.1 Kernel CM IRP

(10)

Table 4: Kernel CM IRP related functions

IS Operation/Notification 3G TS 32.663

[32.663] SS Method Supported byNetAct

getNRMIRPVersion get_NRM_IRP_version Y

getIRPVersion get_kernel_CM_IRP_versions Y

getOperationProfile get_kernel_CM_IRP operation_profile Y getNotificationProfile get_kernel_CM_IRP_notification_profile Y notifyObjectCreation push_structured_event Y notifyObjectDeletion push_structured_event Y notifyStateChange push_structured_event N notifyAttributeValueChange push_structured_event N notifyCMSynchronizationRecommended push_structured_event Y

3.1.1 Supported operations

getNRMIRPVersion Table 5: getNRMIRPVersion

IS Operation parameter SS Method parameter Supported by NetAct

versionNumberList Return value of type

ManagedGenericIRPConstDefs::VersionNumberSet

Y

vSEVersionNumberList Return value of type

ManagedGenericIRPConstDefs::VersionNumberSet Y status Exceptions: GetNRMIRPVersion Y getIRPVersion Table 6: getIRPVersion

versionNumberList Return of type

ManagedGenericIRPConstDefs::VersionNumberSet

Y

(11)

GetKernelCmIRPVersionsException

getOperationProfile

Table 7: getOperationProfile

IS Operation parameter SS Method parameter Supported by NetAct irpVersion ManagedGenericIRPConstDefs::VersionNumber kernel_CM_IRP_version Y operationNameProfile, operationParameterProfile

Return value of type

ManagedGenericIRPConstDefs::MethodList Y status Exceptions: GetKernelCMIRPOperationProfileException, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter Y getNotificationProfile Table 8: getNotificationProfile

IS Operation parameter SS Method parameter Supported by NetAct irpVersion ManagedGenericIRPConstDefs::VersionNumber kernel_CM_IRP_version Y notificationNameProfile, notificationParameterProfile

ManagedGenericIRPConstDefs::MethodList Y status Exceptions: GetKernelCMIRPNotificationProfileException, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter Y

3.1.2 Supported notifications

OMG Notification Service defines two styles of interaction: • pull style

(12)

NetAct supports only push style.

notifyObjectCreation

Table 9: notifyObjectCreation

SS Attribute OMG CORBA

Struc-tured Event attribute Supported byNetAct Comment

- domain_name Y It carries the IRP document version

num-ber string.

Event Type type_name Y Value is EVENT_TYPE of interface

MO-Creation of module KernelCmNotifications

- event_name Y Empty string

Managed Ob-ject Class One NV pair of filterable_body_fields Y Name of NV pair is MANAGED_OBJECT_CLASS of in-terface AttributeNameValue of module NotificationIRPConstDefs.Value of NV pair is a string. The string represents the object class of the network element

Managed Ob-ject Instance One NV pair of filterable_body_fields Y Name of NV pair is MANAGED_OBJECT_INSTANCE of in-terface AttributeNameValue of module NotificationIRPConstDefs.Value of NV pair is a string. The string represents the 3GPP DN of the network element

notificationId One NV pair of filterable_body_fields

Y Name of NV pair is NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a long. The value represents the consec-utive number of the notification.

EventTime One NV pair of filterable_body_fields

Y Name of NV pair is the EVENT_TIME of in-terface AttributeNameValue of module No-tificationIRPConstDefs. Value of NV pair is IRPTime of module ManagedGenericIRP-ConstDefs. The value represents the cre-ation time of the object in NetAct.

SystemDN One NV pair of filterable_body_fields

Y Name of NV pair is the SYSTEM_DN of in-terface AttributeNameValue of module No-tificationIRPConstDefs. Value of NV pair is a string. The value represents the 3GPP DN of the IRP agent.

CorrelatedNo-tifications

One NV pair of

remainder_body_fields

N Name of NV pair is NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a long. The value represents the consec-utive number of the notification.

Additional Text One NV pair of filterable_body_fields Y Empty string source Indic-ator One NV pair of remainder_body_fields N

(13)

Struc-tured Event attribute Supported byNetAct Comment

attributeList One NV pair of

remainder_body_fields

Y The remainder_body carries the informa-tion about the newly created object. Value is an InitialAttributeValues of interface MO-Creation of module KernelCmNotifDefs. The attributes provided in InitialAttribute-Values depend on the managed object class of the new object.

notifyObjectDeletion

Table 10: notifyObjectDeletion

SS Attribute OMG CORBA Structured Event attribute

Supported

by NetAct Comment

- domain_name Y It carries the IRP document version number string. Event Type type_name Y Value is EVENT_TYPE of interface MODeletion of

module KernelCmNotifications

Managed Ob-ject Class

One NV pair of filterable_body _fields

Y Name of NV pair is MANAGED_OBJECT_CLASSof interface AttributeNameValue of module Notifica-tionIRPConstDefs. Value of NV pair is a string. The string represents the object class of the network ele-ment Managed Ob-ject Instance One NV pair of filterable_body _fields Y Name of NV pair is

MANAGED_OBJECT_INSTANCE of interface Attrib-uteNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The string represents the 3GPP DN of the network element

notificationId One NV pair of filterable_body _fields

Y Name of NV pair is NOTIFICATION_ID of interface AttributeNameValue of module

NotificationIRPConstDefs.Value of NV pair is a long. The value represents the consecutive number of the notification.

EventTime One NV pair of filterable_body _fields

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPCon-stDefs. Value of NV pair is a IRPTime of module ManagedGenericIRPConstDefs. The value repres-ents the time the object has been deleted in NetAct. SystemDN One NV pair of

filterable_body _fields

Y Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPCon-stDefs. Value of NV pair is a string. The value rep-resents the 3GPP DN of the IRP agent.

Additional Text One NV pair of filterable_body _fields Y Empty string

(14)

notifyCMSynchronizationRecommended

Table 11: notifyCMSynchronizationRecommended

Struc-tured Event attribute Suppor-tedby Net-Act

Comment

- domain_name Y It carries the IRP document version number

string.

Event Type type_name Y Value is EVENT_TYPE of interface MODele-tion of module KernelCmNotificaMODele-tions

Managed Ob-ject Class One NV pair of filterable_body _fields Y Fixed value:KernelCMIRP Managed Ob-ject Instance One NV pair of filterable_body _fields Y fixed value: SubNetwork=1,ManagedNode=1,IRPAgent=1, KernelCMIRP=1

notificationId One NV pair of filterable_body _fields

Y Name of NV pair is NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs.Value of NV pair is a long. The value represents the consecutive number of the notification.

EventTime One NV pair of filterable_body _fields

Y Name of NV pair is the EVENT_TIME of in-terface AttributeNameValue of module No-tificationIRPConstDefs. Value of NV pair is a IRPTime of module ManagedGenericIRP-ConstDefs. The value represents the time the object has been deleted in NetAct.

SystemDN One NV pair of filterable_body _fields

Y Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs.Value of NV pair is a string. The value represents the 3GPP DN of the IRP agent.

- remainder_body Y _{The remainder_body carries the following} in-formation:

baseMOClass specifies the class of the root managed entity of a whole subtree, of which the configuration information should be syn-chronized by NM.

baseMOInstance specifies the root managed entity of a whole subtree, of which the config-uration information should be synchronized by NM.

(15)

3.2 Notification IRP

The following table lists the Notification IRP related functions. Table 12: Notification IRP related functions

IS Operation/Notification 3G

TS 32.352 [32.352] SS Method Supported by Net-Act

attach_push Y attach_push_b N subscribe attach_pull N unsubscribe detach Y getIRPVersion get_notification_IRP_versions Y getSubscriptionStatus get_subscription_status Y getSubscriptionIds get_subscription_ids Y changeSubscriptionFilter change_subscription_filter Y suspendSubscription no SS equivalent N resumeSubscription no SS equivalent N getNotificationCategories get_notification_categories Y getOperationProfile get_notification_IRP_operations_profile Y getNotificationProfile get_notification_IRP_notification_profile Y

3.2.1 Supported operations

Subscribe(attach_push) Table 13: Subscribe(attach_push)

IS Operation parameter SS Method parameter Supported by NetAct

managerReference string manager_reference Y

timeTick unsigned long time_tick Y

notification Categories NotificationIRPConstDefs:: NotificationCategorySet notification_categories Y filter ManagedGenericIRPConstDefs:: StringTypeOpt filter Y

subscriptionId Return value of type Notifica-tionIRPConstDefs:: SubscriptionId

Y

status Attach,

ManagedGenericIRPSys-tem:: ParameterNotSupported, ManagedGenericIRPSystem::

(16)

InvalidParameter, AlreadySub-scribed, AtLeastOneNotificationCat-egoryNotSupported

Note:

The notifaction categories can either be the version string, such as 32.363 V6.3, or the IRP ID, such as EPIRP. Several categories can be registered in one call. When a second subscription is done for the same manager, all categories in the second subscription must not be subscribed in the first subscription, otherwise the complete subscription is rejected with the exception “AlreadySubscribed”.

The filter language is always extended TCL.

unsubscribe

Table 14: unsubscribe

IS Operation parameter SS Method parameter Supported by NetAct

managerReference string manager_reference Y subscriptionId NotificationIRPConstDefs::

Sub-scriptionId subscription_id

Y

status DetachException,

Man-agedGenericIRPSystem:: Para-meterNotSupported, Man-agedGenericIRPSystem:: Inval-idParameter Y getIRPVersion Table 15: getIRPVersion

versionNumberSet Return value of type Man-agedGenericIRPConstDefs:: VersionNumberSet

Y

status Exception: GetCSIRPVersions Y

getSubscriptionStatus

Table 16: getSubscriptionStatus

subscriptionId NotificationIRPConstDefs:: Sub-scriptionId subscription_id

(17)

notificationCategorySet Return value of type Notifica-tionIRPConstDefs:: Notification-CategorySet Y filterInEffect ManagedGenericIRPCon-stDefs:: StringTypeOpt filter_in_effect Y

subscriptionState NotificationIRPConstDef:: Sub-scriptionState subscription_state

Y

timeTick unsigned long time_tick Y

status GetSubscriptionStatus,

Man-agedGenericIRPSystem:: Op-erationNotSupported, Man-agedGenericIRPSystem:: Inval-idParameter Y Note:

The subscription state can be “ACTIVE” or “INVALID”. The state “SUSPENDED” is not possible, because it is not defined for the push model.

The notification channel is persitant, so the subscription is active even when the consumer object in the manager does not exist. The manager can create the same object and continue receiving events without loosing events. When the manager rejects notification events for more than 30 minutes, the subscription state changes to “INVALID” and the subscription is deleted in the notification service.

When the subscriptionID cannot be found, the InvalidParamter exception appears. This is also the case when an unsubscribed is done for the subscription.

getSubscriptionIds

Table 17: getSubscriptionIds

managerReference string manager_reference Y subscriptionIdSet Return value of type

Notifica-tionIRPConstDefs:: Subscrip-tionIdSet

Y

status GetSubscriptionIds,

Man-agedGenericIRPSystem:: Op-erationNotSupported,

(18)

agedGenericIRPSystem:: Inval-idParameter

changeSubscriptionFilter

Table 18: changeSubscriptionFilter

subscriptionId NotificationIRPConstDefs:: Sub-scriptionId subscription_id

Y

filter string filter Y

status ChangeSubscriptionFilter,

Man-agedGenericIRPSystem:: Op-erationNotSupported, Man-agedGenericIRPSystem:: Inval-idParameter Y Note:

The filter language is always extended TCL.

getNotificationCategories

Table 19: getNotificationCategories

notificationCategoryList Return value of type Notifica-tionIRPConstDefs:: Notification-CategorySet

Y

Not specified in IS NotificationIRPConstDefs:: NotificationTypesSet notification_type_list

Y

status GetNotificationCategories,

Man-agedGenericIRPSystem:: Oper-ationNotSupported

Y

(19)

iRPVersion ManagedGenericIRPCon-stDefs:: VersionNumber operation_irp_version Y operationNameProfile, opera-tionParameterProfile

Return value of type Man-agedGenericIRPConstDefs:: MethodList Y status GetOperationIRPNotifica-tionProfile, ManagedGeneri-cIRPSystem:: OperationNot-Supported, ManagedGeneri-cIRPSystem:: InvalidParameter Y getNotificationProfile Table 21: getNotificationProfile

iRPVersion ManagedGenericIRPCon-stDefs:: VersionNumber notification_irp_version Y notificationNameProfile, notifica-tionParameterProfile

Return value of type Man-agedGenericIRPConstDefs:: MethodList Y status GetNotificationIRPNotifica-tionProfile, ManagedGeneri-cIRPSystem:: OperationNot-Supported, ManagedGeneri-cIRPSystem:: InvalidParameter Y

3.3 Basic CM IRP

The following table lists the Basic CM IRP related functions. Table 22: Basic CM IRP related functions

TS 32.603 [32.603] SS Method Supported by NetAct

getMoAttributes BasicCmIrpOperations:: find_managed_objects

(20)

getContainment BasicCmInformationIterator:: next_basicCmInformations Y getIRPVersion get_basicCm_IRP_version Y cancelOperation BasicCmInformationIterator::destroy Y createMo BasicCmIrpOperations:: create_managed_object N deleteMo BasicCmIrpOperations:: delete_managed_objects N setMoAttributes BasicCmIrpOperations:: modify_managed_objects N getOperationProfile get_basicCm_IRP_operation_profile Y getNotificationProfile get_basicCm_IRP_notification_profile Y

3.3.1 Supported operations

getMoAttributes Table 23: getMoAttributes

IS Operation parameter SS Method parameter Supported by Net-Act

invokeIdentifier - (No equivalence) N

invokeIdentifierOut Return value of type BasicCmInformationIterator Y

baseObjectInstance in DN baseObject Y

scope in SearchControl (SearchControl.type and SearchControl.level)

Y

filter in SearchControl (SearchControl.filter) N

attributeListIn in AttributeNameSet requestedAttributes N managedObjectClass,

managedObjectIn-stance, attributeListOut

Return value of type BasicCmInformationIterat-or parameter out ResultSet fetchedElements of method next_basicCmInformations

Y

status Exceptions: FindManagedObjects, ManagedGen-ericIRPSystem:: InvalidParameter, IllegalDNForm-atException, IllegalScopeLevelException, Un-definedMOException

Y

getContainment

Table 24: getContainment

(21)

invokeIdentifierOut Return value of type BasicCmIn-formationIterator

Y

baseObjectInstance in DN baseObject Y

scope in SearchControl

searchCon-trol (SearchConsearchCon-trol.type and SearchControl.level)

Y

Not specified in IS in SearchControl searchControl (SearchControl.filter)

N

containment Return value of type Ba-sicCmInformationIterator - parameter out ResultSet fetchedElements of method next_basicCmInformations

N

status Exceptions: InvalidParameter,

Il-legalDNFormatException, Illegal-ScopeLevelException, Undefined-MOException, ParameterNotSup-ported Y getIRPVersion Table 25: getIRPVersion

versionNumberSet Return value of type ManagedGeneri-cIRPConstDefs:: VersionNumberSet

Y

status Exception: GetBasicCmIRPVersion Y

cancelOperation

Table 26: cancelOperation

invokeIdentifier - (Not applicable, the BasicCmInformationIter-ator instance identifies the ongoing operation)

Y status Exceptions: ManagedGenericIRPSystem::

Op-erationNotSupported, DestroyException

Y

getOperationProfile

irpVersion ManagedGenericIRPConstDefs::VersionNumber basicCm_IRP_version

(22)

operationNameProfile, operationParameterPro-file

ManagedGenericIRPConstDefs::MethodList

Y

status Exceptions:

GetBasicCmIRPOp-erationProfile, ManagedGeneri-cIRPSystem:: OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter Y getNotificationProfile Table 28: getNotificationProfile

irpVersion ManagedGenericIRPConstDefs:: Version-Number basicCm_IRP_version

Y notificationNameProfile,

no-tificationParameterProfile

ManagedGenericIRPConstDefs::MethodList Y

status Exceptions:

GetBasicCmIRPNo-tificationProfile, ManagedGeneri-cIRPSystem:: OperationNotSupported,

ManagedGenericIRPSystem::InvalidParameter Y

3.4 Alarm IRP

The following table lists the Alarm IRP related functions. Table 29: Alarm IRP related functions

IS Operation/ Notification 3G

TS 32.111-2 [32.1112] SS Method Supported by NetAct

acknowledgeAlarms acknowledge_alarms Y unacknowledgeAlarms unacknowledge_alarms Y getAlarmList get_alarm_list Y getIRPVersion get_alarm_IRP_versions Y getAlarmCount get_alarm_count Y setComment comment_alarms N clearAlarms clear_alarms Y getOperationProfile get_alarm_IRP_operations_profile Y getNotificationProfile get_alarm_IRP_notification_profile Y notifyNewAlarm push_structured_event Y notifyClearedAlarm push_structured_event Y

(23)

IS Operation/ Notification 3G

TS 32.111-2 [32.1112] SS Method Supported by NetAct

notifyChangedAlarm push_structured_event Y notifyAckStateChanged push_structured_event Y notifyAlarmListRebuilt push_structured_event Y notifyComments push_structured_event N notifyPotentialFaultyAlarmList push_structured_event N

3.4.1 Supported operations

acknowledgeAlarms Table 30: acknowledgeAlarms

IS Operation parameter SS Method parameter Supported by Net-Act alarmInformationAndSeverity ReferenceList AlarmIRPConstDefs:: AlarmInformationIdAnd-SevSeq alarm_information_id_and_sev_list Note:

perceivedSeverity is optional { alar-mId - Mandatory; perceivedSeverity - Optional }

Y

ackUserId string ack_user_id Y

ackSystemId ManagedGenericIRPConstDefs::StringTypeOpt ack_system_id Y badAlarmInformationRefer-enceList AlarmIRPConstDefs:: BadAcknowledgeAl-armInfoSeq bad_ack_alarm_info_list Y status ManagedGenericIRPConstDefs::Signal

Ex-ceptions: AcknowledgeAlarms, ManagedGen-ericIRPSystem:: ParameterNotSupported, ManagedGenericIRPSystem::InvalidParameter

Y

unacknowledgeAlarms

Table 31: unacknowledgeAlarms

IS Operation parameter SS Method parameter Supported by Net-Act

alarmInformationReferenceList AlarmIRPConstDefs:: AlarmInforma-tionIdSeq alarm_information_id_list

Y

ackUserId string ack_user_id Y

ackSystemId ManagedGenericIRPConstDefs:: String-TypeOpt ack_system_id

(24)

IS Operation parameter SS Method parameter Supported by Net-Act badAlarmInformationRefer-enceList AlarmIRPConstDefs:: Ba-dAcknowledgeAlarmInfoSeq bad_ack_alarm_info_list Y status ManagedGenericIRPConstDefs::Signal

Exceptions: AcknowledgeAlarms, Man-agedGenericIRPSystem:: Parameter-NotSupported, ManagedGenericIRPSys-tem:: InvalidParameter Y getAlarmList Table 32: getAlarmList

alarmAckState, filter ManagedGenericIRPConstDefs::StringTypeOpt filter

Y

baseObjectClass, baseO-bjectInstance

AlarmIRPConstDefs::DNTypeOpt base_object Y alarmInformation List Boolean flag (output parameter) Y - AlarmInformationIterator iter (output parameter) Y

- Return value of type

AlarmIRPConstDefs::AlarmInformationSeq

Y

status Exceptions: GetAlarmList, ManagedGen-ericIRPSystem:: ParameterNotSupported, ManagedGenericIRPSystem::InvalidParameter

Y

Mode of Operation

From [32.1112] point of view, NetAct supports only the synchronous mode. That is, results of the operation are not returned via notifications, because [32.1113] does not define an asynchronous mode.

According to [32.1113], the synchronous mode can be implemented in two ways: • the upload results are contained in a sequence of type

AlarmIRPConstDefs::AlarmInformationSeq

• an iterator of type AlarmInformationIterator is returned that has to be used to retrieve the upload results

NetAct supports only the approach of using the iterator, so the value of output parameter flag is always set to FALSE, and the return value does not contain any alarm information. That means the sequence is always empty and the output parameter iter has to be used to retrieve the results of the operation.

NetAct expects the invoker of the operation to retrieve synchronization results continuously until all results have been fetched or the iterator is destroyed by the invoker. Subsequent invocations of the iterator are supposed to be performed within a time interval of 30 seconds, otherwise the synchronization request will be aborted and the iterator will be destroyed.

(25)

Filtering

The grammar of the optional filter is “EXTENDED_TCL”. The filtering of uploaded events have the same format as the notifications, so the filter for notification and get alarm list can be the same.

Parallel requests

NetAct 3GPP interface does not support parallel “getAlarmList” requests from one or more IRP managers. A request is parallel if a previously performed “getAlarmList” request from any manager has not finished. If one request is currently processed, a further request will result in GetAlarmList exception to be thrown, which indicates that the new request can not be handled because of an ongoing request.

getAlarmIRPVersion

Table 33: getAlarmIRPVersion

versionNumberSet Return value of type ManagedGenericIRPCon-stDefs:: VersionNumberSet

Y

status Exceptions: GetAlarmIRPVersions Y

get_alarm_count

Table 34: get_alarm_count

alarmAckState, filter ManagedGenericIRPConstDefs::StringOpt filter Y criticalCount unsigned long critical_count (output parameter) Y majorCount unsigned long major_count (output parameter) Y minorCount unsigned long minor_count (output parameter) Y warningCount unsigned long warning_count (output parameter) Y indeterminateCount unsigned long indeterminate_count (output

para-meter)

Y

clearedCount unsigned long cleared_count (output parameter) Y Status Exceptions: GetAlarmCount,

Man-agedGenericIRPSystem:: Opera-tionNotSupported, ManagedGeneri-cIRPSystem:: ParameterNotSupported, ManagedGenericIRPSystem::InvalidParameter Y clearAlarms Table 35: clearAlarms

alarmInformationReferenceList AlarmIRPConstDefs:: AlarmInforma-tionIdSeq alarm_information_id_list

Y

(26)

clearSystemId string clear_system_id Y

badAlarmInformationReferenceList AlarmIRPConstDefs:: BadAlarmInformationIdSeq bad_alarm_information_id_list

Y

status ManagedGenericIRPConstDefs::Signal

Exceptions: ClearAlarms, Man-agedGenericIRPSystem:: Opera-tionNotSupported, ManagedGeneri-cIRPSystem:: ParameterNotSuppor-ted, ManagedGenericIRPSystem:: In-validParameter

Y

get_alarm_IRP_operations_profile

Table 36: get_alarm_IRP_operations_profile

irpVersion ManagedGenericIRPConstDefs:: VersionNum-ber alarm_irp_version

Y operationNameProfile,

op-erationParameterProfile

Return value of type ManagedGenericIRPCon-stDefs:: MethodList

Y

status Exceptions: GetAlarmIRPOperation-sProfile, ManagedGenericIRPSys-tem:: OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter Y get_alarm_irp_notifications_profile Table 37: get_alarm_irp_notifications_profile

IS Operation parameter SS Method parameter Supported by Net-Act irpVersion ManagedGenericIRPConstDefs::VersionNumber alarm_irp_version Y notificationNameProfile, no-tificationParameterProfile

Y status Exceptions:

GetAlarmIRPNotifica-tionProfile, ManagedGenericIRPSys-tem:: OperationNotSupported,

ManagedGenericIRPSystem::InvalidParameter Y

3.4.2 Supported notifications

OMG Notification Service defines two styles of interaction: • push style

• pull style

(27)

Notification notifyNewAlarm (to carry non-security-related alarms)

Table 38: Notification notifyNewAlarm (to carry non-security-related alarms)

IS Parameters OMG CORBA Struc-tured Event attrib-ute

Supported

- domain_name Y It carries the IRP document version

number string.

notificationType type_name Y Value is: NOTIFY_FM_NEW_ALARM

of interface NotificationType of module AlarmIRPConstDefs.

AlarmType event_name Y It identifies one of the following: • communications alarm • processing error alarm • environmental alarm • quality of service alarm • equipment alarm

Values are defined by interface Alarm-Type of module AlarmIRPConstDefs.

- variable Header Y

-objectClass One NV pair of filter-able_ body_fields

Y Name of NV pair is

MANAGED_OBJECT_CLASS of in-terface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The string represents the object class of the network element emitting the alarm. Possible values for 3GPP network resource model are defined in [32.623], [32.633], [32.643] and [32.653].

objectInstance One NV pair of filter-able_ body_fields

MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of mod-ule NotificationIRPConstDefs. Value of NV pair is a string. The string repres-ents the 3GPP DN of the network ele-ment emitting the alarm.

notificationId One NV pair of filter-able_ body_fields

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is an IRPTime of module ManagedGenericIRPCon-stDefs. The value represents the alarm_time of the alarm in NetAct alarm database.

eventTime One NV pair of

filterable_body_fields

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of

(28)

Supported

module NotificationIRPConstDefs. Value of NV pair is an IRPTime of module ManagedGenericIRPCon-stDefs. The value represents the alarm_time of the alarm in NetAct alarm database.

systemDN One NV pair of filter-able_ body_fields

Y Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The value represents the 3GPP DN of the IRP agent.

probableCause One NV pair of filter-able_ body_fields

Y Name of NV pair is the

PROBABLE_CAUSE of interface AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a short defined by interface Prob-ableCause of module AlarmIRPCon-stDefs. The value represents the prob-able cause of the alarm in NetAct alarm database.

perceivedSeverity One NV pair of filter-able_ body_fields

VENDER_SPECIFIC_ALARM_TYPE of interface AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a string.

specificProblem One NV pair of filter-able_ body_fields

SPECIFIC_PROBLEM of inter-face AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a string. The value represents the alarm number of the alarm in Net-Act alarm database. The paramet-er has to be stored in the remaindparamet-er body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

correlatedNotifications One NV pair of remainder_body

N

backedUpStatus One NV pair of remainder_body

N backUpObject One NV pair of

remainder_body

N

trendIndication One NV pair of remainder_body

(29)

Supported

thresholdInfo One NV pair of remainder_body

N stateChangeDefinition One NV pair of

remainder_body

N

monitoredAttributes One NV pair of remainder_body N proposedRepairAc-tions One NV pair of remainder_body N

additionalText One NV pair of filter-able_ body_fields

ADDITIONAL_TEXT of interface Attrib-uteNameValue of module AlarmIRP-ConstDefs. Value of NV pair is a string. The value represents the alarm text of the alarm in NetAct alarm database. The parameter has to be stored in the remainder body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

additionalInformation One NV pair of filter-able_ body_fields

Y The value represents the additional (vendor specific) information of the alarm in NetAct alarm database.

userAdditionalInforma-tion

One NV pair of filter-able_ body_fields

Y The value represents the user addition-al information of the addition-alarm in NetAct alarm database.

DiagnosticInformation One NV pair of filter-able_ body_fields

Y The value represents the diagnostic in-formation of the alarm in NetAct alarm database.

alarmId One NV pair of filter-able_ body_fields

Y Name of NV pair is the ALARM_ID of interface AttributeNameValue of mod-ule AlarmIRPConstDefs. Value of NV pair is a string. The string is a con-catenation of several attributes of the NSN alarm. The parameter has to be stored in the remainder body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

- remainder_ body N

(30)

Table 39: Notification notifyClearedAlarm

IS Parameters OMG CORBA

Struc-tured Event attribute Supportedby NetAct Comment

- _{domain_name} _Y _{It carries the IRP document}

version-number string.

notificationType type_name Y Value is:

NOTIFY_FM_CLEARED_ALARM of interface NotificationType of module AlarmIRPConstDefs.

alarmType event_name Y It identifies one of the following:

• communications alarm • processing error alarm • environmental alarm • quality of service alarm • equipment alarm

Values are defined by interface AlarmType of module AlarmIRP-ConstDefs.

- _{variable Header} _Y

-managedObject Class One NV pair of filter-able_ body_fields

MANAGED_OBJECT_CLASS of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The string represents the object class of the network element emitting the alarm. Possible values for 3GPP network resource model are defined in [32.623], [32.633], [32.643] and [32.653].

managedObjectInstance One NV pair of filter-able_ body_fields

MANAGED_OBJECT_INSTANCE ofinterface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The string represents the 3GPP DN of the network element emitting the alarm.

(31)

notification Id One NV pair of filter-able_ body_fields

Y Name of NV pair is the EVENT_TIME of interface At-tributeNameValue ofmodule NotificationIRPConstDefs.Value of NV pair is an IRPTime of mod-ule ManagedGenericIRPCon-stDefs. The value represents the alarm_time of the alarm in NetAct alarm database.

EVENT_TIME of interface Attrib-uteNameValue of module Notific-ationIRPConstDefs. Value of NV pair is an IRPTime of module Man-agedGenericIRPConstDefs. The value represents the alarm_time of the alarm in NetAct alarm database. Value of NV pair is a IRPTime of module ManagedGenericIRPCon-stDefs. The value represents the cancel_time of the alarm in NetAct alarm database.

systemDN One NV pair of

Y Name of NV pair is the SYSTEM_DN of interface At-tributeNameValue of module NotificationIRPConstDefs.Value of NV pair is a string. The value rep-resents the 3GPP DN of the IRP agent.

probableCause One NV pair of filterable_body_fields

PROBABLE_CAUSE of interface AttributeNameValue of module AlarmIRPConstDefs.Value of NV pair is a short defined by inter-face ProbableCause of module AlarmIRPConstDefs. The value is represents the probable cause of the alarm in NetAct alarm database. perceivedSeverity One NV pair of

(32)

of interface AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a string.

alarmId One NV pair of

ALARM_IDof interface Attribute-NameValue of module AlarmIRP-ConstDefs. Value of NV pair is a string. The string is a concatena-tion of several attributes of the NSN alarm. The parameter has to be stored in the remainder body ac-cording to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

clearUserId One NV pair of filterable_body_fields

CLEAR_USER_ID of interface AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a string. The value repres-ents the ID of the user who can-celled (cleared) the alarm in Net-Act (NSN alarm database attrib-ute “cancelled_by”). The paramet-er has to be stored in the remaindparamet-er body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields. clearSystemId One NV pair of

remainder_body

CLEAR_SYSTEM_ID of interface AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a string. The value repres-ents the ID of the system where the user has cancelled (cleared) the alarm. The parameter has to be stored in the remainder body ac-cording to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

(33)

- _{remainder_body} _Y

Notifcation notifyChangedAlarm

Table 40: Notifcation notifyChangedAlarm

NOTIFY_FM_CHANGED_ALARM of interface NotificationType of module AlarmIRPConstDefs.

alarmType event_name Y It identifies one of the following: • communications alarm • processing error alarm • environmental alarm • quality of service alarm • equipment alarm

Values are defined by interface AlarmType of module AlarmIRPCon-stDefs.

objectClass One NV pair of filterable_body_fields

MANAGED_OBJECT_CLASS of in-terface AttributeNameValue of mod-uleNotificationIRPConstDefs. Value of NVpair is a string. The string rep-resents the object class of the net-work element emitting the alarm. Possible values for 3GPP network re-source model are defined in [32.623], [32.633], [32.643] and [32.653]. objectInstance One NV pair of

MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The

(34)

string represents the 3GPP DN of the network element emitting the alarm. notificationId One NV pair of

probableCause One NV pair of filterable_body_fields

N

perceived Severity One NV pair of filterable_body_fields

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is an IRPTime of module Managed GenericIRPCon-stDefs. The value represents the alarm_time of the alarm in NetAct alarm database.

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

(35)

Value of NV pair is an IRPTime of module ManagedGenericIRPCon-stDefs. The value represents the alarm_time of the alarm in NetAct alarm database.

Notification notifyAckStateChanged

Table 41: Notification notifyAckStateChanged

Supported

NOTIFY_FM_ACK_STATE_CHANGED of interface NotificationType of module NotificationIRPConstDefs.

alarmType event_name Y It identifies one of the following: • communications alarm • processing error alarm • environmental alarm • quality of service alarm • equipment alarm

Values are defined by interface Alarm-Type of module AlarmIRPConstDefs.

managedObjectClass One NV pair of filter-able_ body_fields

MANAGED_OBJECT_CLASS of in-terface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The string represents the object class of the network element emitting the alarm. Possible values for 3GPP network resource model are defined in [32.623], [32.633], [32.643] and [32.653].

(36)

Supported

managedObjectIn-stance

One NV pair of filter-able_ body_fields

MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of mod-ule NotificationIRPConstDefs. Value of NV pair is a string. The string repres-ents the 3GPP DN of the network ele-ment emitting the alarm.

notification Id One NV pair of filter-able_ body_fields

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is an IRPTime of module ManagedGenericIRPCon-stDefs. The value represents the alarm_time of the alarm in NetActalarm database.

eventTime One NV pair of filter-able_ body_fields

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is an IRPTime of module ManagedGenericIRPCon-stDefs. The value represents the ack_time of the alarm in NetAct alarm database.

systemDN One NV pair of filter-able_ body_fields

Y Name of NV pair is the SYSTEM_DN of interface At-tributeNameValue of module

NotificationIRPConstDefs.Value of NV pair is a string. The valuere presents the 3GPP DN of the IRP agent. probableCause One NV pair of

filter-able_ body_fields

PROBABLE_CAUSE of interface At-tributeNameValue of moduleAlarmIRP-ConstDefs. Value of NV pair is a short defined by interface ProbableCause of module AlarmIRPConstDefs. The value is represents the probable cause of the alarm in NetAct alarm database.

(37)

Supported

perceived Severity One NV pair of filterable_body_fields

VENDER_SPECIFIC_ALARM_TYPE of interface AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a string.

Y Name of NV pair is the ALARM_ID of interface AttributeNameValue ofmod-ule AlarmIRPConstDefs. Value of NV pair is a string. The string is a concat-enation of several attributes ofthe NSN alarm. The parameter has to be stored in the remainder body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

ackUserId One NV pair of

Y Name of NV pair is the ACK_USER_ID of interface AttributeNameValue of module AlarmIRPConstDefs. Value of NV pair is a string. The value repres-ents the id of the user who acked the alarm in NetAct (NSN alarm database attribute “acked_by”). The paramet-er has to be stored in the remaindparamet-er body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

ackSystemId One NV pair of filterable_body_fields

ACK_SYSTEM_ID of interface Attrib-uteNameValue of module AlarmIRP-ConstDefs. Value of NV pair is a string. The value represents the id of the sys-tem which acked the alarm in Net-Act. The value is fixed “NNEM”. The parameter has to be stored in the re-mainder body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

(38)

Supported

ackState One NV pair of

Y Name of NV pair is the ACK_STATE of interface AttributeNameValue of mod-ule AlarmIRPConstDefs. Value of NV pair is a short defined by interface Ack-State of module AlarmIRPConstDefs. The value represents new ack_status of the alarm in NetAct alarm database. The parameter has to be stored in the remainder body according to [32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields

- _{remainder_body} _Y

Notification notifyAlarmListRebuilt

Table 42: Notification notifyAlarmListRebuilt

IS Parameters OMG CORBA Structured Event attribute

Supported

NOTIFY_FM_ALARM_LIST_REBUILT of interface NotificationType of module AlarmIRPConstDefs.

alarmType event_name Y This attribute is not defined in the spe-cification. Hence, the value is blank.

managedObjectClass One NV pair of filterable_body_fields

MANAGED_OBJECT_CLASS of in-terface AttributeNameValue of mod-ule NotificationIRPConstDefs. Value of NVpair is a string. The string rep-resents the object class of the network element emitting the alarm. Possible valuesfor 3GPP network resource model aredefined in [32.623], [32.633],

(39)

Supported

[32.643]and [32.653]. IRP Agent ob-ject class (Managed obob-ject class of the OMC(System)). managedObjectIn-stance One NV pair of filterable_body_fields Y Name of NV pair is MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of mod-ule NotificationIRPConstDefs. Value of NV pair is a string. The string repres-ents the 3GPP DN of the network ele-ment emitting the alarm. Value is DN of the IRP Agent (systemDN)

notification Id One NV pair of filterable_body_fields

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is an IRPTime of module ManagedGenericIRPCon-stDefs. The value represents the alarm_time of the alarm in NetAct alarm database. Value is a unique number.

Y Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a IRPTime of mod-ule ManagedGenericIRPConstDefs. The value represents the ack_time of the alarm in NetAct alarm database.

Y Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. The value represents the 3GPP DN of the IRP agent.

reason One NV pair of

Y Name of NV pair is the REASON of in-terface AttributeNameValue of mod-ule AlarmIRPConstDefs. Value of NV pair is fixed and it is “Mainten-ance”. The parameter has to be stored in the remainder body according to

(40)

Supported

[32.1113], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

alarmListAlignmentRe-quirement

One NV pair of filterable_body_fields

N

The alarm list rebuild in NetAct means manual administration work on the alarm database. After completion, the administrator can inform the 3GPP manager by sending a signal USR1 to the process

c3gcommx.

3.5 Entry Point IRP

The following table lists the EP IRP related functions. Table 43: EP IRP related functions:

getIRPOutline get_IRP_outline Y getIRPReference get_IRP_reference Y releaseIRPReference release_IRP_reference Y getIRPVersion get_EP_IRP_versions Y getOperationProfile get_EP_IRP_operations_profile Y getNotificationProfile get_EP_IRP_notification_profile Y notifyIRPInfoChanges push_structured_event Y

3.5.1 Supported operations

getIRPOutline

(41)

Table 44: getIRPOutline

IS Operation parameter SS Method parameter Supported by NetAct

iRPVersion ManagedGenericIRPConstDefs:: VersionNumber iRPVersion

Y

supportedIRPList EPIRPConstDefs::SupportedIRPListType suppor-tedIRPList

Y

status EPIRPConstDefs::ResultType Exception: GetIRP-Outline, InvalidIRPVersion

Y

getIRPReference

Table 45: getIRPReference

managerIdentifier EPIRPConstDefs::ManagerIdentifierType mana-gerIdentifier

Y

systemDn EPIRPConstDefs::DNType systemDn Y

iRPId EPIRPConstDefs::IRPIdType irpId Y

iRPReference string iRPReference (stringified IOR) Y

status EPIRPConstDefs::ResultType Exception: GetIR-PReference, InvalidRequestedParameters

Y

Note:

The IOR in the iRPReference contains the hostname of the server package, so the manager must be able to resolve the hostnames.

releaseIRPReference

Table 46: releaseIRPReference

IS Operation parameter SS Method parameter Supported by NetAct

managerIdentifier EPIRPConstDefs::ManagerIdentifierType mana-gerIdentifier

Y

(42)

IS Operation parameter SS Method parameter Supported by NetAct

status EPIRPConstDefs::ResultType Exception: Relea-seIRPReference, UnknownIRPReference

Y

getIRPVersion

Table 47: getIRPVersion

versionNumberSet Return value of type

ManagedGenericIRPConstDefs::VersionNumberSet Y

status Exception: GetEPIRPVersions Y

get_EP_IRP_operations_profile

Table 48: get_EP_IRP_operations_profile

IS Operation parameter SS Method parameter Supported by NetAct irpVersion ManagedGenericIRPConstDefs::VersionNumber iRPVersion Y operationNameProfile, oper-ationParameterProfile

Y

status Exceptions: GetEPIRPOperationsProfile,

ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter

Y

get_EP_IRP_notifications_profile

Table 49: get_EP_IRP_notifications_profile

IS Operation parameter SS Method parameter Supported by NetAct irpVersion ManagedGenericIRPConstDefs::VersionNumber irpVersion Y otificationNameProfile, notific-ationParameterProfile

(43)

status Exceptions: GetEPIRPNotificationProfile,

ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter

Y

3.6 Communication Surveillance (CS) IRP

The following table lists the CS IRP related functions. Table 50: CS IRP related functions

IS Operation/ Notification

3G TS 32.352 [32.352] SS Method SupportedbyNetAct

getHeartbeatPeriod get_heartbeat_period Y setHeartbeatPeriod set_heartbeat_period Y triggerHeartbeat trigger_heartbeat Y getIRPVersion get_CS_IRP_versions Y getOperationProfile get_CS_IRP_operations_profile Y getNotificationProfile get_CS_IRP_notification_profile Y notifyHeartbeat push_structured_event Y

3.6.1 Supported operations

getHeartbeatPeriod Table 51: getHeartbeatPeriod

IS Operation parameter SS Method parameter Suppor-tedby Net-Act hearbeatPeriod CSIRPConstDefs::HeartbeatPeriodType Y status CSIRPConstDefs::ResultType Exception: GetHeartbeatPeriod Y setHeartbeatPeriod

(44)

Table 52: setHeartbeatPeriod

IS Operation parameter SS Method parameter Suppor-tedby Net-Act hearbeatPeriod CSIRPConstDefs::HeartbeatPeriodType Y status CSIRPConstDefs::ResultType Exception: SetHeartbeatPeriod, InvalidHeartbeatPeriod,conflictingHeartbeatPeriod Y triggerHeartbeat Table 53: triggerHeartbeat

IS Operation parameter SS Method parameter Suppor-tedby Net-Act managerIdentifier CSIRPConstDefs::ManagerIdentifierType Y status CSIRPConstDefs::ResultType Exception: TriggerHeartbeat, InvalidManagerIdentifier Y Note:

All registered managers receive the heartbeat. Each manager receive one heartbeat for one call, because only one communication channel is used.

getIRPVersion

Table 54: getIRPVersion

IS Operation parameter SS Method parameter Supportedby NetAct

versionNumberSet Return value of type

ManagedGenericIRPConstDefs::VersionNumberSet Y status Exception: GetCSIRPVersions Y getOperationProfile

(45)

IS Operation parameter SS Method parameter Supportedby NetAct iRPVersion ManagedGenericIRPConstDefs::VersionNumber iRPVersion Y operationNameProfile, operationParameterProfile Return of type ManagedGenericIRPConstDefs::MethodList Y status Exception: GetCSIRPOperationsProfile, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter Y getNotificationProfile Table 56: getNotificationProfile

IS Operation parameter SS Method parameter Supportedby NetAct iRPVersion ManagedGenericIRPConstDefs::VersionNumber iRPVersion Y notificationNameProfile, notifiicationParameterPro-file Return of type ManagedGenericIRPConstDefs::MethodList Y status Exception: GetCSIRPNotificationProfile, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter Y

3.6.2 Supported Notifications

OMG Notification Service defines two styles of interaction: • push style

• pull style

NetAct supports only push style.

(46)

Table 57: notifyHeartbeat

IS Parameters OMG CORBA Structured Event attribute Suppor-tedby Net-Act Comment

- domain_name Y It carries the IRP document version number string. notificationType type_name Y Value is:

notifyHeartbeat of module of CSIRPNotification

- event_name Y It carries no information.

objectClass One NV pair of filterable_body _fields

Y _{Name of NV pair is MANAGED_OBJECT_CLASS} of interface AttributeNameValue of module Notifica-tionIRPConstDefs.

Value of NV pair is a string.

The string represents the object class of irp agent. objectInstance One NV pair of

filterable_body _fields

Y _{Name of NV pair is}

MANAGED_OBJECT_INSTANCE of interface Attrib-uteNameValue of module NotificationIRPConstDefs. Value of NV pair is a string.

The string represents the object instance of the irp agent.

notificationId One NV pair of remainder_of_ body

Y _{Name of NV pair is NOTIFICATION_ID of interface} AttributeNameValue of module NotificationIRPCon-stDefs.

Value of NV pair is a long.

The parameter has to be stored in the remainder body according to [32.363], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

eventTime One NV pair of filterable_body_ fields

Y _{Name of NV pair is the EVENT_TIME of interface} AttributeNameValue of moduleNotificationIRPCon-stDefs.

Value of NV pair is a IRPTime of moduleMan-agedGenericIRPConstDefs.

The value represents the time, when the event was created.

(47)

IS Parameters OMG CORBA Structured Event attribute Suppor-tedby Net-Act Comment

systemDN One NV pair of filterable_body_ fields

Y _{Name of NV pair is the SYSTEM_DN of interface} AttributeNameValue of module NotificationIRPCon-stDefs.

Value of NV pair is a string.

The value represents the 3GPP DN of the IRP agent. heartbeatPeri-od One NV pair of remainder_of_ body

Y _{Name of NV pair is the HEARTBEAT_PERIOD of} in-terface AttributeNameValue of module CSIRPCon-stDefs.

Value of NV pair is a

CSIRPConstDefs::HeartbeatPeriodType.

triggerFlag One NV pair of remainder_of_ body

Y _{Name of NV pair is the TRIGGER_FLAG of interface} AttributeNameValue of module CSIRPConstDefs. Value of NV pair is a

CSIRPConstDefs::TriggerFlagType.

locator One NV pair of remainder_of_ body

Y _{Name of NV pair is the CHANNEL_ID of interface} AttributeNameValue of module CSIRPConstDefs. Value of NV pair is a

CSIRPConstDefs::channelIdType and is always empty, because only one communication channel is used.

The parameter has to be stored in the remainder body according to [32.363], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields. managerIdenti-fier One NV pair of remainder_of_ body

Y _{Name of NV pair is the MANAGER_IDENTIFIER of} interface AttributeNameValue of module CSIRPCon-stDefs.

(48)

IS Parameters OMG CORBA Structured Event attribute Suppor-tedby Net-Act Comment Value of NV pair is a CSIRPConstDefs::ManagerIdentifierType. The parameter has to be stored in the remainder body according to [32.363], but no type is defined for the remainder body, so the attribute is stored in the filterable_body_fields.

Information Model for NetAct 3GPP CORBA Release 6 Northbound Interface EAL2.0

EAL 2.0