11.1 Generic provisioning management service
28.5323GPPGeneric management servicesManagement and orchestrationRelease 17TS
11.1.0 Introduction
This clause provides the stage 2 definitions of Create, Read, Update and Delete (CRUD) operations for managing managed objects. According to clause 4.2.2 of TS 28.533 [13], these CRUD operations are the MnS component type A. The operations specified in this clause in combination with a NRM (MnS component type B) constitute a MnS, as defined in clause 4.3 of TS 28.533 [13].
In addition, notifications to report changes related to managed objects and their attributes are specified.
11.1.1 Operations and notifications
11.1.1.1 createMOI operation
11.1.1.1.1 Description
This operation is invoked by MnS consumer to request the MnS producer to create a Managed Object instance in the MIB maintained by MnS producer. This operation will create only one Managed Object instance.
The MnS consumer supplies the values of all attributes that are supported, i.e. a) attributes whose Support Qualifier is M and b) attributes whose Support Qualifier is O. The special cases are:
1) If the attribute has a default value specified. In such case, if the MnS consumer supplies a value, the supplied value is used; otherwise, the default value is used.
2) If the attribute is specified as capable of carrying a null value or carrying no information. In such case, if the Generic Provisioning MnS consumer supplies a (non-null) value, the supplied value is used; otherwise, the null value is used.
3) If the attribute does not have a default value specified and is specified as incapable of carrying null value and incapable of carrying no information, if there is a MnS producer defined default value, then that value will be used.
11.1.1.1.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
managedObjectClass |
M |
class |
This parameter specifies the class of the new managed object instance. |
managedObjectInstance |
M |
DN |
This parameter specifies the instance of the managed object that is to be created and registered. This is a full DN according to 3GPP TS 32.300 [5]. |
attributeListIn |
M |
LIST OF SEQUENCE< attribute name, attribute value> |
This parameter may have a null value. When this parameter is supplied, it contains a list of name/value pairs specifying attribute identifiers and their values to be assigned to the new managed object. These values override the values for the corresponding attributes derived from the default value set specified in the definition of the managed object’s class. |
11.1.1.1.3 Output parameters
Parameter name |
S |
Matching Information / Legal Values |
Comment |
attributeListOut |
M |
LIST OF SEQUENCE< attribute name, attribute value> |
This list of name/value pairs contains the attributes of the new managed object and the actual value assigned to each. |
status |
M |
ENUM (OperationSucceeded, OperationFailed) |
11.1.1.1.4 Results
In case of success, the ManagedEntity instance has been created with the supplied DN. In case of failure, indication of the failure is provided in the Output parameters.
11.1.1.2 getMOIAttributes operation
11.1.1.2.1 Definition
This operation is invoked by MnS consumer to request the retrieval of management information (Managed Object attribute names and values) from the MIB maintained by MnS producer. One or several Managed Objects may be retrieved – based on the containment hierarchy.
A SS may choose to split this operation in several operations (e.g. operations to get "handlers" or "iterators" to Managed Objects fulfilling the scope/filter criteria and other operations to retrieve attribute names/values from these "handlers").
11.1.1.2.2 Input Parameters
Name |
S |
Information Type |
Comment |
baseObjectInstance |
M |
DN |
This parameter specifies the base object instance. If the "scope" parameter is absent, then either only the base object or the complete subtree below and including the base object shall be selected. The default behaviour is protocol specific. |
scope |
M |
n/a |
This parameter specifies the scope. It is a structured parameter and consists of the sub-parameters "scopeType" and "scopeLevel". The scope describes which object instances are selected with respect to a base object instance. The base object instance needs to be specified using a dedicated attribute. |
> scopeType |
M |
ENUM { BASE_ONLY, BASE_ALL } |
If the optional "scopeLevel" parameter is not supported or absent, allowed values of "scopeType" are "BASE_ONLY" and "BASE_ALL". The value "BASE_ONLY" indicates only the base object is selected. The value "BASE_ALL" indicates the base object and all of its subordinate objects (incl. the leaf objects) are selected. This parameter is redundant and can be omitted when confirming only the protocol specific default behaviour. |
ENUM { BASE_NTH_LEVEL, BASE_SUBTREE } |
If the "scopeLevel" parameter is supported and present, allowed values of "scopeType" are "BASE_NTH_LEVEL" and "BASE_SUBTREE". The value "BASE_NTH_LEVEL" indicates all objects on the level, which is specified by the "scopeLevel" parameter, below the base object are selected. The base object is at "scopeLevel" zero. The value "BASE_SUBTREE" indicates the base object and all of its subordinate objects down to and including the objects on the level, which is specified by the "scopeLevel" parameter, are selected. The base object is at "scopeLevel" zero. |
||
> scopeLevel |
O |
Integer |
See definition of "scopeType" parameter. |
filter |
O |
See Comment. |
This parameter defines filter criteria to be applied to the objects selected by the "baseObjectInstance", "scope" and "scopeLevel" parameters. The actual syntax and capabilities of the filter is SS specific. However, each SS should support a filter consisting of one or several assertions that may be grouped using the logical operators AND, OR and NOT. Each assertion is a logical expression of attribute existence, attribute value comparison ("equal to X, less than Y" etc.) and MO Class. |
attributeListIn |
O |
LIST OF attribute name. |
This parameter identifies the attributes to be returned by this operation. If the parmeter is absent or empty all attributes shall be returned. |
11.1.1.2.3 Output Parameters
Name |
S |
Matching Information |
Comment |
managedObjectClass |
M |
ManagedEntity class |
For each returned MO: The class of the MO. |
managedObjectInstance |
M |
ManagedEntity DN |
For each returned MO: The name of the MO. This is a full DN according to 3GPP TS 32.300 [5]. |
attributeListOut |
M |
LIST OF SEQUENCE< attribute name, attribute value > |
For each returned MO: A list of name/value pairs for MO. |
status |
M |
ENUM (OperationSucceeded, OperationFailed) |
An operation may fail because of a specified or unspecified reason. |
11.1.1.2.4 Results
In case of success, all of the ManagedEntity instances selected for retrieval are returned. In case of failure, a specified or unspecified reason may be provided in the Output parameters.
11.1.1.3 modifyMOIAttributes operation
11.1.1.3.1 Description
This operation is invoked by MnS consumer to request the modification of one or more Managed Object instances from MnS producer. Attributes of one or several Managed Objects may be modified.
11.1.1.3.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
baseObjectInstance |
M |
DN |
The MO instance that is to be used as the starting point for the selection of managed objects to which the filter (when supplied) is to be applied. This is a full DN according to 3GPP TS 32.300 [5]. |
scopeType |
M |
See corresponding parameter in getMOIAttributes. |
See corresponding parameter in getMOIAttributes. |
scopeLevel |
O |
See corresponding parameter in getMOIAttributes. |
See corresponding parameter in getMOIAttributes. |
filter |
O |
See comment. |
See corresponding parameter in getMOIAttributes. |
modificationList |
M |
LIST OF SEQUENCE <attribute identifier, [attribute values], ENUM( replace, add values, remove values, set to default)> See Comment for when attribute values are require and when they are optional. |
This parameter contains a set of attribute modification specifications, each of which contains: 1). attribute identifier: the identifier of the attribute whose value(s) is (are) to be modified. 2). attribute value: the value(s) to be used in the modification of the attribute. The use of this parameter is defined by the modify operator. This parameter is optional when the set to default modify operator is specified and if supplied, shall be ignored. 3). modify operator: the way in which the attribute values(s) (if supplied) is(are) to be applied to the attribute. The possible operators are: a) replace: the attribute value(s) specified shall be used to replace the current values(s) of the attribute; b) add values: the attribute values(s) specified shall be added to the current value(s) of the attribute. This operator shall only be applied to a set-valued attribute and shall perform a set union (in the mathematical sense) between the current values(s) of the attribute and the attribute value(s) specified. Value(s) specified in the attribute value parameter which is(are) already in the current values of the attribute shall not cause an error to be returned. c) remove values: the attribute value(s) specified shall be removed from the current values(s) of the attribute. This operator shall only be applied to a set-valued attribute and shall perform a set difference (in the mathematical sense) between the current value(s) of the attribute and the attribute values(s) specified. Value(s) specified in the attribute value parameter which is(are) not in the current value(s) of the attribute shall not cause an error to be returned; d) set to default: when this operator is applied to a single-valued attribute, the value of the attribute shall be set to its default value. When this operator is applied to a set–valued attribute, the value(s) of the attribute shall be set to their default value(s) and only as many values as defined by the default shall be assigned. If there is no default value defined, an error shall be returned. Note: Set is used here in the mathematical sense so that a set-valued attribute is an unordered set of unique values. The modify operator is optional, and if it is not specified, the replace operator shall be assumed. The modificationList parameter contains a single set of attribute modification specifications and this same set is applied to each MO instance to be modified. |
11.1.1.3.3 Output parameters
Parameter name |
S |
Matching Information / Legal Values |
Comment |
modificationListOut |
M |
LIST OF SEQUENCE< ManagedEntity DN, ManagedEntity class, LIST OF SEQUENCE< attribute name, attribute value >> |
This parameter will provide for each managed object instance the full DN of the managed object instance, the managedObjectClass, and a list of name/value pairs with the values of all the attributes of the modified managed object instance after modification. The form of this information is SS dependant and may be provided in one or many data structures. |
status |
M |
ENUM (OperationSucceeded, OperationFailed, OperationPartiallySucceeded) |
An operation may fail because of a specified or unspecified reason and no attributes have been updated. The operation is only successful if all specified attributes of all selected objects are actually modified. Otherwise, the operation is partially successful. |
In lieu of a synchronization parameter, best effort synchronization will apply; that is, all managed objects selected for this operation will perform the operation if possible regardless of whether some managed objects fail to perform it.
11.1.1.3.4 Results
In case of success, all of the ManagedEntity instances selected for modification are modified. In case of failure, a specified or unspecified reason may be provided in the Output parameters.
11.1.1.4 deleteMOI operation
11.1.1.4.1 Description
This operation is invoked by MnS consumer to request the deletion of one or more Managed Object instances in the MIB maintained by the MnS producer.
11.1.1.4.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
baseObjectInstance |
M |
DN |
The MO instance that is to be used as the starting point for the selection of managed objects to which the filter (when supplied) is to be applied. This is a full DN according to 3GPP TS 32.300 [5]. |
scopeType |
O |
See corresponding parameter in getMOIAttributes. |
See corresponding parameter in getMOIAttributes. |
scopeLevel |
O |
See corresponding parameter in getMOIAttributes. |
See corresponding parameter in getMOIAttributes. |
filter |
O |
See comment. |
See corresponding parameter in getMOIAttributes. |
11.1.1.4.3 Output parameters
Parameter name |
S |
Matching Information / Legal Values |
Comment |
deletionList |
M |
LIST OF SEQUENCE< ManagedEntity DN, ManagedEntity class name> |
If the base object alone is specified, then this parameter is optional; otherwise it contains a list of managedObjectInstance/managedObjectClass pairs identifying the managed objects deleted. |
status |
M |
ENUM (OperationSucceeded, OperationFailed, OperationPartiallySucceeded) |
An operation may fail because of a specified or unspecified reason. The operation is partially successful if some, but not all, objects selected to be deleted are actually deleted. |
In lieu of a synchronization parameter, best effort synchronization will apply; that is, all managed objects selected for this operation will perform the operation if possible regardless of whether some managed objects fail to perform it.
11.1.1.4.4 Results
In case of success, all of the ManagedEntity instances selected for deletion are deleted. In case of failure, a specified or unspecified reason may be provided in the Output parameters.
11.1.1.5 Void
11.1.1.6 Void
11.1.1.7 Notification notifyMOICreation
11.1.1.7.1 Definition
This notification notifies the subscribed consumers that a new Managed Object Instance has been created.
11.1.1.7.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
objectClass |
M |
It shall carry the ManagedEntity class name. |
It specifies the class name of the IOC. A network event has occurred in an instance of this class. |
objectInstance |
M |
It shall carry the DN of the ManagedEntitiy. |
It specifies a new instance of the above IOC in which the network event related to by carrying the Distinguished Name (DN) for the instance. |
notificationId |
M |
This is an identifier for the notification, which may be used to correlate notifications. |
The identifier of the notification shall be chosen to be unique across all notifications of a particular managed object instance throughout the time that correlation is significant, it uniquely identifies the notification from other notifications generated by the subject MOI. |
notificationType |
M |
It specifies the type of provisioning management services related notifications. The value “notifyMOICreation” shall be carried. |
It specifies the type of notification. |
eventTime |
M |
It indicates the MOICreation event time. |
The semantics of Generalised Time specified by ITU-T[17] shall be used here. |
systemDN |
M |
It shall carry the DN of management service providers. |
– |
correlatedNotifications |
CM |
It specifies a set of notifications that are correlated to the subject notification. |
The condition is that the MnS producer support the correlation of notifications |
additionalText |
O |
It can contain further information in text on the event of the ManagedEntity(s). |
– |
sourceIndicator |
O |
ENUM( Resource_operation, Management_operation, SON_operation,Unknown) |
This parameter, when present, indicates the source of the operation that led to the generation of this notification. It can have one of the following values: 1. resource operation: The notification was generated in response to an internal operation of the resource; 2. management operation: The notification was generated in response to a management operation applied across the managed object boundary external to the managed object; 3. SON operation: The notification was generated as result of a SON (Self Organising Network) process like self-configuration, self-optimization, self-healing etc. . 4. unknown: It is not possible to determine the source of the operation. Remark: A provisioning MnS provider may not in any case be aware that SON operation lead to the generation of this generation. In this case another value than SON_operation for sourceIndicator might be sent. |
attributeList |
O |
LIST OF SEQUENCE <AttributeName, AttributeValue> |
The attributes (name/value pairs) of the created MOI. |
11.1.1.7.3 Triggering event
11.1.1.7.3.1 From-state
stateBeforeObjectCreation.
Assertion Name |
Definition |
stateBeforeObjectCreation |
The number of instances of the IOC ManagedEntity is equal to N. |
11.1.1.7.3.2 To-state
stateAfterObjectCreation.
Assertion Name |
Definition |
stateAfterObjectCreation |
The number of instances of the IOC ManagedEntity is equal to N + 1. |
11.1.1.8 Notification notifyMOIDeletion
11.1.1.8.1 Definition
This notification notifies the subscribed consumers that an existing Managed Object Instance has been deleted.
11.1.1.8.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
objectClass |
M |
It shall carry the ManagedEntity class name. |
It specifies the class name of the IOC. A network event has occurred in an instance of this class. |
objectInstance |
M |
It shall carry the DN of the ManagedEntitiy. |
It specifies an existing instance of the above IOC in which the network event related to by carrying the Distinguished Name (DN) for the instance. |
notificationId |
M |
This is an identifier for the notification, which may be used to correlate notifications. |
The identifier of the notification shall be chosen to be unique across all notifications of a particular managed object throughout the time that correlation is significant, it uniquely identifies the notification from other notifications generated by the subject MOI. |
notificationType |
M |
It specifies the type of provisioning management services related notifications. The value “notifyMOIDeletion” shall be carried. |
It specifies the type of notification. |
eventTime |
M |
It indicates the MOIDeletion event time. |
The semantics of Generalised Time specified by ITU-T[17] shall be used here. |
systemDN |
M |
It shall carry the DN of management service providers. |
– |
correlatedNotifications |
CM |
It specifies a set of notifications that are correlated to the subject notification. |
The condition is that the MnS producer support the correlation of notifications |
additionalText |
O |
It can contain further information in text on the event of the ManagedEntity(s). |
– |
sourceIndicator |
O |
ENUM( Resource_operation, Management_operation, SON_operation,Unknown) |
This parameter, when present, indicates the source of the operation that led to the generation of this notification. It can have one of the following values: 1. resource operation: The notification was generated in response to an internal operation of the resource; 2. management operation: The notification was generated in response to a management operation applied across the managed object boundary external to the managed object; 3. SON operation: The notification was generated as result of a SON (Self Organising Network) process like self-configuration, self-optimization, self-healing etc. . 4. unknown: It is not possible to determine the source of the operation. Remark: A provisioning MnS provider may not in any case be aware that SON operation lead to the generation of this generation. In this case another value than SON_operation for sourceIndicator might be sent. |
attributeList |
O |
LIST OF SEQUENCE <AttributeName, AttributeValue> |
The attributes (name/value pairs) of the deleted MOI. |
11.1.1.8.3 Triggering event
11.1.1.8.3.1 From-state
stateBeforeObjectDeletion.
Assertion Name |
Definition |
stateBeforeObjectDeletion |
The number of instances of the IOC ManagedEntity is equal to N. |
11.1.1.8.3.2 To-state
stateAfterObjectDeletion.
Assertion Name |
Definition |
stateAfterObjectDeletion |
The number of instances of the IOC ManagedEntity is equal to N – 1. |
11.1.1.9 Notification notifyMOIAttributeValueChanges
11.1.1.9.1 Definition
This notification notifies the subscribed MnS consumers that changes of one or several attributes of a Managed Object Instance in the NRM.
11.1.1.9.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
objectClass |
M |
It shall carry the ManagedEntity class name. |
It specifies the class name of the IOC. A network event has occurred in an instance of this class. |
objectInstance |
M |
It shall carry the DN of the ManagedEntitiy. |
It specifies the existing instance of the above IOC in which the network event related to by carrying the Distinguished Name (DN) for the instance. |
notificationId |
M |
This is an identifier for the notification, which may be used to correlate notifications. |
The identifier of the notification shall be chosen to be unique across all notifications of a particular managed object throughout the time that correlation is significant, it uniquely identifies the notification from other notifications generated by the subject Information Object. |
notificationType |
M |
It specifies the type of provisioning management services related notifications. The value “notifyMOIAttributeValueChange” shall be carried. |
It specifies the type of notification. |
eventTime |
M |
It indicates the MOIAttributeValueChange event time. |
The semantics of Generalised Time specified by ITU-T[17] shall be used here. |
systemDN |
M |
It shall carry the DN of management service providers. |
– |
correlatedNotifications |
CM |
It specifies a set of notifications that are correlated to the subject notification. |
The condition is that the MnS producer support the correlation of notifications |
additionalText |
O |
It can contain further information in text on the event of the ManagedEntity(s). |
– |
sourceIndicator |
O |
ENUM( Resource_operation, Management_operation, SON_operation,Unknown) |
This parameter, when present, indicates the source of the operation that led to the generation of this notification. It can have one of the following values: 1. resource operation: The notification was generated in response to an internal operation of the resource; 2. management operation: The notification was generated in response to a management operation applied across the managed object boundary external to the managed object; 3. SON operation: The notification was generated as result of a SON (Self Organising Network) process like self-configuration, self-optimization, self-healing etc. . 4. unknown: It is not possible to determine the source of the operation. Remark: A provisioning MnS provider may not in any case be aware that SON operation lead to the generation of this generation. In this case another value than SON_operation for sourceIndicator might be sent. |
attributeValueChange |
M |
LIST OF SEQUENCE <AttributeName, NewAttributeValue, CHOICE [NULL, OldAttributeValue]> |
The changed attributes (name/value pairs) of the MOI (with both new and, optionally, old values). |
11.1.1.9.3 Triggering event
11.1.1.9.3.1 From-state
stateBeforeAttributeValueChange.
Assertion Name |
Definition |
stateBeforeAttributeValueChange |
The subject attribute has a value at time T1. |
11.1.1.9.3.2 To-state
stateAfterAttributeValueChange.
Assertion Name |
Definition |
|
stateAfterAttributeValueChange |
The subject attribute has been changed to a value other than the value at time T1. |
11.1.1.10 Notification notifyEvent
11.1.1.10.1 Definition
This notification notifies the MnS consumer, who has a subscription receiving this type of notification, that certain network events has occurred with potential service impact, for example, system restart and system redundancy shift (backup).
This notification definition is generic in the sense that the specific types of network event are not defined.
11.1.1.10.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
objectClass |
M |
It carries the IOC of an instance where an alert occurs. |
— |
objectInstance |
M |
It carries the DN of an instance where an alert occurs. |
— |
notificationId |
M |
It carries the identifier for the subject notification. |
See Note 1. |
eventTime |
M |
It indicates the time of the event. |
The semantics of Generalised Time specified by ITU-T [17] shall be used here. |
systemDN |
M |
It carries the DN of producer of the notification. |
— |
notificationType |
M |
"notifyEvent" |
— |
specificProblem |
M |
It indicates a problem detected. |
— |
additionalText |
O |
It carries additional information. |
— |
additionalInformation |
O |
It carries additional information. |
— |
NOTE 1: If consumer receives notifications from one producer, consumer can use the notificationId and the objectInstance to uniquely identify all received notifications. If consumer receives notifications from multiple producers and notifications of each objectInstance are reported to at most by one producer, consumer can use the notificationId and objectInstance to uniquely identify all received notifications. If consumer receives notifications from multiple producers and notifications of one or more objectInstance(s) are reported byo two or more producers, consumer can use the notificationId together with objectInstance and the identity of producer (systemDN), to uniquely identify all received notifications. If the information systemDN is absent, consumer needs other means, which are outside the scope of this TS, to determine the identity of producer. How notificationId of notifications are re-used to correlate notifications is outside of the scope of this specification. |
11.1.1.11 Notification notifyMOIChanges
11.1.1.11.1 Definition
This notification reports NRM updates to subscribed MnS consumers. It can report multiple NRM updates that happen at the same time. All possible NRM updates can be reported:
– Creation and deletion of an object.
– Creation and deletion of an attribute, attribute field, attribute element and attribute field element.
– Replacement of an attribute value, attribute field value, attribute element and attribute field element.
The MnS producer decides whether to send notifications of type notifyMOICreation, notifyMOIDeletion or notifyMOIAttributesValueChange, or a single notifyMOIChanges reporting all changes in a single notification. The MnS producer should take subscription information into account when deciding the notification types to be sent, and not try to send notifications that the MnS consumer did not subscribe to.
The notification header includes a notificationId. This identifier shall not be used in the parameter correlatedNotifications potentially carried in other notifications. The notificationId in mOIChanges shall be used instead. This is because the latter notification id is associated to a single MOI only, whereas the former notification id can be associated to changes of multiple MOIs. The correlatedNotifications associates to a single MOI one or more notification ids identifying notifications reporting events for that MOI.
In this clause the following definitions apply.
simple type: A value defined by a simple type is a scalar.
complex type: A value defined by a complex type is either a set of multiple (sub-)values (of the same simple or complex type), or a value containing one or more attribute fields.
attribute: An information element composed of an attribute name and an attribute value.
attribute name: The name of an attribute.
attribute value: The value of an attribute. The value is defined by a simple type or a complex type.
attribute field: An attribute contained inside an (top-level) attribute. Attribute fields can contain attribute fields.
attribute field name: The name of an attribute field.
attribute field value: The value of an attribute field. The value is defined by a simple type or a complex type.
simple attribute: Attribute whose value is defined by a simple type.
complex attribute: Attribute whose value is defined by a complex type.
structured attribute: Special kind of complex attribute containing at least one attribute field, but usually multiple attribute fields with different data types.
multi-value attribute: Special kind of complex attribute with multiplicity greater than "1", i.e. an attribute whose value is composed of multiple (sub-)values (of the same simple or complex type).
attribute element: Single (sub-) value of the value of a multi-value attribute.
attribute field element: Single (sub-) value of the value of a multi-value attribute field.
11.1.1.11.2 Input parameters
Parameter Name |
S |
Information Type / Legal Values |
Comment |
objectClass |
M |
See clause 11.1.1.7.2 |
Identifies the classe name of a common ancestor object of the objects for which changes are reported. A MnS producer may set this parameter always to the class name of the parent of the local root object in the MIB. |
objectInstance |
M |
See clause 11.1.1.7.2 |
Identifies the instance of a common ancestor object of the objects for which changes are reported. A MnS producer may set this parameter always to the instance of the parent of the local root object in the MIB. |
notificationId |
M |
See clause 11.1.1.7.2 |
See clause 11.1.1.7.2 |
notificationType |
M |
const string “notifyMOIChanges” |
See clause 11.1.1.7.2 |
eventTime |
M |
See clause 11.1.1.7.2 |
See clause 11.1.1.7.2 |
systemDN |
M |
See clause 11.1.1.7.2 |
See clause 11.1.1.7.2 |
moiChanges |
M |
SEQUENCE OF SET { notificationId (M), correlatedNotifications (O), additionalText (O), sourceIndicator (O), op (M), path (M), value (M) , oldValue (O) } |
This parameter describes the reported NRM updates. It is a list of items; each item reports a single NRM update. The "notificationId" identifies an item. The NRM update itself is described by the parameters "op", "path", "value" and "oldValue". The parameters "correlatedNotifications", "additionalText" and "sourceIndicator " provide context information. The parameter "op" specifies the type of operation reporting the NRM update. Valid values are "add", "remove" and "replace". The operation describes what has conceptually happened to the NRM on the MnS producer. The operation applied to the NRM by the MnS producer and causing the reported NRM update can be different. "add" shall be used for reporting the creation of an object, attribute, attribute field or multi-value attribute element. "remove" shall be used for reporting the deletion of an object, attribute, attribute field or multi-value attribute element. "replace" shall be used for reporting the replacement of an existing attribute value, attribute field value or multi-value attribute element. The "path" and "objectInstance" identify the object, attribute, attribute field or multi-value attribute element, that was created, deleted or replaced. If an object creation is reported with "add", the "value" shall carry a complete representation of the created object. If an object deletion is reported with "remove", the "value" shall be absent. It may optionally carry a complete representation of the deleted object. If an attribute, attribute field or multi-value attribute element creation is reported with "add", the "value" shall carry the value of the created attribute, attribute field or multi-value attribute element. If an attribute, attribute field or multi-value attribute element deletion is reported with "remove", the "value" shall be absent. It may optionally carry the old value of the deleted attribute, attribute field or multi-value attribute element. If the replacement of an attribute, attribute field or multi-value attribute element value is reported with "replace", the "value" shall carry the new value of the attribute, attribute field or multi-value attribute element. The "oldValue" may optionally carry the old value of the attribute, attribute field or multi-value attribute element before the replacement. If multiple objects are created, the creation of parent objects shall be reported before the creation of the child objects. Vice versa, when the deletion of multiple objects is reported, the deletion of child objects shall be reported before the deletion of the parent objects. |
11.1.2 Managed Information
11.1.2.1 ManagedEntity
11.1.2.1.1 Definition
The ProxyClass ManagedEntity represents the role that can be played by an instance of an IOC defined in NRMs, e.g. Generic NRM, NR and NG-RAN NRM, or 5GC NRM. ManagedEntity is used in the specification of provisioning operations and notifications to represent an instance of an IOC defined in these NRMs.