3GPP TS 32.443: Trace Management Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) Solution Set (SS)

3GPP TS 32.443 V9.1.0 (2011-03)
Technical Specification
3rd Generation Partnership Project;
Technical Specification Group Services and System Aspects;
Telecommunication management;
Trace Management 
Integration Reference Point (IRP):
Common Object Request Broker Architecture (CORBA)
Solution Set (SS)
(Release 9)
	 EMBED Word.Picture.8  

The present document has been developed within the 3rd Generation Partnership Project (3GPP TM) and may be further elaborated for the purposes of 3GPP. 
The present document has not been subject to any approval process by the 3GPP Organizational Partners and shall not be implemented.	 
This Specification is provided for future development work within 3GPP only. The Organizational Partners accept no liability for any use of this Specification.
Specifications and reports for implementation of the 3GPP TM system should be obtained via the 3GPP Organizational Partners' Publications Offices.

Keywords
GSM, UMTS, management, performance
3GPP
Postal address

3GPP support office address
650 Route des Lucioles - Sophia Antipolis
Valbonne - FRANCE
Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16
Internet
http://www.3gpp.org

Copyright Notification
No part may be reproduced except as authorized by written permission.
The copyright and the foregoing restriction extend to reproduction in all media.

© 2011, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC).
All rights reserved.

UMTS™ is a Trade Mark of ETSI registered for the benefit of its members
3GPP™ is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners
LTE™ is a Trade Mark of ETSI currently being registered for the benefit of its Members and of the 3GPP Organizational Partners
GSM® and the GSM logo are registered and owned by the GSM Association

Contents

 TOC \o "1-9" Foreword	 PAGEREF _Toc241818389 \h 4
Introduction	 PAGEREF _Toc241818390 \h 4
1	Scope	 PAGEREF _Toc241818391 \h 5
2	References	 PAGEREF _Toc241818392 \h 5
3	Definitions and abbreviations	 PAGEREF _Toc241818393 \h 6
3.1	Definitions	 PAGEREF _Toc241818394 \h 6
3.2	Abbreviations	 PAGEREF _Toc241818395 \h 6
4	Architectural features	 PAGEREF _Toc241818396 \h 6
4.1	Notifications	 PAGEREF _Toc241818397 \h 6
4.2	Syntax for distinguished names and versions	 PAGEREF _Toc241818398 \h 6
5	Mapping	 PAGEREF _Toc241818399 \h 7
5.1	Operation and Notification mapping	 PAGEREF _Toc241818400 \h 7
5.2	Operation parameter mapping	 PAGEREF _Toc241818401 \h 7
5.3	Notification parameter mapping	 PAGEREF _Toc241818402 \h 8
6	TraceIRPNotification Interface	 PAGEREF _Toc241818403 \h 12
6.1	Method push (M)	 PAGEREF _Toc241818404 \h 12
Annex A (normative):	IDL specifications	 PAGEREF _Toc241818405 \h 13
A.1	IDL specification (file name "TraceIRPConstDefs.idl")	 PAGEREF _Toc241818406 \h 13
A.2	IDL specification (file name “TraceIRPSystem.idl”)	 PAGEREF _Toc241818407 \h 15
A.3	IDL specification (file name “TraceIRPNotifications.idl”)	 PAGEREF _Toc241818408 \h 17
Annex B (informative):	Change history	 PAGEREF _Toc241818409 \h 19

Foreword
This Technical Specification (TS) has been produced by the 3rd Generation Partnership Project (3GPP).
The contents of the present document are subject to continuing work within the TSG and may change following formal TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an identifying change of release date and an increase in version number as follows:
Version x.y.z
where:
x	the first digit:
1	presented to TSG for information;
2	presented to TSG for approval;
3	or greater indicates TSG approved document under change control.
y	the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, updates, etc.
z	the third digit is incremented when editorial only changes have been incorporated in the document.
Introduction
The present document is part of a TS-family covering the 3rd Generation Partnership Project; Technical Specification Group Services and System Aspects; Telecommunication management; as identified below:
32.441	"Trace Management Integration Reference Point (IRP): Requirements".
32.442	"Trace Management Integration Reference Point (IRP): Information Service (IS)".
32.443	"Trace Management Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) Solution Set (SS)".
32.445	"Trace Management Integration Reference Point (IRP): eXtensible Markup Language (XML) file format definition".
The present document is part of a TS-family which describes the requirements and information model necessary for the Telecommunication Management (TM) of 3G systems. The TM principles and TM architecture are specified in 3GPP TS 32.101 [2] and 3GPP TS 32.102 [3].
Trace provides very detailed information on call level for a specific subscriber or MS. This data is an additional information source to Performance Measurements and allows deeper investigations in problems solving or in case of optimization.
1	Scope
This Solution Set specification is related to 3GPP TS 32.442 [7].
2	References
The following documents contain provisions which, through reference in this text, constitute provisions of the present document.
References are either specific (identified by date of publication, edition number, version number, etc.) or non‑specific.
For a specific reference, subsequent revisions do not apply.
For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document.
[1]	3GPP TS 32.101: "Telecommunication management; Principles and high level requirements".
[2]	3GPP TS 32.102: "Telecommunication management; Architecture".
[3]	3GPP TS 32.441: "Telecommunication management; Trace Integration Reference Point (IRP): Requirements".
[4]	3GPP TS 32.311: "Telecommunication management; Generic Integration Reference Point (IRP): Requirements".
[5]	3GPP TS 32.303: "Telecommunication management; Configuration Management (CM); Notification Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) Solution Set (SS)".
[6]	3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name convention for Managed Objects".
[7]	3GPP TS 32.442: "Telecommunication management; Trace Management Integration Reference Point (IRP): Information Service (IS)".
[8]	3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) management: Information Service (IS)".
[9]	OMG TC Document telecom/98-11-01: "OMG Notification Service".  HYPERLINK "http://www.omg.org/technology/documents/" http://www.omg.org/technology/documents/
[10]	3GPP TS 32.421: "Telecommunication management; Subscriber and Equipment Trace; Concept and requirements".
3	Definitions and abbreviations
3.1	Definitions
For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 3GPP TS 32.421 [10], 3GPP TS 32.441 [3] and the following apply:
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.311 [4].
3.2	Abbreviations
For the purposes of the present document, the following abbreviations apply:
CM	Configuration Management
CORBA	Common Object Request Broker Architecture
DN	Distinguished Name
EM	Element Manager
IDL	Interface Definition Language
IS	Information Service
MOC	Managed Object Class
NE	Network Element
OMG	Object Management Group
SS	Solution Set
4	Architectural features
The overall architectural feature of  TraceIRP is specified in 3GPP TS 32.441 [3].
This clause specifies features that are specific to the CORBA SS.
4.1	Notifications
Notifications are sent according to the Notification IRP: CORBA SS (see 3GPP TS 32.303 [5]).
The contents of the TraceIRP notifications are defined in the present document.
4.2	Syntax for distinguished names and versions
The format of a Distinguished Name is defined in 3GPP TS 32.300 [6].
The version of this IRP is represented as a string (see also clause 3 for versions).
5	Mapping
5.1	Operation and Notification mapping
TraceIRP: IS 3GPP TS 32.442 [7] defines semantics of operation and notification visible across the TraceIRP. 
Table 5.1.1 indicates mapping of these operations and notifications to their equivalents defined in this SS.
Table 5.1.1: Mapping from IS Operations and Notification to SS equivalents
IS Operations/ notification 3GPP TS 32.442 [7]
SS Method 
Qualifier
activateTraceJob
activate_trace_job
M
deactivateTraceJob
deactivate_trace_job
M
listTraceJob
list_trace_job
M
listActivatedTraceJob
list_activated_trace_job
M
notifyTraceRecordingSessionFailure
push_structured_events(See subclause 6.1)
O
notifyTraceSessionLocalActivation
push_structured_events (See subclause 6.1)
O

5.2	Operation parameter mapping
The TraceIRP: IS 3GPP TS 32.442 [7] defines semantics of parameters carried in operations across the TraceIRP. The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS.
Table 5.2.1: Mapping from IS activateTraceJob parameters to SS equivalents
IS Operation parameter
SS Method parameter
Qualifier
iocInstance
KernelCmConstDefs::DN moInstance
M
listOfInterfaces
TraceIRPConstDefs::ListOfInterfaces list_of_interfaces
O
listOfNeTypes
TraceIRPConstDefs::ListOfNeTypes list_of_ne_types
CM
traceDepth
TraceIRPConstDefs::TraceDepth trace_depth
M
traceReference
TraceIRPConstDefs::TraceReference trace_reference
M
traceTarget
TraceIRPConstDefs::TraceTarget trace_target
M
triggeringEvent
TraceIRPConstDefs:: TriggeringEvent triggering_event
CO
traceCollectionEntityAddress
TraceIRPConstDefs::TraceCollectionEntityAddress trace_collection_entity_address
CM
unsupportedList
TraceIRPConstDefs:: UnsupportedList unsupportedList
M
status
Return value of type TraceIRPConstDefs::Result
Exception:
ActivateTraceJob, InvalidTraceDepth, InvalidTraceTarget, NotUniqueTraceReference
ManagedGenericIRPSystem::InvalidParameter, ManagedGenericIRPSystem::ParameterNotSupported
M

Table 5.2.2: Mapping from IS deactivateTraceJob parameters to SS equivalents
IS Operation parameter
SS Method parameter
Qualifier
traceReference
TraceIRPConstDefs:: TraceReference trace_reference
M
traceTarget
TraceIRPConstDefs::TraceTarget trace_target
M
status
Return value of type TraceIRPConstDefs::Result
Exception:
DeactivateTraceJob, NotUniqueTraceReference
M
traceRecordingSessionReference
TraceIRPConstDefs::TraceRecordingSessionReference trace_recording_session_reference
CM

Table 5.2.3: Mapping from IS listTraceJob parameters to SS equivalents
IS Operation parameter
SS Method parameter
Qualifier
traceReference
TraceIRPConstDefs::TraceReference trace_reference
M
status
Return value of type TraceIRPConstDefs::Result
Exception:
ListTraceJob, NotUniqueTraceReference
M
iocInstance
KernelCmConstDefs::DN moInstance
M
listOfInterfaces
TraceIRPConstDefs::ListOfInterfaces list_of_interfaces
O
traceDepth
TraceIRPConstDefs::TraceDepth trace_depth
M
traceRecordingSessionReference
TraceIRPConstDefs::TraceRecordingSessionReference trace_recording_session_reference
CM
traceTarget
TraceIRPConstDefs::TraceTarget trace_target
M
triggeringEvent
TraceIRPConstDefs::TriggeringEvent triggering_event
O
traceCollectionEntityAddress
TraceIRPConstDefs::TraceCollectionEntityAddress trace_collection_entity_address
CM

Table 5.2.4: Mapping from IS listActivatedTraceJobs parameters to SS equivalents
IS Operation parameter
SS Method parameter
Qualifier
traceReferenceList
TraceMIRPConstDefs::TraceReferenceList trace_reference_list
M
status
Return value of type TraceIRPConstDefs::Result
M

5.3	Notification parameter mapping
The TraceIRP: IS 3GPP TS 32.442 [7] defines semantics of parameters carried in notifications. The following table indicates the mapping of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [9]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [9], is:
Header
      Fixed Header
           domain_name
           type_name
           event_name
      Variable Header
Body
      filterable_body_fields
      remaining_body

The following tables list all OMG Structured Event attributes in the second column. The first column identifies the TraceIRP: IS 3GPP TS 32.442 [7] defined notification parameters.
Table 5.3.1: Mapping for notifyTraceRecordingSessionFailure
IS Parameters
OMG CORBA Structured Event attribute
Qualifier
Comment
There is no corresponding IS attribute.
domain_name
M
It carries the IRP document version number string. See subclause 3.1.
It indicates the syntax and semantics of the Structured Event as defined by the present document.
notificationType
type_name
M
This is constant string "notifyTraceRecordingSessionFailure".
There is no corresponding IS attribute.
event_name
M
It carries no information.
There is no corresponding IS attribute.
Variable Header


objectClass, objectInstance
One NV pair of filterable_body_fields
M
NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded in string.

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
notificationId
One NV pair of remaining_body
M
Name of NV pair is the NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a long. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
eventTime
One NV pair of filterable_body_fields
M
Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is IRPTime. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
systemDN
One NV pair of filterable_body_fields
M
Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
traceRecordingSessionReference
One NV pair of remaining_body
O
Name of NV pair is the TRACE_RECORDING_SESSION_REFERENCE of TraceIRPNotifications::notifyTraceRecordingSessionFailure.

Value of NV pair is TraceRecordingSessionReference of module TraceIRPConstDefs.
traceReference
One NV pair of filterable_body_fields
M
Name of NV pair is the TRACE_REFERENCE of TraceIRPNotifications::notifyTraceRecordingSessionFailure.

Value of NV pair is TraceReference of module TraceIRPConstDefs.
reason
One NV pair of remaining_body
O
Name of NV pair is the REASON of 
traceIRPNotifications:: notifyTraceRecordingSessionFailure.

Value of NV pair is a string.


Table 5.3.2: Mapping for notifyTraceSessionLocalActivation
IS Parameters
OMG CORBA Structured Event attribute
Qualifier
Comment
There is no corresponding IS attribute.
domain_name
M
It carries the IRP document version number string. See subclause 3.1.
It indicates the syntax and semantics of the Structured Event as defined by the present document.
notificationType
type_name
M
This is constant string "notifyThresholdMonitorObjectCreation".
There is no corresponding IS attribute.
event_name
M
It carries no information.
There is no corresponding IS attribute.
Variable Header


objectClass, objectInstance
One NV pair of filterable_body_fields
M
NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded in string.

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
notificationId
One NV pair of remaining body
M
Name of NV pair is the NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a long. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
eventTime
One NV pair of filterable_body_fields
M
Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is IRPTime. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
systemDN
One NV pair of filterable_body_fields 
M
Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
traceReference
One NV pair of filterable_body_fields
M
Name of NV pair is the TRACE_REFERENCE of module TraceIRPNotifications::notifyTraceSessionLocalActivation.

Value of NV pair is TraceReference of module TraceIRPConstDefs.
traceTarget
One NV pair of filterable_body_fields
M
Name of NV pair is the TRACE_TARGET of module TraceIRPNotifications::notifyTraceSessionLocalActivation.

Value of NV pair is TraceTarget of module TraceIRPConstDefs.
iOCInstance
One NV pair of filterable_body_fields
M
Name of NV pair is the IOC_INSTANCE of module TraceIRPNotifications::notifyTraceSessionLocalActivation.

Value of NV pair is MOClassName of module TraceIRPConstDefs.

Table 5.3.3: Mapping for notifyTraceSessionIdentities
IS Parameters
OMG CORBA Structured Event attribute
Qualifier
Comment
There is no corresponding IS attribute.
domain_name
M
It carries the IRP document version number string. See subclause 3.1.
It indicates the syntax and semantics of the Structured Event as defined by the present document.
notificationType
type_name
M
This is constant string "notifyTraceSessionIdentities".
There is no corresponding IS attribute.
event_name
M
It carries no information.
There is no corresponding IS attribute.
Variable Header


objectClass, objectInstance
One NV pair of filterable_body_fields
M
NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded in string.

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
notificationId
One NV pair of remaining body
M
Name of NV pair is the NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a long. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
eventTime
One NV pair of filterable_body_fields
M
Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is IRPTime. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
systemDN
One NV pair of filterable_body_fields 
M
Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]).
traceReference
One NV pair of filterable_body_fields
M
Name of NV pair is the TRACE_REFERENCE of module TraceIRPNotifications::notifyTraceSessionLocalActivation .

Value of NV pair is TraceReference of module TraceIRPConstDefs.
traceRecordingSessionReference
One NV pair of filterable_body_fields
M
Name of NV pair is the TRACE_RECORDING_SESSION_REFERENCE of TraceIRPNotifications::notifyTraceSessionIdentities

Value of NV pair is TraceReference of module TraceIRPConstDefs.
traceTarget
One NV pair of filterable_body_fields
M
Name of NV pair is the TRACE_TARGET of module TraceIRPNotifications::notifyTraceSessionIdentities.

Value of NV pair is TraceTarget of module TraceIRPConstDefs.
iOCInstance
One NV pair of filterable_body_fields
M
Name of NV pair is the IOC_INSTANCE of module TraceIRPNotifications::notifyTraceSessionIdentities.

Value of NV pair is MOClassName of module TraceIRPConstDefs.

6	TraceIRPNotification Interface
OMG CORBA Notification push operation is used to realise the notification of TraceIRP Notifications. All the notifications in this interface are implemented using this push_structured_event method.
6.1	Method push (M)
module CosNotifyComm {
…
Interface SequencePushConsumer : NotifyPublish {
void push_structured_events(
in CosNotification::EventBatch notifications)
		raises( CosEventComm::Disconnected);
…
}; // SequencePushConsumer
…
}; // CosNotifyComm

NOTE 1:	The push_structured_events method takes an input parameter of type EventBatch as defined in the OMG CosNotification module (OMG Notification Service [9]). This data type is the same as a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured Events being delivered to IRPManager by IRPAgent to which it is connected.
NOTE 2:	The maximum number of events that will be transmitted within a single invocation of this operation is controlled by IRPAgent wide configuration parameter.
NOTE 3:	The amount of time the supplier (IRPAgent) of a sequence of Structured Events will accumulate individual events into the sequence before invoking this operation is controlled by IRPAgent wide configuration parameter as well.
NOTE 4:	IRPAgent may push EventBatch with only one Structured Event.
Annex A (normative):
IDL specifications
A.1	IDL specification (file name "TraceIRPConstDefs.idl")
//File: TraceIRPConstDefs.idl
#ifndef _Trace_IRP_CONST_DEFS_IDL_
#define _Trace_IRP_CONST_DEFS_IDL_

// This statement must appear after all include statements
#pragma prefix "3gppsa5.org"

/* ## Module: TraceIRPConstDefs
This module contains commonly used definitions for Trace IRP
===============================================================
*/
module TraceIRPConstDefs
{

enum Result Enum {OK, FAILURE, PARTIAL_SUCCESS};



typedef struct TraceReference 
	{		short mcc;
		short mnc;
		unsigned long traceId;
	};
typedef sequence TraceReferenceList;


typedef unsigned long TraceRecordingSessionReference;

typedef string TraceCollectionEntityAddress;




/* the values of the InterfaceBitmap is coming from the ListOfInterfaces trace parameter definition in 3GPP TS 32.422. The InterfaceBitmap shall carry the decimal value that is calculated from the bitmap, defined in TS 32.422.*/

typedef struct Interfaces
	{	NeType NetworkElement;
		Integer InterfaceBitmap;
	};
typedef sequence  ListofInterfaces;


/*
ListOfInterfacesOptional is a type carrying a conditional parameter.
The boolean shall be TRUE, if the operation request uses this parameter. In this case the value is present. Otherwise the value is absent.
*/
union ListOfInterfacesOptional switch (boolean)
   {
   case TRUE: ListOfInterfaces value;
   };



enum NeType {MSC_SERVER,MGW,RNC,SGSN,GGSN,BM_SC,eNB,MME,SGW,PGW };

typedef sequence ListOfNeTypes;


enum TraceDepth {MINIMUM, MEDIUM, MAXIMUM, VENDORMINIMUM, VENDORMEDIUM, VENDORMAXIMUM}; 

enum TraceTarget {IMSI, IMEI, IMEISV, PUBLIC_ID, PRIVATE_ID, UTRAN_CELL, E-UTRAN_CELL };


/* the values of the EventBitmap is coming from the TriggeringEvent trace parameter definition in 3GPP TS 32.422. The EventBitmap shall carry the decimal value that is calculated from the triggereing event bitmap as defined in TS 32.422.*/

typedef struct Events
	{	NeType NetworkElement;
		Integer EventBitmap;
	};
typedef sequence  TriggeringEvent;




/*
TriggeringEventConditional is a type carrying a conditional parameter.
The boolean shall be TRUE, if the operation the condition is fulfilled and the request uses this parameter. In this case the value is present. Otherwise the value is absent.
*/
union TriggeringEventConditional switch (boolean)
   {
   case TRUE: TriggeringEvent value;
   };



enum UnsupportedItem {MANAGED_ENTITY, TRACE_DEPTH, LIST_OF_INTERFACES, TRACE_TARGET, REASON};

typedef sequence UnsupportedList;




/**
* This block identifies attributes which are included as part of the
* notifications defined within TraceIRP. These attribute values should not
* clash with those defined for the attributes of notification
* header (see IDL of Notification IRP).
*/

interface AttributeNameValue
{
   const string TRACE_RECORDING_SESSION_REFERENCE = "TRACE_RECORDING_SESSION_REFERENCE";
   const string TRACE_REFERENCE = "TRACE_REFERENCE";
   const string TRACE_TARGET = "TRACE_TARGET";
   const string MO_INSTANCE = "MO_INSTANCE";
   const string REASON = "REASON";
};

};
A.2	IDL specification (file name “TraceIRPSystem.idl”)
//File: TraceIRPSystem.idl
#ifndef _TRACE_IRP_SYSTEM_IDL_
#define _TRACE_IRP_SYSTEM_IDL_

#include 
#include 
#include #include 

//This statement must appear after all include statements
#pragma prefix "3gppsa5.org"

/* Module: TraceIRPSystem
This module contains the specification of all operations of Trace IRP Agent.
=============================================================================
*/
module TraceIRP
{
   exception ActivateTraceJob { string reason; };
   exception NotUniqueTraceReference { string reason; };
   exception DeactivateTraceJob { string reason; };
   exception ListTraceJob { string reason; };
   exception ListActivatedTraceJob { string reason; };

  interface TraceIRP
  {

    /**
    * Request to activate a TraceJob through Itf-N.
    **/

    TraceIRPConstDefs::ResultEnum activateTraceJob (
      in KernelCmConstDefs::DN                             moInstance,      
      in TraceIRPConstDefs::ListOfInterfacesOptional       listOfInterfaces,
      in TraceIRPConstDefs::ListOfNeTypes                  listOfNeTypes,
      in TraceIRPConstDefs::TraceDepth                     traceDepth,
      in TraceIRPConstDefs::TraceReference                 traceReference,
      in TraceIRPConstDefs::TraceTarget                    traceTarget,
      in TraceIRPConstDefs::TriggeringEventConditional     triggeringEvent,
      in TraceIRPConstDefs::TraceCollectionEntityAddress   traceCollectionEntityAddress,
      out TraceIRPConstDefs:: UnsupportedList              unsupportedList
    )
  raises (ActivateTraceJob,
          GenericIRPManagementSystem::InvalidParameter,
          GenericIRPManagementSystem::ValueNotSupported,
          GenericIRPManagementSystem::OperationNotSupported,
          NotUniqueTraceReference);

    /**
    * Request to deactivate a TraceJob through Itf-N.
    **/

    TraceIRPConstDefs::ResultEnum deactivateTraceJob (
      in TraceIRPConstDefs::TraceReference                  traceReference,
      in TraceIRPConstDefs::TraceTarget                     traceTarget,
      out TraceIRPConstDefs::TraceRecordingSessionReference traceRecordingSessionReference)
    raises (DeactivateTraceJob,
            NotUniqueTraceReference,
            GenericIRPManagementSystem::InvalidParameter,
            GenericIRPManagementSystem::ValueNotSupported,
            GenericIRPManagementSystem::OperationNotSupported);

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

    TraceIRPConstDefs::ResultEnum listTraceJob (
      in TraceIRPConstDefs::TraceReference                           traceReference,
      out KernelCmConstDefs::DN                                      moInstance,
      out TraceIRPConstDefs::ListOfInterfaces                        listOfInterfaces,
      out TraceIRPConstDefs::TraceDepth                              traceDepth,
      out TraceIRPConstDefs::TraceRecordingSessionReference          traceRecordingSessionReference,
      out TraceIRPConstDefs::TraceTarget                             traceTarget,
      out TraceIRPConstDefs::TriggeringEvent                         triggeringEvent,
      out TraceIRPConstDefs::TraceCollectionEntityAddress traceCollectionEntityAddress)
  
    raises (ListTraceJob,
            NotUniqueTraceReference,
            GenericIRPManagementSystem::InvalidParameter,
            GenericIRPManagementSystem::ValueNotSupported,
            GenericIRPManagementSystem::OperationNotSupported);

    /**
    * Request to list the activated TraceJobs through Itf-N.
    **/

    TraceIRPConstDefs::ResultEnum listActivatedTraceJob (
      out TraceIRPConstDefs::TraceReferenceList            traceReferenceList)
    raises (ListActivatedTraceJob,
            GenericIRPManagementSystem::InvalidParameter,
            GenericIRPManagementSystem::ValueNotSupported,
            GenericIRPManagementSystem::OperationNotSupported);
  };

};
#endif // _TRACE_IRP_SYSTEM_IDL_

A.3	IDL specification (file name “TraceIRPNotifications.idl”)
//File: TraceIRPNotifications.idl
#ifndef _TRACE_IRP_NOTIFICATIONS_IDL_
#define _TRACE_IRP_NOTIFICATIONS_IDL_

#include 
#include 

// This statement must appear after all include statements
#pragma prefix "3gppsa5.org"

/* Module: TraceIRPNotifications
This module contains the specification of all notifications of Trace IRP Agent.
=============================================================================
*/
module TraceIRPNotifications
{

  /**
  * Constant definitions for the notifyTraceRecordingSessionFailure notification
  **/

  interface NotifyTraceRecordingSessionFailure: NotificationIRPNotifications::Notify
  {
    const string EVENT_TYPE = "notifyTraceRecordingSessionFailure";

    /**
    * This constant defines the name of the TraceRecordingSessionReference property.
    * The data type for the value of this property is
    * TraceIRPConstDefs::TraceRecordingSessionReference.
    **/

    const string TRACE_RECORDING_SESSION_REFERENCE =             TraceIRPConstDefs::AttributeNameValue::TRACE_RECORDING_SESSION_REFERENCE;

    /**
    * This constant defines the name of the TraceReference property.
    * The data type for the value of this property is
    * TraceIRPConstDefs::TraceReference.
    **/

    const string TRACE_REFERENCE = TraceIRPConstDefs::AttributeNameValue::TRACE_REFERENCE;

  
    /**
    * This constant defines the name of the reason property.
    * The data type for the value of this property is string.
    */
      
    const string REASON = TraceIRPConstDefs::AttributeNameValue::REASON;
   };

  /**
  * Constant definitions for the notifyTraceSessionLocalActivation notification
  **/

  interface NotifyTraceSessionLocalActivation: NotificationIRPNotifications::Notify
  {
    const string EVENT_TYPE = "notifyTraceSessionLocalActivation";

    /**
    * This constant defines the name of the TraceReference property.
    * The data type for the value of this property is
    * TraceIRPConstDefs::TraceReference.
    **/

    const string TRACE_REFERENCE = TraceIRPConstDefs::AttributeNameValue::TRACE_REFERENCE;

    /**
    * This constant defines the name of the TraceTarget property.
    * The data type for the value of this property is
    * TraceIRPConstDefs::TraceTarget.
    **/

    const string TRACE_TARGET = TraceIRPConstDefs::AttributeNameValue::TRACE_TARGET;

  
    /**
    * This constant defines the name of the Managed Entity Object Instance property.
    * The data type for the value of this property is string.
    */
      
    const string MO_INSTANCE = TraceIRPConstDefs::AttributeNameValue::MO_INSTANCE;
   };


  /**
  * Constant definitions for the notifyTraceSessionIdentities notification
  **/

  interface NotifyTraceSessionIdentities: NotificationIRPNotifications::Notify
  {
    const string EVENT_TYPE = "notifyTraceSessionIdentities";

    /**
    * This constant defines the name of the TraceReference property.
    * The data type for the value of this property is
    * TraceIRPConstDefs::TraceReference.
    **/

    const string TRACE_REFERENCE = TraceIRPConstDefs::AttributeNameValue::TRACE_REFERENCE;

    /**
    * This constant defines the name of the TraceRecordingSessionReference property.
    * The data type for the value of this property is
    * TraceIRPConstDefs::TraceRecordingSessionReference.
    **/

    const string TRACE_RECORDING_SESSION_REFERENCE = 
        TraceIRPConstDefs::AttributeNameValue::TRACE_RECORDING_SESSION_REFERENCE;


    /**
    * This constant defines the name of the TraceTarget property.
    * The data type for the value of this property is
    * TraceIRPConstDefs::TraceTarget.
    **/

    const string TRACE_TARGET = TraceIRPConstDefs::AttributeNameValue::TRACE_TARGET;

  
    /**
    * This constant defines the name of the Managed Entity Object Instance property.
    * The data type for the value of this property is string.
    */
      
    const string MO_INSTANCE = TraceIRPConstDefs::AttributeNameValue::MO_INSTANCE;
   };

};

#endif // _TRACE_IRP_NOTIFICATIONS_IDL_

Annex B (informative):
Change history
Change history
DateTSG #TSG Doc.CRRevSubject/CommentCatOldNewJun 2007SA_36SP-070289----Submitted to SA#36 for Approval--1.0.07.0.0Dec 2008SA_42SP-0808460001--Introduction of EPS in Trace IRPB7.0.08.0.0Sep 2009SA-45SP-0905340002--Alignment of Trace IRP Corba SS with 3GPP TS 32.422F8.0.08.1.0Dec 2009----Update to Rel-9 version (MCC)--8.1.09.0.0Mar 2011SA-51SP-1100930004--Add the missing input parameter of activateTraceJob - Align with 32.442 Trace Management IRP Information ServiceA9.0.09.1.0










Page PAGE6












styleref ZA 3GPP TS 32.443 V9.1.0 (2011-03)
 PAGE 2
 STYLEREF ZGSM Release 9

3GPP