6 Interface Definition
28.3083GPPInformation Service (IS)Quality of Experience (QoE) measurement collection Integration Reference Point (IRP)Release 17Telecommunication managementTS
6.1 Class diagram representing interfaces
Each interface is defined in one or more UML compliant class diagrams (see also TS 32.156 [13]).
6.2 Generic rules
Rule 1: each operation with at least one input parameter supports a pre-condition valid_input_parameter which indicates that all input parameters shall be valid with regards to their information type. Additionally, each such operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition valid_input_parameter is false. The exception has the same entry and exit state.
Rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions supported_optional_input_parameter_yyy where "yyy" is the name of the optional input parameter and the
pre-condition indicates that the operation supports the named optional input parameter. Additionally, each such operation supports an exception operation_failed_unsupported_optional_input_parameter_yyy which is raised when (a) the pre-condition supported_optional_input_parameter_yyy is false and (b) the named optional input parameter is carrying information. The exception has the same entry and exit state.
Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised when an internal problem occurs and that the operation cannot be completed. The exception has the same entry and exit state.
NOTE: These rules are mapped at the solution set level. Pre-conditions and exceptions, generated by these rules, need not appear explicitly in the present document.
6.3 QoEIRPManagement Interface (M)
6.3.1 Operation activateAreaQMCJob (M)
6.3.1.1 Definition
This operation support IRPManager’s request to create an AreaQMCJob through Itf-N.
Once the AreaQMCJob has been created, the attributes of the QMCJob will not be modified during the lifetime of the QMCJob.
One QMCJob can manage network request sessions in one or more ManagedEntity.
|
Referenced TS |
Requirement label |
Comment |
|
TS 28.307 [3] |
REQ-EUSPC-FUN-1 |
6.3.1.2 Input parameters
|
Parameter Name |
Qualifier |
Information type |
Comment |
|---|---|---|---|
|
iOCInstance |
M |
ManagedEntity.objectInstance |
It specifies the DN of ManagedEntity instance where QMC session is to be activated. |
|
qoEReference |
M |
QMCJob.qoeReference |
It identifies the QMC Session. |
|
qMCTarget |
M |
QMCJob.qMCTarget |
It specifies if the QMC is areabased or individual UE based. In the present release only area based is supported. |
|
qoECollectionEntityAddress |
M |
QMCJob.qoECollectionEntityAddress |
It specifies the address to the QoE Collection Entity that is associated to the QMCJob. See TS 32.422 [9]. |
|
serviceType |
M |
QMCJob.serviceType |
It specifies which service is to record information. |
|
areaScope |
M |
QMCJob.areaScope |
It specifies the area (Cells/TA/RA/LA) where the QoE measurements shall be collected. |
|
pLMNTarget |
CM |
QMCJob.pLMNTarget |
It specifies which PLMN that the subscriber of the session to be recorded uses as selected PLMN. |
|
qMCConfigurationFile |
M |
QMCJob.qMCConfiguration.File |
It specifies the configuration of the QoE measurement to be recorded. See TS 26.247 [4] for DASH and TS 26.114 [9] for MTSI. |
6.3.1.3 Output parameters
|
Parameter Name |
Qualifier |
Matching Information |
Comment |
|---|---|---|---|
|
status |
M |
ENUM (Success, Failure, PartialSuccess) |
|
|
unsupportedList |
M |
List of <ManagedEntity, qMCTarget, areaScope, serviceType, pLMNTarget) |
It specifies what attributes are not supported when a QMC session is activated. The list can contain one or all of the elements and relevant only for error cases. |
6.3.1.4 Pre-condition
validQoEReference
|
Assertion Name |
Definition |
|
validQoEReference |
The qoEReference input parameter is valid, which means that the QMCIRP is aware of such QMCJob, which has this qoEReference value and is aware of the ManagedEntity holding such network request session. |
6.3.1.5 Post-condition
networkRequestSessionisactivated
|
Assertion Name |
Definition |
|
networkRequestSessionisactivated |
The network request session identified by the qoEReference is activated in the requested ManagedEntity instance and the QMCJob is started. |
6.3.1.6 Exceptions
6.3.1.6.1 notuniqueQoEReference
|
Exception Name |
Definition |
|---|---|
|
notuniqueQoEReference |
Condition: (validqoEReference) is false. Returned Information: output parameter status is set to "Failure". Exit state: Entry State. |
6.3.2 Operation deactivateQMCJob (M)
6.3.2.1 Definition
This operation supports IPRManager’s request to stop a QMCJob through Itf-N. When this operation is received in the requested ManagedEntity instances the network request session shall be deactivated.
|
Referenced TS |
Requirement label |
Comment |
|
TS 28.307 [3] |
REQ-EUSPC-FUN-3 |
6.3.2.2 Input parameters
|
Parameter Name |
Qualifier |
Information type |
Comment |
|---|---|---|---|
|
iOCInstance |
M |
ManagedEntity.objectInstance |
It specifies the DN of ManagedEntity instance where QMC session is to be deactivated. |
|
qoEReference |
M |
QMCJob.qoeReference |
It identifies the QMC Session. |
|
qMCTarget |
M |
QMCJob.qMCTarget |
It specifies if the QMC is area based or individual UE based. In the present release only area based is supported. |
6.3.2.3 Output parameters
|
Parameter Name |
Qualifier |
Matching Information |
Comment |
|---|---|---|---|
|
status |
M |
ENUM (Success, Failure, PartialSuccess) |
The operation may fail because of a specified or an unspecified reason. |
|
unsupportedList |
M |
List of <ManagedEntity, qoEReference, qMCTarget) |
It specifies what attributes are not supported when a QMC session is activated. The list can contain one or all of the elements and relevant only for error cases. |
6.3.2.4 Pre-condition
validQoEReference
|
Assertion Name |
Definition |
|
validQoEReference |
The qoEReference input parameter is valid, which means that the QMCIRP is aware of such QMCJob, which has this qoEReference value and is aware of the ManagedEntity holding such network request session. |
6.3.2.5 Post-condition
networkRequestSessionisdeactivated
|
Assertion Name |
Definition |
|
networkRequestSessionisdeactivate |
The network request session identified by the qoEReference is deactivated in the requested ManagedEntity instance and the QMCJob is stopped. |
6.3.2.6 Exceptions
|
Exception Name |
Definition |
|---|---|
|
notuniqueQoEReference |
Condition: (validQoECReference) is false. Returned Information: output parameter status is set to "Failure". Exit state: Entry State. |
6.3.3 Operation listQMCJob (M)
6.3.3.1 Definition
This operation support IPRManager’s request to list the parameters of a specific QMCJob through Itf-N.
6.3.3.2 Input parameters
|
Parameter Name |
Qualifier |
Information type |
Comment |
|---|---|---|---|
|
qoEReference |
M |
QMCJob.qoEReference |
It specifies the network request session that is requested for interrogation. |
6.3.3.3 Output parameters
|
Parameter Name |
Qualifier |
Matching Information |
Comment |
|---|---|---|---|
|
iOCInstance |
M |
ManagedElement.objectInstance |
It specifies the DN of ManagedElement instance where a network request session is requested to be listed. |
|
Status |
M |
ENUM (Success, Failure) |
The operation may fail because of a specified or an unspecified reason. |
|
qoEReference |
M |
QMCJob.qoeReference |
It identifies the network request session. |
|
qMCTarget |
M |
QMCJob.qMCTarget |
It specifies if the QMC is area based or individual UE based. In the present release only area based is supported. |
|
qoECollectionEntityAddress |
M |
QMCJob.qoECollectionEntityAddress |
It specifies the address to the QoE Collection Entity that is associated to the QMCJob. See TS 32.422 [9]. |
|
serviceType |
M |
QMCJob.serviceType |
It specifies which service is to record information. |
|
areaScope |
M |
QMCJob.areaScope |
It specifies the area (Cells/TA/RA/LA) in which the QMC is to be performed. |
|
pLMNTarget |
CM |
QMCJob.pLMNTarget |
It specifies which PLMN that the subscriber of the session to be recorded uses as selected PLMN. |
|
qMCConfigurationFile |
M |
QMCJob.qMCConfiguration.File |
It specifies the configuration of the QoE measurement to be recorded. See TS 26.247 [4] for DASH and TS 26.114 [9] for MTSI. |
6.3.3.4 Pre-condition
validQoEReference
|
Assertion Name |
Definition |
|
validQoEReference |
The qoEReference input parameter is valid, which means that the QMCIRP is aware of such QMCJob, which has this qoEReference value and is aware of the ManagedEntity holding such network request session. |
6.3.3.5 Post-condition
qoEReferenceFound
|
Assertion Name |
Definition |
|
qoEReferenceFound |
The QMCIRP has found the requested QMCJob with the qoEReference and can read the configured parameters. |
6.3.3.6 Exceptions
|
Exception Name |
Definition |
|---|---|
|
notuniqueQoEReference |
Condition: (validQoEReference) is false. Returned Information: output parameter status is set to "Failure". Exit state: Entry State. |
6.3.4 Operation listActivatedQMCJobs (M)
6.3.4.1 Definition
This operation support IRPManager’s request to list all the activated QMCJobs through Itf-N.
6.3.4.2 Input parameters
No input parameters for this operation.
6.3.4.3 Output parameters
|
Parameter Name |
Qualifier |
Matching Information |
Comment |
|---|---|---|---|
|
qoEReferenceList |
M |
List of < QMCJob.qoeReference.objectinstance > |
The qoEReferenceList provides the identification of each activated network request session. If no qoEReference can be found, then this list is empty and status is "Success" |
|
status |
M |
ENUM (Success, Failure) |
The operation may fail because of a specified or an unspecified reason. |
6.3.5 Notification notifyNetworkRequestSessionFailure (O)
6.3.5.1 Definition
The QMCIRP notifies all subscribed IRPManagers and the QoE Collection Entity if a network request session in a ManagedEntity has not been started due to any problem.
6.3.5.2 Input parameters
|
Parameter Name |
Qualifiers |
Matching Information |
Comment |
|---|---|---|---|
|
objectClass |
M,Y |
QMCIRP.objectClass |
Notification header |
|
objectInstance |
M,Y |
QMCIRP.objectInstance |
Notification header |
|
eventTime |
M,Y |
— |
Notification header |
|
notificationType |
M,Y |
"notifyNetworkRequestSessionFailure" |
Notification header |
|
systemDN |
M,Y |
— |
Notification header |
|
notificationID |
O,Y |
— |
Notification header |
|
qoEReference |
M,Y |
QMCJob.qoEReference |
|
|
reason |
O,N |
— |
6.3.5.3 Triggering event
6.3.5.3.1 From state
problemInManagedEntity
|
Assertion Name |
Definition |
|
problemInManagedEntity |
Because of a problem the ManagedEntity cannot start a network request session. |
6.3.5.3.2 To state
NetworkRequestSessionFailureReported
|
Assertion Name |
Definition |
|
NetworkRequestSessionFailureReported |
The "notifyNetworkRequestSessionFailure" notification is emitted to the subscribed IRPManager(s). |
Annex A (informative):
Change history
|
Change history |
|||||||
|
Date |
Meeting |
TDoc |
CR |
Rev |
Cat |
Subject/Comment |
New version |
|
2017-10 |
SA5#115 |
S5-175400 |
R15 pCR 28.308-000 Introduction and Scope for QoE IRP Information Service |
0.1.0 |
|||
|
2017-10 |
SA5#115 |
S5-175160 |
Rel-15 pCR 28.308 References and System Overview for QoE IRP Information Service |
0.1.0 |
|||
|
2017-10 |
SA5#115 |
S5-175402 |
pCR 28.308 Information Object Classes and Interface Definition for QoE IRP Information Service |
0.1.0 |
|||
|
2019-08 |
SA5#126 |
S5-195504 |
Scope |
0.2.0 |
|||
|
2019-08 |
SA5#126 |
S5-195506 |
Add QMCJob |
0.2.0 |
|||
|
2020-03 |
SA5#129e |
S5-2013889 |
Rapporteur’s clean up (using new TS template) |
0.3.0 |
|||
|
2020-03 |
SA5#129e |
S5-201396 |
Remove SBA |
0.3.0 |
|||
|
2020-04 |
SA5#130e |
S5-202302 |
pCR R16 28308-030 QMC operations |
0.4.0 |
|||
|
2020-06 |
SA5#131e |
S5-203328 |
Addition of QMC operations and notifications |
0.5.0 |
|||
|
2020-06 |
SA5#131e |
EditHelp review (editorial and introduction of explanation of modal verbs). |
0.5.1 |
||||
|
2020-06 |
SA#88-e |
SP-200475 |
Presented for information and approval |
1.0.0 |
|||
|
2020-07 |
SA#88e |
Upgrade to change control version |
16.0.0 |
||||
|
2022-03 |
– |
– |
– |
– |
– |
Update to Rel-17 version (MCC) |
17.0.0 |