A.4 Managed object classes

12.053GPPSubscriber Related Call and Event DataTS

A.4.1 AoC service

This managed object class enables a number of services and additional charging parameters to be grouped together to define a "customised" network service for the purpose of AoC.

The presence of a conditional package within an instance of this object class shall be interpreted as a logical "AND" relationship i.e. if both basic and supplementary services are specified then the service definition only applies if both basic and supplementary services are used.

The SET of values within the attributes of the various packages shall be interpreted as a logical "OR" relationship i.e. the service definition applies if any one of the listed members is used.

Example: If, for the purpose of AoC, the same tariff switching pattern is to be applied to the use of call forwarding in conjunction with all teleservices except for Short Message Services then a single "aocService" object instance may be created with both the "basicServices" and "supplServices" packages instantiated. The list of basic services including all teleservice group codes except for SMS and the list of supplementary services including a single group code for "all call forwarding".

Network specific charging parameters, if required, may be included by defining a sub-class of the "aocService" object and specifying additional conditional packages.

aocService MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

aocServiceDefinition PACKAGE

ATTRIBUTES

aocServiceId GET,

aocServiceName GET-REPLACE;

REGISTERED AS { gsm1205Package 1 };;

CONDITIONAL PACKAGES

basicServicesPackage PACKAGE

ATTRIBUTES

basicServices GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 2};

PRESENT IF "the aoc service definition applies to basic services",

supplServicesPackage PACKAGE

ATTRIBUTES

supplServices GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 3};

PRESENT IF "the aoc service definition applies to suppl. services",

networkSpecificServicesPackage PACKAGE

ATTRIBUTES

networkSpecificServices GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 4};

PRESENT IF "the aoc service definition applies to non-GSM services",

radioChannelsRequestedPackage PACKAGE

ATTRIBUTES

radioChannelsRequested GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 5};

PRESENT IF "the aoc service definition applies to the type of radio channel requested e.g. dual mode half rate preferred",

radioChannelUsedPackage PACKAGE

ATTRIBUTES

radioChannelUsed GET-REPLACE;

REGISTERED AS {gsm1205Package 6};

PRESENT IF "the aoc service definition applies to the type of radio channel actually employed i.e. full/ half rate",

msPowerClassesPackage PACKAGE

ATTRIBUTES

msPowerClasses GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 7};

PRESENT IF "the aoc service definition applies for certain MS classmark (RF power capability) values",

transparencyPackage PACKAGE

ATTRIBUTES

transparencyInd GET-REPLACE;

REGISTERED AS {gsm1205Package 8};

PRESENT IF "the aoc service definition applies to the mode of the basic service employed i.e. transparent/ non-transparent",

callTypesPackage PACKAGE

ATTRIBUTES

callTypes GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 9};

PRESENT IF "the aoc service definition applies for certain types of call e.g. MOC/ MTC";

HSCSDChannelsRequestedPackage PACKAGE

ATTRIBUTES

HSCSDChannelsRequested GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 10};

PRESENT IF "the aoc service definition applies to the number of HSCSD channels requested e.g. max 4 HSCSD channels",

HSCSDChannelsAllocatedPackage PACKAGE

ATTRIBUTES

HSCSDChannelsAllocated GET-REPLACE ADD-REMOVE;

REGISTERED AS {gsm1205Package 11};

PRESENT IF "the aoc service definition applies to the number of HSCSD channels actually allocated for the connection e.g. 2 HSCSD channels allocated";

REGISTERED AS {gsm1205ManagedObjectClass 1 };

A.4.2 Call and event log entry

This managed object class is a subclass of the "eventLogRecord" class described in CCITT X.735 [11] and defined in CCITT X.721 [5] and therefore inherits all of the properties of both the "logRecord" and eventLogRecord" classes. This includes the name binding "logRecord-log" defined in X.721.

callEventLogEntry MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":eventLogRecord;

CHARACTERIZED BY

callEventLogEntryPackage PACKAGE

BEHAVIOUR

callEventLogEntryBehaviour BEHAVIOUR

DEFINED AS "This managed object is used to store a single call and event record.";;

ATTRIBUTES

callEventRecordType GET,

callEventRecordContent GET;;;

REGISTERED AS {gsm1205ManagedObjectClass 2 };

A.4.3 Log (CCITT X.721)

This managed object class is described in CCITT X.735 [11] and defined in CCITT X.721 [5].

A.4.4 Call recording function

This managed object class is employed to control the generation of call and event records within a particular Network Element. Only one instance of this object may be created within any one NE. This class contains notifications that permit the NE to transmit call and event records; emergency call indications; and observed IMEI tickets to the OS. It also controls the generation of partial records.

callRecordingFunction MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

callRecordingFunctionPackage PACKAGE

ATTRIBUTES

callRecordingFunctionId GET,

partialRecordTimer GET-REPLACE,

partialRecordGeneration GET-REPLACE ADD-REMOVE;

NOTIFICATIONS

callEventRecordReport;

REGISTERED AS { gsm1205Package 12 };;

CONDITIONAL PACKAGES

emergencyCallNotificationPackage PACKAGE

ATTRIBUTES

emergencyCallIndEnable GET-REPLACE,

emergencyCallIndDest GET-REPLACE ADD-REMOVE;

NOTIFICATIONS

emergencyCallIndication;

REGISTERED AS { gsm1205Package 13 };

PRESENT IF "the emergency notification is supported",

observedIMEITicketPackage PACKAGE

ATTRIBUTES

observedIMEITicketGenerationEnable GET-REPLACE,

observedIMEITicketDest GET-REPLACE;

NOTIFICATIONS

observedIMEITicketReport;

REGISTERED AS { gsm1205Package 14 };

PRESENT IF "observed IMEI tickets are supported";

REGISTERED AS {gsm1205ManagedObjectClass 4 };

A.4.5 Charging calendar

This managed object represents a charging calendar for a particular year. The calendar contains a set of day definitions each of which allocates a day class to a particular day of the week together with a set of date definitions which allocate a day class to a particular day of the year. The date definitions take precedence over the day definitions.

chargingCalendar MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

chargingCalendarPackage PACKAGE

ATTRIBUTES

calendarYear GET,

dayDefinitions GET-REPLACE ADD-REMOVE,

dateDefinitions GET-REPLACE ADD-REMOVE;;;

REGISTERED AS {gsm1205ManagedObjectClass 5 };

A.4.6 Charging destination

This managed object class defines a logical destination for distance sensitive charging purposes. A charging destination may be associated with one or more address strings (e.g. country codes) but may also be derived from other quantities such as routes, trunk groups etc. As a result, this object may be allocated to/ referenced by a number of configuration management objects. It should however be noted that the administration of such configuration management objects is outside the scope of the present document.

chargingDestination MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

chargingDestinationPackage PACKAGE

ATTRIBUTES

destinationId GET,

destinationName GET-REPLACE;;;

REGISTERED AS {gsm1205ManagedObjectClass 6 };

A.4.7 Charging origin

This managed object class defines a logical origin for distance sensitive charging purposes. A charging origin may be associated with one or more of the following: cell-ids, incoming trunk groups etc. As a result, this object may be allocated to/ referenced by a number of configuration management objects such as cell-ids, trunk groups etc. It should however be noted that the administration of such configuration management objects is outside the scope of the present document.

chargingOrigin MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

chargingOriginPackage PACKAGE

ATTRIBUTES

originId GET,

originName GET-REPLACE;;;

REGISTERED AS {gsm1205ManagedObjectClass 7 };

A.4.8 Charging zone

This managed object class defines a distance class for charging purposes. A charging zone contains a set of origin and destination combinations. Each origin/ destination combination shall appear in one, and only one, charging zone.

chargingZone MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

chargingZonePackage PACKAGE

ATTRIBUTES

zoneId GET,

zoneName GET-REPLACE,

originDestCombinations GET-REPLACE ADD-REMOVE;;;

REGISTERED AS {gsm1205ManagedObjectClass 8 };

A.4.9 Day class

This managed object class defines a day class to be used in the charging calendar. A day class is used to group together days on which the same tariff switch pattern is applied.

dayClass MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

dayClassPackage PACKAGE

ATTRIBUTES

dayClassId GET,

dayClassName GET-REPLACE;;;

REGISTERED AS {gsm1205ManagedObjectClass 9 };

A.4.10 Event forwarding discriminator

The use of event forwarding discriminators (EFDs) is described in detail in CCITT X.734 [10]. The object class itself is a subclass of the "discriminator" object class. Both discriminator and event forwarding discriminator classes are defined in CCITT X.721 [5].

A.4.11 Roamer tariff

The "roamerTariff" object class is a subclass of "tariff" and therefore inherits all of its properties. This object class also contains additional information required for tariffs applied to roaming subscribers e.g. the scaling factor (e3) required to convert VPLMN units to HPLMN units.

NOTE: At present there is only one such tariff per HPLMN. This tariff, depending solely on the HPLMN, is independent of time, service etc. This invariant tariff is defined by the HPLMN but stored in the VPLMN in order to drive the AOC display for MTCs to roaming subscribers. This tariff covers the charges for the re-routing of the call from the HPLMN to the VPLMN. For further details see GSM 02.24 [12].

roamerTariff MANAGED OBJECT CLASS

DERIVED FROM tariff;

CHARACTERIZED BY

roamerTariffPackage PACKAGE

ATTRIBUTES

hplmnId GET,

e3-Scaling-Factor GET-REPLACE;;;

REGISTERED AS {gsm1205ManagedObjectClass 10 };

A.4.12 Record class

This managed object class defines a record class. A record class groups together a number of record types recorded for a particular purpose. Examples of possible record classes might include:

– the billing relevant records both stored locally and sent to the OS in the form of event reports;

– customised record classes defined by the network operator.

The managed object instance includes the name of the record class and a list of destinations to which the records are sent and contains one or more objects of the classes "recordTypeControl", "supplServiceControl", and "ssActionControl".

recordClass MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

recordClassPackage PACKAGE

ATTRIBUTES

recordClassId GET,

recordClassName GET-REPLACE,

recordClassDestination GET-REPLACE ADD-REMOVE;;;

REGISTERED AS {gsm1205ManagedObjectClass 11 };

A.4.13 Record type control

This managed object class controls the type of call and event records generated. A managed object instance of this class is created for each type of record to be produced. The object instance defines both the type of transaction recorded (successful, unsuccessful, all) and the type of subscribers for whom the records are to be created e.g. home / visiting / all subscribers.

recordTypeControl MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

recordTypeControlPackage PACKAGE

ATTRIBUTES

recordType GET,

typeOfTransaction GET-REPLACE,

typeOfSubscribers GET-REPLACE;;;

REGISTERED AS {gsm1205ManagedObjectClass 12 };

A.4.14 Supplementary service action control

This managed object class controls the recording of individual supplementary service actions. A managed object instance of this class is created for each supplementary service action to be recorded. The object instance defines how the action is to be recorded (in MOC / MTC records or in SS-Action records); and for whom the records are to be created e.g. home / visiting / all subscribers.

ssActionControl MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

ssActionControlPackage PACKAGE

ATTRIBUTES

ssActionType GET,

recordingMethod GET-REPLACE,

typeOfSubscribers GET-REPLACE;;;

REGISTERED AS {gsm1205ManagedObjectClass 13 };

A.4.15 Supplementary service control

This managed object class controls the recording of the use of supplementary services. A managed object instance of this class shall be created for each supplementary service, or group of supplementary services, to be recorded. Each instance of this object class shall contain one or more objects of the class "ssActionControl" defining which of the possible supplementary service actions are to be recorded.

supplServiceControl MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

supplServiceControlPackage PACKAGE

ATTRIBUTES

suppServiceCode GET;;;

REGISTERED AS {gsm1205ManagedObjectClass 14 };

A.4.16 Tarif (AoC)

This object represents an on-line GSM (AoC) tariff and contains the so-called "e-parameters" defined in GSM 02.24 [12]. The parameters e1, e2, and e7 determine the time (duration) based charges to be applied; the parameters e5 and e6 determine the data volume based charges and the parameter e4 represents a simple unit increment.

tariff MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

tariffPackage PACKAGE

ATTRIBUTES

tariffId GET,

tariffName GET-REPLACE,

e1-Units-per-Time-Interval GET-REPLACE,

e2-Secs-per-Time-Interval GET-REPLACE,

e4-Unit-Increment GET-REPLACE,

e5-Units-per-Data-Interval GET-REPLACE,

e6-Segments-per-Data-Interval GET-REPLACE,

e7-Initial-Secs-per-Time-Interval GET-REPLACE;;;

REGISTERED AS {gsm1205ManagedObjectClass 15 };

A.4.17 Tariff administration

This managed object class contains all of the managed objects required by the tariff administration function. There shall be one, and only one managed object instance of this class in any network element. The "tsActive" attribute points to the currently active "tariffSystem" and the attribute "tsStandby" points to a back-up "tariffSystem" to permit a roll-back to a previous state. Both "tsActive" and "tsStandby" are read-only and may only be changed via the action "tsChangeover".

The action "tsChangeover" updates the attribute "tsActive" with a new tariff system Id. and replaces the value of "tsStandby" with the currently active tariff system Id. The state of the tariff system objects involved is also updated accordingly. This action may be performed immediately or scheduled for later execution.

Once scheduled, the attribute "tsNextChange" contains details of both the change-over time and the change that will take place. A scheduled change-over may be cancelled at any time by means of the action "tsCancelChangeover".

Any change to the contents of the attributes "tsActive"/ "tsStandby" shall result in the generation of a "stateChange" notification.

No changes are permitted to the currently active tariff system or the objects contained within it. The action "tsCopyTariffSystem" may be employed to copy the entire contents of the active tariff system, including all of the contained objects, to a new tariff system. The new system may then be modified as required.

tariffAdministration MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

tariffAdminPackage PACKAGE

ATTRIBUTES

tariffAdminId GET,

tsActive GET,

tsStandby GET,

tsNextChange GET;

ACTIONS

tsChangeover,

tsCancelChangeover,

tsCopyTariffSystem;

NOTIFICATIONS

"Recommendation X.721:1992":stateChange;;;

REGISTERED AS {gsm1205ManagedObjectClass 16 };

A.4.18 Tariff class

This managed object class represents a tariff class. The tariff class defines a set of service and distance dependencies for which the same tariff switch-over patterns apply.

Each instance of a tariff class shall contain one or more tariff switching pattern objects.

tariffClass MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

tariffClassPackage PACKAGE

ATTRIBUTES

tariffClassId GET,

serviceDistanceDependencies GET-REPLACE ADD-REMOVE;;;

REGISTERED AS {gsm1205ManagedObjectClass 17 };

A.4.19 Tariff switch pattern

This managed object class defines the tariff switching pattern for a 24 hour period i.e. one calendar day. This pattern is applied to all of the days belonging to particular day classes. The day classes attribute contains the list of day classes to which the tariff pattern is applied.

The tariff periods attribute contains one or more tariff periods defined by their switch-over times and a reference to the tariff to be applied after the switch-over. Each tariff switching pattern contains a minimum of one tariff period with a switch-over time of midnight ("00:00:00"). If the tariff does not change within the 24 hour period covered by the tariff switching pattern then no other tariff period is required.

tariffSwitchPattern MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

tariffSwitchPatternPackage PACKAGE

ATTRIBUTES

tariffSwitchPatternId GET,

dayClasses GET-REPLACE ADD-REMOVE,

tariffPeriods GET-REPLACE ADD-REMOVE;;;

REGISTERED AS {gsm1205ManagedObjectClass 18 };

A.4.20 Tariff System

This managed object class defines a consistent set of tariff entities (tariff classes, tariffs etc.). It also provides the mechanisms required to control the modification of such entities in order to guarantee that the set remains consistent after modification.

The tariff system object class contains a complete set of tariffs, roamer tariffs, and tariff classes. The tariff classes in turn contain the switch-over patterns.

The state of the tariff system is contained within the attribute "tariffSystemStatus". A simplified state transition diagram is illustrated in figure A.6. There shall be one, and only one, "active" tariff system at any one point in time and the objects contained within this tariff system may not be modified whilst it is in the "active" state. There may be a number of tariff systems currently in preparation.

Figure A.6: Tariff system state transition diagram

If supported by the network element, a completed tariff system and its contained objects may be checked for consistency. On receipt of the "tsCheck" action the NEF shall perform a set of standard checks to ensure that the tariff system is both complete and consistent.

Once complete, a tariff system may be activated by means of the "tsChangeover" action (see managed object class "tariffAdmin"). Depending on the activation date and time specified in the action, the tariff system may become active immediately or be placed in the standby state and scheduled for later activation. The "tsChangeover" action may also include a signature (passwords, encryption keys etc.) to authorise the changes to be made. The definition of such security features is outside the scope of the present document.

On activation, a changeover takes place between the currently active tariff system and the new tariff system specified in the "tsChangeover" action. The new tariff system becomes active and the old is placed into the "standby" state. This action also results in the updating of the "tariffAdmin" attributes as described in subclause A.2.3.16. In the event of any problems with the new tariff system a second "tsChangeover" may be issued causing a roll-back to the standby system.

If, for any reason, a "tariffSystem" that has been checked or is awaiting activation requires further modification, then it may be returned to the "available" state by means of the "tsUnfreeze" action.

Any change to the "tariffSystemStatus" shall result in the generation of a "stateChange" notification.

tariffSystem MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":top;

CHARACTERIZED BY

tariffSystemPackage PACKAGE

ATTRIBUTES

tariffSystemId GET,

tariffSystemStatus GET;

ACTIONS

tsUnfreeze;

NOTIFICATIONS

"Recommendation X.721:1992":stateChange;

REGISTERED AS { gsm1205Package 10 };;

CONDITIONAL PACKAGES

tariffSystemCheckPackage PACKAGE

ACTIONS

tsCheck;

REGISTERED AS {gsm1205Package 11 };

PRESENT IF "the checking of a tariff system is supported by the NEF";

REGISTERED AS {gsm1205ManagedObjectClass 19 };

A.4.21 Emergency call indication log entry

This managed object class is used to store the emergency call indication notifications as log records. It is a subclass of the “eventLogRecord” class described in CCITT X.735 [11] and defined in CCITT X.721 [5] and therefore inherits a;; of the properties of both the “logRecord” and “eventLogRecord” classes. This includes the name binding “logRecord-log” defined in X.721.

emergencyCallIndicationLogEntry MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":eventLogRecord;

CHARACTERIZED BY

emergencyCallIndicationLogEntryPackage PACKAGE

BEHAVIOUR

emergencyCallIndicationLogEntryBehaviour BEHAVIOUR

DEFINED AS “This managed object is used to store a single emergency call indication record.”;;

ATTRIBUTES

cellId GET,

callerId GET;;;

REGISTERED AS {gsm1205ManagedObjectClass 20 };

A.4.22 Observed IMEI ticket report log entry

This managed object class is used to store the observed IMEI ticket report notifications as log records. It is a subclass of the “eventLogRecord” class described in CCITT X.735 [11] and defined in CCITT X.721 [5] and therefore inherits all of the properties of both the “logRecord” and “eventLogRecord” classes. This includes the name binding “logRecord-log” defined in X.721.

observedIMEITicketReportLogEntry MANAGED OBJECT CLASS

DERIVED FROM "Recommendation X.721 : 1992":eventLogRecord;

CHARACTERIZED BY

observedIMEITicketReportLogEntryPackage PACKAGE

BEHAVIOR

observedIMEITicketReportLogEntryBehaviour BEHAVIOUR

DEFINED AS “This managed object is used to store a single observed IMEI ticket report record.”;;

ATTRIBUTES

observedIMEITicketContent GET;;;

REGISTERED AS {gsm1205ManagedObjectClass 21 };