10 Managed Object Model

12.083GPPSubscriber and equipment traceTS

10.1 Naming Hierarchy

The naming (containment) tree for the objects defined within this clause is illustrated in figure 5. It should be noted that the GSM 12.08 object classes are shown relative to the "managedElement". The MO traceControl is contained in every NEF (mscFunction, hlrFunction and bssFunction from GSM 12.00 [7]) that supports trace functionality. For further details of the upper layers of the containment tree see GSM 12.00 [7]. For further details concerning the log class see ITU-T X.721 [13].

Figure 5: Trace Record Transfer Containment Tree

10.2 Inheritance

The inheritance tree for GSM 12.08 is illustrated in figure 6 below. The object classes "log", "logRecord", "eventLogRecord" and "eventForwardingDiscriminator" are defined in ITU-T X.721 [13].

Figure 6: Trace Record Transfer Inheritance Tree

10.3 Object Classes

10.3.1 tracedHomeSubscriberInHlr

tracedHomeSubscriberInHlr MANAGED OBJECT CLASS

DERIVED FROM

"ITU-T Rec. X.721: 1992":top;

CHARACTERIZED BY

tracedHomeSubscriberInHlrPackage,

"ITU-T Rec. M.3100: 1992": createDeleteNotificationsPackage,

"ITU-T Rec. M.3100: 1992": attributeValueChangeNotificationPackage;

CONDITIONAL PACKAGES

operationSystemIdPackage PRESENT IF "an instance supports it";

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑objectClass 100};

tracedHomeSubscriberInHlrPackage PACKAGE

BEHAVIOUR

tracedHomeSubscriberInHlrBehaviour;

ATTRIBUTES

imsi GET,

traceActivatedInVlr GET,

traceReference GET,

traceType GET,

hlrTraceType GET,

mapErrorOnTrace GET

;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 100};

tracedHomeSubscriberInHlrBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.5.1.1";

operationSystemIdPackage PACKAGE

BEHAVIOUR

operationSystemIdBehaviour;

ATTRIBUTES

operationSystemId GET;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 200};

operationSystemIdBehaviour BEHAVIOUR

DEFINED AS

"This package provides the attribute to specify destination operation system. The use of this attribute is described in chapter Trace record transfer. The package is conditional to allow the attribute operationSystemId to be optional.";

10.3.2 tracedForeignSubscriberInVlr

tracedForeignSubscriberInVlr MANAGED OBJECT CLASS

DERIVED FROM

"ITU-T Rec. X.721: 1992":top;

CHARACTERIZED BY

tracedForeignSubscriberInVlrPackage,

"ITU-T Rec. M.3100: 1992": createDeleteNotificationsPackage,

"ITU-T Rec. M.3100: 1992": attributeValueChangeNotificationPackage;

CONDITIONAL PACKAGES

operationSystemIdPackage PRESENT IF "an instance supports it";

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑objectClass 200};

tracedForeignSubscriberInVlrPackage PACKAGE

BEHAVIOUR

tracedForeignSubscriberInVlrBehaviour;

ATTRIBUTES

imsi GET,

foreignSubscriberRegisteredInVlr GET,

traceReference GET,

traceType GET

;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 300};

tracedForeignSubscriberInVlrBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.6.1.1";

10.3.3 tracedEquipmentInVlr

tracedEquipmentInVlr MANAGED OBJECT CLASS

DERIVED FROM

"ITU-T Rec. X.721: 1992":top;

CHARACTERIZED BY

tracedEquipmentInVlrPackage,

"ITU-T Rec. M.3100: 1992": createDeleteNotificationsPackage,

"ITU-T Rec. M.3100: 1992": attributeValueChangeNotificationPackage;

CONDITIONAL PACKAGES

operationSystemIdPackage PRESENT IF "an instance supports it";

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑objectClass 300};

tracedEquipmentInVlrPackage PACKAGE

BEHAVIOUR

tracedEquipmentInVlrBehaviour;

ATTRIBUTES

imei GET,

equipmentRegisteredInVlr GET,

traceReference GET,

traceType GET

;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 400};

tracedEquipmentInVlrBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.6.1.2";

10.3.4 Trace control

This managed object class represents the trace collection process and generates the trace report notifications. There shall be one, and only one, instance of this object class for each NEF that supports the trace function.

traceControl MANAGED OBJECT CLASS

DERIVED FROM "ITU-T Rec. X.721: 1992":top;

CHARACTERIZED BY

traceControlPackage,

"ITU-T Rec. M.3100: 1992": attributeValueChangeNotificationPackage,

"ITU-T Rec. M.3100: 1992": createDeleteNotificationsPackage,

"ITU-T Rec. M.3100: 1992": stateChangeNotificationPackage;

CONDITIONAL PACKAGES

eventTypeCriteriaPackage PRESENT IF "an instance supports it"

;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑objectClass 400};

traceControlPackage PACKAGE

BEHAVIOUR

traceControlBehaviour BEHAVIOUR

DEFINED AS

"This managed object class is employed to generate trace report notifications. There can be only one instance of this object class in each NEF that supports trace functionality.

For the administrativeState, the value LOCKED causes all tracing activity in the NEF to cease. The value UNLOCKED allows tracing activity. The value SHUTTING‑DOWN prevents any new invocation of a trace. Current invocations will continue until they are finished. When all current invocations finish, the state will automatically transit to LOCKED.";;

ATTRIBUTES

traceControlId GET,

"ITU-T Rec. X.721: 1992": administrativeState GET‑REPLACE,

"ITU-T Rec. X.721: 1992": operationalState GET,

recordCriteria GET‑REPLACE ADD‑REMOVE;

NOTIFICATIONS

traceReport;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 500};

eventTypeCriteriaPackage PACKAGE

BEHAVIOUR

eventTypeCriteriaBehaviour BEHAVIOUR

DEFINED AS

"This package provides the attribute to specify eventType record generation criteria. The use of this attribute is described in clause 8.2.2. The package is conditional to allow the attribute to be optional.";;

ATTRIBUTES

eventTypes GET‑REPLACE ADD‑REMOVE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 520};

10.3.5 Trace log record

This managed object class is a subclass of the "eventLogRecord" class described in ITU-T X.735 and defined in ITU-T X.721 and therefore inherits all of the properties of both the "logRecord" and "eventLogRecord" classes. This includes the name binding "logRecord‑log" defined in ITU-T X.721.

traceLogRecord MANAGED OBJECT CLASS

DERIVED FROM "ITU-T Rec. X.721: 1992":eventLogRecord;

CHARACTERIZED BY

traceLogRecordPackage;

CONDITIONAL PACKAGES

traceReferenceLogPackage PRESENT IF "an instance supports it",

mscBssTraceTypeLogPackage PRESENT IF "an instance supports it",

hlrTraceTypeLogPackage PRESENT IF "an instance supports it",

mscBssTraceTypeUsedLogPackage PRESENT IF "an instance supports it",

hlrTraceTypeUsedLogPackage PRESENT IF "an instance supports it";

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑objectClass 500};

traceLogRecordPackage PACKAGE

BEHAVIOUR

traceLogRecordBehaviour BEHAVIOUR

DEFINED AS "This managed object is used to store a single trace record.";;

ATTRIBUTES

traceRecordContent GET;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 600};

traceReferenceLogPackage PACKAGE

BEHAVIOUR

traceReferenceLogBehaviour BEHAVIOUR

DEFINED AS

"This package provides the attribute to specify traceReference for trace report searching criteria in the Log. Optional.";;

ATTRIBUTES

traceReference GET;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 610};

mscBssTraceTypeLogPackage PACKAGE

BEHAVIOUR

mscBssTraceTypeLogBehaviour BEHAVIOUR

DEFINED AS

"This package provides the attribute to specify searching criteria to be mscBssTraceType of trace report in the Log. Optional.";;

ATTRIBUTES

mscBssTraceType GET;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 620};

hlrTraceTypeLogPackage PACKAGE

BEHAVIOUR

hlrTraceTypeLogBehaviour BEHAVIOR

DEFINED AS

"This package provides the attribute to specify searching criteria to be hlrTraceType of trace report in the Log. Optional.";;

ATTRIBUTES

hlrTraceType GET;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 630};

mscBssTraceTypeUsedLogPackage PACKAGE

BEHAVIOUR

mscBssTraceTypeUsedLogBehaviour BEHAVIOUR

DEFINED AS

"This package provides the attribute to specify searching criteria to be mscBssTraceTypeUsed of trace report in the Log. Optional.";;

ATTRIBUTES

mscBssTraceTypeUsed GET;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 640};

hlrTraceTypeUsedLogPackage PACKAGE

BEHAVIOUR

hlrTraceTypeUsedLogBehaviour BEHAVIOUR

DEFINED AS

"This package provides the attribute to specify searching criteria to be hlrTraceTypeUsed of trace report in the Log. Optional.";;

ATTRIBUTES

hlrTraceTypeUsed GET;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑package 650};

10.3.6 Log

This managed object class is described in ITU-T X.735 and defined in ITU-T X.721.

10.3.7 Event Forwarding Discriminators

The use of event forwarding discriminators (EFDs) is described in detail in ITU-T X.734. The object class itself is a subclass of the "discriminator" object class. Both discriminator and event forwarding discriminator classes are defined in ITU-T X.721.

10.4 Attributes

10.4.1 traceActivatedInVlr

traceActivatedInVlr ATTRIBUTE

WITH ATTRIBUTE SYNTAX

Trace‑DataTypes.TraceStatus;

MATCHES FOR

EQUALITY;

BEHAVIOUR

traceActivatedInVlrBehaviour;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 10};

traceActivatedInVlrBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.5.1.2.1";

10.4.2 foreignSubscriberRegisteredInVlr

foreignSubscriberRegisteredInVlr ATTRIBUTE

WITH ATTRIBUTE SYNTAX

Trace‑DataTypes.TraceStatus;

MATCHES FOR

EQUALITY;

BEHAVIOUR

foreignSubscriberRegisteredInVlrBehaviour;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 20};

foreignSubscriberRegisteredInVlrBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.6.1.3.1";

10.4.3 equipmentRegisteredInVlr

equipmentRegisteredInVlr ATTRIBUTE

WITH ATTRIBUTE SYNTAX

Trace‑DataTypes.TraceStatus;

MATCHES FOR

EQUALITY;

BEHAVIOUR

equipmentRegisteredInVlrBehaviour;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 30};

equipmentRegisteredInVlrBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.6.1.3.2";

10.4.4 mapErrorOnTrace

mapErrorOnTrace ATTRIBUTE

WITH ATTRIBUTE SYNTAX

Trace‑DataTypes.MapErrorOnTrace;

MATCHES FOR

EQUALITY, ORDERING;

BEHAVIOUR

mapErrorOnTraceBehaviour;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 40};

mapErrorOnTraceBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.5.1.2.1";

10.4.5 IMEI

imei ATTRIBUTE

WITH ATTRIBUTE SYNTAX

MAP‑CommonDataTypes.IMEI;

MATCHES FOR

EQUALITY, ORDERING;

BEHAVIOUR

imeiBehaviour;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 50};

imeiBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.6.1.3.2";

10.4.6 IMSI

imsi ATTRIBUTE

WITH ATTRIBUTE SYNTAX

MAP‑CommonDataTypes.IMSI;

MATCHES FOR

EQUALITY, ORDERING;

BEHAVIOUR

imsiBehaviour;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 60};

imsiBehaviour BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.6.1.3.1";

10.4.7 Trace record content

traceRecordContent ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceRecord;

BEHAVIOUR

traceRecordContentBehaviour BEHAVIOUR

DEFINED AS

"This attribute contains the contents of a trace record.";;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 70};

10.4.8 Trace control id.

traceControlId ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceControlId;

MATCHES FOR EQUALITY;

BEHAVIOUR

traceControlIdBehaviour BEHAVIOUR

DEFINED AS

"This attribute uniquely identifies a trace control object.";;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 80};

10.4.9 HLR Trace type

hlrTraceType ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceType;

MATCHES FOR EQUALITY;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 90};

10.4.10 Trace reference

traceReference ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceReference;

MATCHES FOR EQUALITY, ORDERING;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 100};

10.4.11 Trace type

traceType ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceType;

MATCHES FOR EQUALITY;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 110};

10.4.12 Record criteria

recordCriteria ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.RecordCriteria;

MATCHES FOR EQUALITY;

BEHAVIOUR

recordCriteriaBehaviour BEHAVIOUR

DEFINED AS

"This attribute specifies the criteria for the generation of a trace record by the network element.";;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 120};

10.4.13 Event types

eventTypes ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.EventTypes;

MATCHES FOR EQUALITY;

BEHAVIOUR

eventTypeBehaviour BEHAVIOUR

DEFINED AS

"This attribute specifies the type of event triggering the generation of a trace record by the network element.";;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 140};

10.4.14 Operation system ID

operationSystemId ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.OmcId;

MATCHES FOR EQUALITY;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 160};

10.4.15 Operational State

This attribute is described in Recommendation X.731 and the syntax is defined in X.721.

10.4.16 Administrative State

This attribute is described in Recommendation X.731 and the syntax is defined in X.721.

10.4.17 MSC BSS trace type used

mscBssTraceTypeUsed ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceType;

MATCHES FOR EQUALITY;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 170};

10.4.18 HLR trace type used

hlrTraceTypeUsed ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceType;

MATCHES FOR EQUALITY;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 180};

10.4.19 MSC BSS trace type

mscBssTraceType ATTRIBUTE

WITH ATTRIBUTE SYNTAX Trace‑DataTypes.TraceType;

MATCHES FOR EQUALITY;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑attribute 190};

10.5 Notifications

10.5.1 General

All notifications listed below are defined in ITU-T X.721:

attributeValueChange

objectCreation

objectDeletion

stateChange

10.5.2 Trace report

traceReport NOTIFICATION

BEHAVIOUR

traceReportBehaviour;

WITH INFORMATION SYNTAX Trace‑DataTypes.TraceRecord

AND ATTRIBUTE IDS

traceReference traceReference,

mscBssTraceType mscBssTraceType,

hlrTraceType hlrTraceType,

mscBssTraceTypeUsed mscBssTraceTypeUsed,

hlrTraceTypeUsed hlrTraceTypeUsed;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑notification 100};

traceReportBehaviour BEHAVIOUR

DEFINED AS

"This notification is issued by the trace control function to transmit a trace report to the OS. The attribute Ids may be used by Event Forwarding Discriminators to specify additional filter conditions.";

10.6 Name Bindings

10.6.1 tracedHomeSubscriberInHlr‑hlrFunction Name Binding

tracedHomeSubscriberInHlr‑hlrFunction NAME BINDING

SUBORDINATE OBJECT CLASS tracedHomeSubscriberInHlr;

NAMED BY

SUPERIOR OBJECT CLASS "prETS 300 612‑1:1995":hlrFunction;

WITH ATTRIBUTE imsi;

BEHAVIOUR tracedHomeSubscriberInHlr‑hlrFunctionBhv;

CREATE;

DELETE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑nameBinding 100};

tracedHomeSubscriberInHlr‑hlrFunctionBhv BEHAVIOUR

DEFINED AS

"see GSM 12.08 clause 5.5";

10.6.2 tracedForeignSubscriberInVlr‑vlrFunction Name Binding

tracedForeignSubscriberInVlr‑vlrFunction NAME BINDING

SUBORDINATE OBJECT CLASS tracedForeignSubscriberInVlr;

NAMED BY

SUPERIOR OBJECT CLASS "prETS 300 612‑1:1995":vlrFunction;

WITH ATTRIBUTE imsi;

BEHAVIOUR tracedForeignSubscriberInVlr‑vlrFunctionBhv;

CREATE;

DELETE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑nameBinding 200};

tracedForeignSubscriberInVlr‑vlrFunctionBhv BEHAVIOUR

DEFINED AS

"see GSM 1208 clause 5.6";

10.6.3 tracedEquipmentInVlr‑vlrFunction Name Binding

tracedEquipmentInVlr‑vlrFunction NAME BINDING

SUBORDINATE OBJECT CLASS tracedEquipmentInVlr;

NAMED BY

SUPERIOR OBJECT CLASS "prETS 300 612‑1:1995":vlrFunction;

WITH ATTRIBUTE imei;

BEHAVIOUR tracedEquipmentInVlr‑vlrFunctionBhv;

CREATE;

DELETE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑nameBinding 300};

tracedEquipmentInVlr‑vlrFunctionBhv BEHAVIOUR

DEFINED AS

"see GSM 1208 clause 5.6";

10.6.4 traceLogRecord‑Log Name Binding

traceLogRecord‑Log NAME BINDING

SUBORDINATE OBJECT CLASS traceLogRecord;

NAMED BY SUPERIOR OBJECT CLASS "ITU-T Rec. X.721: 1992":log;

WITH ATTRIBUTE "ITU-T Rec. X.721: 1992":logRecordId;

DELETE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑nameBinding 400};

10.6.5 traceControl‑hlrFunction Name Binding

traceControl‑hlrFunction NAME BINDING

SUBORDINATE OBJECT CLASS traceControl;

NAMED BY

SUPERIOR OBJECT CLASS "prETS 300 612‑1:1995":hlrFunction;

WITH ATTRIBUTE traceControlId;

CREATE;

DELETE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑nameBinding 500};

10.6.6 traceControl‑mscFunction Name Binding

traceControl‑mscFunction NAME BINDING

SUBORDINATE OBJECT CLASS traceControl;

NAMED BY

SUPERIOR OBJECT CLASS "prETS 300 612‑1:1995":mscFunction;

WITH ATTRIBUTE traceControlId;

CREATE;

DELETE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑nameBinding 600};

10.6.7 traceControl‑bssFunction Name Binding

traceControl‑bssFunction NAME BINDING

SUBORDINATE OBJECT CLASS traceControl;

NAMED BY

SUPERIOR OBJECT CLASS "prETS 300 612‑1:1995":bssFunction;

WITH ATTRIBUTE traceControlId;

CREATE;

DELETE;

REGISTERED AS {Trace‑DataTypes.gsm‑1208‑nameBinding 700};