A.3 Solution Set (SS) definitions

28.3093GPPManagement of Quality of Experience (QoE) measurement collection Integration Reference Point (IRP)Release 17Solution Set (SS) definitionsTS

A.3.1 IDL definition structure

Clause A.3.2 defines the constants and types used by the QMC Management IRP.

Clause A.3.3 defines the operations which are performed by the QMC Management IRP agent.

Clause A.3.4 defines the notifications which are emitted by the QMC Management IRP agent.

A.3.2 IDL specification (file name "QMCIRPConstDefs.idl")

//File: QMCIRPConstDefs.idl

#ifndef _QMC_IRP_CONST_DEFS_IDL_

#define _QMC_IRP_CONST_DEFS_IDL_

#include <KernelCmConstDefs.idl>

// This statement shall appear after all include statements

#pragma prefix "3gppsa5.org"

/* ## Module: QMCIRPConstDefs

This module contains commonly used definitions for QMC IRP

===============================================================

*/

module QMCIRPConstDefs

{

enum Result Enum {SUCESS, FAILURE, PARTIAL_SUCCESS};

typedef struct QoeReference

{

short mcc;

short mnc;

unsigned long qmcId;

};

typedef sequence<QoEReference> QoEReferenceList;

typedef string QoeCollectionEntityAddress;

enum QmcTarget {AREA_BASED_QMC,INDIVIDUAL_BASED_UE };

enum ServiceType {DASH,MTSI};

typedef string QmcConfigurationFile;

typedef sequence <KernelCmConstDefs::DN> DNSet;

enum UnsupportedItem {MANAGED_ENTITY, QMC_TARGET, AREA_SCOPE, SERVICE_TYPE, PLMN_TARGET};

typedef sequence<UnsupportedItem> UnsupportedList;

/**

* This block identifies attributes which are included as part of the

* notifications defined within QMCIRP. These attribute values should not

* clash with those defined for the attributes of notification

* header (see IDL of Notification IRP).

*/

interface AttributeNameValue

{

const string QOE_REFERENCE = "QOE_REFERENCE";

const string QMC_TARGET = "QMC_TARGET";

const string MO_INSTANCE = "MO_INSTANCE";

const string REASON = "REASON";

};

};

A.3.3 IDL specification (file name “QMCIRPSystem.idl”)

//File: QMCIRPSystem.idl

#ifndef _QMC_IRP_SYSTEM_IDL_

#define _QMC_IRP_SYSTEM_IDL_

#include <KernelCmConstDefs.idl>

#include <GenericIRPManagementConstDefs.idl>

#include <GenericIRPManagementSystem.idl>

#include <QMCIRPConstDefs.idl>

//This statement shall appear after all include statements

#pragma prefix "3gppsa5.org"

/* Module: QMCIRPSystem

This module contains the specification of all operations of QMC IRP Agent.

=============================================================================

*/

module QMCIRP

{

exception ActivateAreaQMCJob { string reason; };

exception NotUniqueQMCReference { string reason; };

exception DeactivateQMCJob { string reason; };

exception ListQMCJob { string reason; };

exception ListActivatedQMCJob { string reason; };

interface QMCIRP

{

/**

* Request to activate a QMCJob through Itf-N.

**/

QMCIRPConstDefs::ResultEnum activateAreaQMCJob (

in KernelCmConstDefs::DN moInstance,

in QMCIRPConstDefs::QoeReference qoeReference,

in QMCIRPConstDefs::QmcTarget qmcTarget,

in QMCIRPConstDefs::QoeCollectionEntityAddress qoeCollectionEntityAddress,

in QMCIRPConstDefs::DNSet areaScope,

in QMCIRPConstDefs::ServiceType serviceType,

in QMCIRPConstDefs::PLMNTarget pLMNTarget,

in QMCIRPConstDefs::QmcConfigurationFile qmcConfigurationFile,

out QMCIRPConstDefs:: UnsupportedList unsupportedList

)

raises (ActivateAreaQMCJob,

NotUniqueQoEReference,

GenericIRPManagementSystem::InvalidParameter,

GenericIRPManagementSystem::ValueNotSupported,

GenericIRPManagementSystem::OperationNotSupported

);

/**

* Request to deactivate a QMCJob through Itf-N.

**/

QMCIRPConstDefs::ResultEnum deactivateQMCJob (

in KernelCmConstDefs::DN moInstance,

in QMCIRPConstDefs::QoeReference qoeReference,

in QMCIRPConstDefs::QmcTarget qmcTarget,

out QMCIRPConstDefs:: UnsupportedList unsupportedList)

raises (DeactivateQMCJob,

NotUniqueQoEReference,

GenericIRPManagementSystem::InvalidParameter,

GenericIRPManagementSystem::ValueNotSupported,

GenericIRPManagementSystem::OperationNotSupported);

/**

* Request to list the parameters of a specific QMCJob through Itf-N.

**/

QMCIRPConstDefs::ResultEnum listQMCJob (

in QMCIRPConstDefs::QoeReference qoeReference,

out KernelCmConstDefs::DN moInstance,

out QMCIRPConstDefs::QoeReference qoeReference,

out QMCIRPConstDefs::QmcTarget qmcTarget,

out QMCIRPConstDefs::QoeCollectionEntityAddress qoeCollectionEntityAddress,

out QMCIRPConstDefs::ServiceType serviceType,

out QMCIRPConstDefs::DNSet areaScope,

out QMCIRPConstDefs::PLMNTarget pLMNTarget,

out QMCIRPConstDefs::QmcConfigurationFile qmcConfigurationFile

)

raises (ListQMCJob,

NotUniqueQoEReference,

GenericIRPManagementSystem::InvalidParameter,

GenericIRPManagementSystem::ValueNotSupported,

GenericIRPManagementSystem::OperationNotSupported);

/**

* Request to list the activated QMCJobs through Itf-N.

**/

QMCIRPConstDefs::ResultEnum listActivatedQMCJob (

out QMCIRPConstDefs:: QoEReferenceList qoeReferenceList)

raises (ListActivatedQMCJob,

GenericIRPManagementSystem::InvalidParameter,

GenericIRPManagementSystem::ValueNotSupported,

GenericIRPManagementSystem::OperationNotSupported);

};

};

#endif // _QMC_IRP_SYSTEM_IDL_

A.3.4 IDL specification (file name “QMCIRPNotifications.idl”)

//File: QMCIRPNotifications.idl

#ifndef _QMC_IRP_NOTIFICATIONS_IDL_

#define _QMC_IRP_NOTIFICATIONS_IDL_

#include <QMCIRPConstDefs.idl>

#include <NotificationIRPNotifications.idl>

// This statement shall appear after all include statements

#pragma prefix "3gppsa5.org"

/* Module: QMCIRPNotifications

This module contains the specification of all notifications of QMC IRP Agent.

=============================================================================

*/

module QMCIRPNotifications

{

/**

* Constant definitions for the notifyNetworkRequestSessionFailure notification

**/

interface NotifyNetworkRequestSessionFailure: NotificationIRPNotifications::Notify

{

const string EVENT_TYPE = "notifyNetworkRequestSessionFailure";

/**

* This constant defines the name of the QoeReference property.

* The data type for the value of this property is

* QMCIRPConstDefs::QoeReference.

**/

const string QOE_REFERENCE = QMCIRPConstDefs::AttributeNameValue::QOE_REFERENCE;

/**

* This constant defines the name of the reason property.

* The data type for the value of this property is string.

*/

const string REASON = QMCIRPConstDefs::AttributeNameValue::REASON;

};

};

#endif // _QMC_IRP_NOTIFICATIONS_IDL_

Annex B (normative):
XML definitions