Update _3gpp-common-trace.yang with appropriate descriptions and parameter... (08dacbda) · Commits · SA5 – Management & Orchestration and Charging / Management and Orchestration APIs

yang-models/_3gpp-common-trace.yang

+110 −99

Original line number	Diff line number	Diff line
		@@ -497,8 +497,8 @@ module _3gpp-common-trace {
		enum IMEISV;
		enum PUBLIC_ID;
		enum UTRAN_CELL;
		enum E_UTRAN_CELL;
		enum NG_RAN_CELL;
		enum E-UTRAN_CELL;
		enum NG-RAN_CELL;
		enum ENB;
		enum RNC;
		enum GNB;
		@@ -514,13 +514,21 @@ module _3gpp-common-trace {
		attribute is applicable for both Trace and MDT. This attribute
		includes the ID type of the target as an enumeration and the ID value.

		The traceTarget shall be public ID in case of a Management Based
		Activation is done to an ScscfFunction. The traceTarget shall be
		cell only in case of the UTRAN cell traffic trace function.
		The traceTarget shall be "PUBLIC_ID" "in case of a Management Based
		Activation is done to an SCSCFFunction (Serving Call Session Control Function)
		or PCSCFFunction (Proxy Call Session Control Function)

		The traceTarget shall be E-UtranCell only in case of E-UTRAN cell
		traffic trace function.The traceTarget shall be either IMSI or
		IMEI(SV) if the Trace Session is activated to any of the following
		The traceTarget shall be "UTRAN_CELL" only in case of
		UTRAN cell traffic trace function.

		The traceTarget shall be "E-UTRAN_CELL" only in case of E-UTRAN cell
		traffic trace function.

		The traceTarget shall be "NG-RAN_CELL" only in case of E-UTRAN cell
		traffic trace function.

		The traceTarget shall be either "IMSI", "IMEI" or
		"IMEISV" if the Trace Session is activated to any of the following
		ManagedEntity(ies):
		- HssFunction
		- MscServerFunction
		@@ -529,28 +537,35 @@ module _3gpp-common-trace {
		- BmscFunction
		- RncFunction
		- MmeFunction

		The traceTarget shall be IMSI if the Trace Session is activated to a
		ManagedEntity playing a role of ServinGWFunction.

		In case of signaling based Trace/MDT, the traceTarget attribute shall
		be able to carry (IMSI or IMEI(SV)or SUPI), the areaScope attribute
		shall be able to carry a list of (cell or E-UtranCell or NRCellDU or
		TA/LA/RA).
		- ServingGWFunction
		- PGWFunction

		The traceTarget shall be either “SUPI” or “IMEISV” if the Trace Session
		is activated to any of the following ManagedEntity(ies):
		- AFFunction
		- AMFFunction
		- AUSFunction
		- NEFFunction
		- NRFFunction
		- NSSFFunction
		- PCFFunction
		- SMFFunction
		- UPFFunction
		- UDMFunction


		In case of signalling based MDT, the traceTarget attribute shall be
		able to carry "PUBLIC_ID", "IMSI", "IMEI", "IMEISV)" or "SUPI".

		In case of management based Immediate MDT, the traceTarget attribute
		shall be null value, the areaScope attribute shall carry a list of
		(Utrancell or E-UtranCell or NRCellDU).
		shall be null value.

		In case of management based Logged MDT, the traceTarget attribute
		shall carry an eBs or a RNC or gNBs. The Logged MDT should be initiated
		on the specified eNB or RNC or gNB in traceTarget. The areaScope
		attribute shall carry a list of (Utrancell or E-UtranCell or NRCellDU or
		TA/LA/RA).
		shall carry an "eNB" or a "gNB" or an "RNC".
		The Logged MDT should be initiated on the specified eNB/gNB/RNC in traceTarget.

		In case of RLF reporting, or RCEF reporting, the traceTarget
		attribute shall be null value, the areaScope attribute shall carry
		one or list of eNBs/gNBs";
		attribute shall be null value.
		reference "3GPP TS 32.422";
		}

		@@ -564,14 +579,14 @@ module _3gpp-common-trace {
		reference "Clause 5.1 of 3GPP TS 32.422";
		}

		leaf MDTAnonymizationOfData {
		leaf AnonymizationOfMDTData {
		when ../areaScope ;
		type enumeration {
		enum NO_IDENTITY;
		enum TAC_OF_IMEI;
		}
		default NO_IDENTITY;
		description "Specifies level of MDT anonymization.";
		description "Specifies the level of anonymization for management based MDT.";
		reference "3GPP TS 32.422 clause 5.10.12.";
		}

		@@ -607,7 +622,7 @@ module _3gpp-common-trace {
		uses AreaScopeGrp;
		}

		leaf MDTCollectionPeriodRrmLte {
		leaf CollectionPeriodRrmLte {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint32 {
		@@ -622,7 +637,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.20 of 3GPP TS 32.422";
		}

		leaf MDTCollectionPeriodM6Lte {
		leaf CollectionPeriodM6Lte {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint32 {
		@@ -636,7 +651,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.32 of TS 32.422 ";
		}

		leaf MDTCollectionPeriodM7Lte {
		leaf CollectionPeriodM7Lte {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint16 {
		@@ -649,7 +664,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.22 of TS 32.422 .";
		}

		leaf MDTCollectionPeriodRrmUmts {
		leaf CollectionPeriodRrmUmts {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint32 {
		@@ -664,7 +679,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.21 of 3GPP TS 32.422";
		}

		leaf MDTCollectionPeriodRrmNR {
		leaf CollectionPeriodRrmNR {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint32 {
		@@ -678,7 +693,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.30 of 3GPP TS 32.422";
		}

		leaf MDTCollectionPeriodM6NR {
		leaf CollectionPeriodM6NR {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type enumeration {
		@@ -704,7 +719,7 @@ module _3gpp-common-trace {
		reference "clause 5.10.34 of TS 32.422";
		}

		leaf MDTCollectionPeriodM7NR {
		leaf CollectionPeriodM7NR {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint32 {
		@@ -717,7 +732,7 @@ module _3gpp-common-trace {
		reference "clause 5.10.35 of TS 32.422";
		}

		leaf MDTEventListForTriggeredMeasurement {
		leaf EventListForTriggeredMeasurement {
		when '../jobType = "LOGGED_MDT_ONLY"';
		type enumeration {
		enum OUT_OF_COVERAGE ;
		@@ -733,7 +748,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.28 of 3GPP TS 32.422";
		}

		leaf MDTEventThreshold {
		leaf EventThreshold {
		type int64;
		description "Specifies the threshold which should trigger the reporting
		in case A2 event reporting in LTE or 1F/1l event in UMTS. The attribute
		@@ -743,7 +758,7 @@ module _3gpp-common-trace {
		reference "Clauses 5.10.7 and 5.10.7a of 3GPP TS 32.422";
		}

		leaf MDTListOfMeasurements {
		leaf ListOfMeasurements {
		when '../jobType = "IMMEDIATE_MDT_ONLY"';
		type int64;
		mandatory true;
		@@ -753,7 +768,7 @@ module _3gpp-common-trace {
		reference "3GPP TS 32.422 clause 5.10.3";
		}

		leaf MDTLoggingDuration {
		leaf LoggingDuration {
		when '../jobType = "LOGGED_MDT_ONLY" or ../jobType = "LOGGED_MBSFN_MDT"';
		type uint32 {
		range "600\|1200\|2400\|3600\|5400\|7200";
		@@ -767,7 +782,7 @@ module _3gpp-common-trace {
		reference "5.10.9 of 3GPP TS 32.422";
		}

		leaf MDTLoggingInterval {
		leaf LoggingInterval {
		when '../jobType = "LOGGED_MDT_ONLY" or ../jobType = "LOGGED_MBSFN_MDT"';
		type uint32 {
		range "1280\|2560\|5120\|10240\|20480\|"
		@@ -781,47 +796,47 @@ module _3gpp-common-trace {
		reference "5.10.8 of 3GPP TS 32.422";
		}

		leaf MDTLoggingEventThreshold {
		leaf EventThresholdL1 {
		when '../jobType = "LOGGED_MDT_ONLY" or ../jobType = "LOGGED_MBSFN_MDT"';
		type uint32 {
		range "0..127";
		}
		description "It specifies the threshold which should trigger
		the reporting in case of event based reporting of logged NR MDT.
		The attribute is applicable only for Logged MDT and when MDTReportType
		The attribute is applicable only for Logged MDT and when ReportType
		is configured for event triggered reporting and when
		MDTEventListForTriggeredMeasurement is configured for L1 event.
		EventListForTriggeredMeasurement is configured for L1 event.
		In case this attribute is not used, it carries a null semantic.";
		reference "clause 5.10.36 of TS 32.422";
		}

		leaf MDTLoggedHysteresis {
		leaf Hysteresisl1 {
		when '../jobType = "LOGGED_MDT_ONLY" or ../jobType = "LOGGED_MBSFN_MDT"';
		type uint32 {
		range "0..30";
		}
		description "It specifies the hysteresis used within the entry and leave
		condition of the L1 event based reporting of logged NR MDT.
		The attribute is applicable only for Logged MDT, when MDTReportType
		The attribute is applicable only for Logged MDT, when ReportType
		is configured for event triggered reporting and when
		MDTEventListForTriggeredMeasurement is configured for L1 event.
		EventListForTriggeredMeasurement is configured for L1 event.
		In case this attribute is not used, it carries a null semantic.";
		reference "clause 5.10.37 of TS 32.422";
		}

		leaf MDTLoggedTimeToTrigger {
		leaf TimeToTriggerL1 {
		when '../jobType = "LOGGED_MDT_ONLY" or ../jobType = "LOGGED_MBSFN_MDT"';
		type int32 ;
		description "It specifies the threshold which should trigger
		the reporting in case of event based reporting of logged NR MDT.
		The attribute is applicable only for Logged MDT, when MDTReportType
		The attribute is applicable only for Logged MDT, when ReportType
		is configured for event triggered reporting and when
		MDTEventListForTriggeredMeasurement is configured for L1 event.
		EventListForTriggeredMeasurement is configured for L1 event.
		In case this attribute is not used, it carries a null semantic.";
		reference "clauses 5.10.38 of TS 32.422";
		}

		leaf-list MDTMBSFNAreaList {
		leaf-list MBSFNAreaList {
		when '../jobType = "LOGGED_MBSFN_MDT"';
		type string;
		min-elements 1;
		@@ -832,7 +847,7 @@ module _3gpp-common-trace {
		reference "5.10.25 of 3GPP TS 32.422";
		}

		leaf MDTMeasurementPeriodLTE {
		leaf MeasurementPeriodLTE {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint32 {
		@@ -848,7 +863,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.23 of 3GPP TS 32.422";
		}

		leaf MDTMeasurementPeriodUMTS {
		leaf MeasurementPeriodUMTS {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ 'or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint32 {
		@@ -864,7 +879,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.22 of 3GPP TS 32.422";
		}

		leaf MDTMeasurementQuantity {
		leaf MeasurementQuantity {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint64 ;
		@@ -874,7 +889,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.15 of 3GPP TS 32.422";
		}

		leaf MDTM4ThresholdUmts {
		leaf EventThresholdUphUMTS {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type uint16 {
		@@ -887,7 +902,7 @@ module _3gpp-common-trace {
		reference "3GPP TS 32.422 clause 5.10.A";
		}

		list MDTPLMList {
		list PlmnList {
		when '../jobType = "LOGGED_MDT_ONLY"';
		key "mcc mnc";
		uses types3gpp:PLMNId;
		@@ -898,7 +913,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.24 of 3GPP TS 32.422";
		}

		leaf MDTPositioningMethod {
		leaf PositioningMethod {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' or ../jobType = "IMMEDIATE_MDT_AND_TRACE"';
		type enumeration {
		@@ -911,7 +926,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.19 of 3GPP TS 32.422";
		}

		leaf MDTReportAmount {
		leaf ReportAmount {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' and ../MDTReportingTrigger = "PERIODICAL"';
		type union {
		@@ -926,12 +941,12 @@ module _3gpp-common-trace {
		description "It specifies the number of measurement reports that shall be
		taken for periodic reporting while the UE is in connected.
		The attribute is applicable only for Immediate MDT and when
		MDTReportingTrigger is configured for periodical measurements. In
		ReportingTrigger is configured for periodical measurements. In
		case this attribute is not used, it carries a null semantic.";
		reference "Clause 5.10.6 of 3GPP TS 32.422";
		}

		leaf MDTReportingTrigger {
		leaf ReportingTrigger {
		when '../jobType = "IMMEDIATE_MDT_ONLY"';
		type enumeration {
		enum PERIODICAL;
		@@ -945,13 +960,13 @@ module _3gpp-common-trace {
		description "It specifies whether periodic or event based measurements
		should be collected.
		The attribute is applicable only for Immediate MDT and when the
		MDTListOfMeasurements is configured for M1 (for both UMTS and LTE)
		ListOfMeasurements is configured for M1 (for both UMTS and LTE)
		or M2 (only for UMTS). In case this attribute is not used, it carries
		a null semantic.";
		reference "Clause 5.10.4 of 3GPP TS 32.422";
		}

		leaf MDTReportInterval {
		leaf ReportInterval {
		when '../jobType = "IMMEDIATE_MDT_ONLY"'
		+ ' and ../MDTReportingTrigger = "PERIODICAL"';
		type uint32 {
		@@ -965,12 +980,12 @@ module _3gpp-common-trace {
		description "It specifies the interval between the periodical measurements
		that shall be taken when the UE is in connected mode.
		The attribute is applicable only for Immediate MDT and when
		MDTReportingTrigger is configured for periodical measurements. In case
		ReportingTrigger is configured for periodical measurements. In case
		this attribute is not used, it carries a null semantic.";
		reference "5.10.5 of 3GPP TS 32.422";
		}

		leaf MDTReportType {
		leaf ReportType {
		when '../jobType = "LOGGED_MDT_ONLY"';
		type enumeration {
		enum PERIODICAL;
		@@ -981,7 +996,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.27 of 3GPP TS 32.422";
		}

		leaf MDTSensorInformation {
		leaf MensorInformation {
		type bits {
		bit BAROMETRIC_PRESSURE;
		bit UE_SPEED;
		@@ -995,7 +1010,7 @@ module _3gpp-common-trace {
		reference "Clause 5.10.29 of 3GPP TS 32.422";
		}

		leaf MDTTraceCollectionEntityID {
		leaf TraceCollectionEntityID {
		when '../jobType = "LOGGED_MDT_ONLY" or ../jobType = "LOGGED_MBSFN_MDT"';
		type uint8;
		mandatory true;
		@@ -1104,31 +1119,30 @@ module _3gpp-common-trace {
		- In case of IMMEDIATE_MDT_ONLY additionally the following attributes
		shall be available:
		- traceTarget
		- MDTAnonymizationOfData,
		- MDTListOfMeasurements,
		- MDTCollectionPeriodRrmUmts (conditional for M3, M4 and M5 in UMTS),
		- MDTMeasurementPeriodUMTS (conditional for M6 and M7 in UMTS),
		- MDTCollectionPeriodRrmLte (conditional for M2 and M3 in LTE),
		- MDTMeasurementPeriodLTE (conditional for M4 and M5 in LTE),
		- MDTCollectionPeriodM6Lte (conditional for M6 in LTE),
		- MDTCollectionPeriodM7Lte (conditional for M7 in LTE),
		- MDTCollectionPeriodRrmNR (conditional for M4 and M5 in NR),
		- MDTCollectionPeriodM6NR (conditional for M6 in NR),
		- MDTCollectionPeriodM7NR (conditional for M7 in NR),
		- MDTReportInterval (conditional for M1 in LTE or NR and M1/M2 in
		- AnonymizationOfData,
		- ListOfMeasurements,
		- CollectionPeriodRrmUmts (conditional for M3, M4 and M5 in UMTS),
		- MeasurementPeriodUMTS (conditional for M6 and M7 in UMTS),
		- CollectionPeriodRrmLte (conditional for M2 and M3 in LTE),
		- MeasurementPeriodLTE (conditional for M4 and M5 in LTE),
		- CollectionPeriodM6Lte (conditional for M6 in LTE),
		- CollectionPeriodM7Lte (conditional for M7 in LTE),
		- CollectionPeriodRrmNR (conditional for M4 and M5 in NR),
		- CollectionPeriodM6NR (conditional for M6 in NR),
		- CollectionPeriodM7NR (conditional for M7 in NR),
		- ReportInterval (conditional for M1 in LTE or NR and M1/M2 in
		UMTS),
		- MDTReportAmount (conditional for M1 in LTE or NR and M1/M2 in
		- ReportAmount (conditional for M1 in LTE or NR and M1/M2 in
		UMTS),
		- MDTReportingTrigger (conditional for M1 in LTE or NR and M1/M2 in
		- ReportingTrigger (conditional for M1 in LTE or NR and M1/M2 in
		UMTS),
		- MDTEventThreshold (conditional for A2 event reporting or A2 event
		- EventThreshold (conditional for A2 event reporting or A2 event
		triggered periodic reporting),
		- MDTMeasurementQuantity (conditional for 1F event reporting).
		- MeasurementQuantity (conditional for 1F event reporting).

		For this case the optional attribute areaScope allows to specify
		the area in terms of cells or Tracking Area/Routing Area/Location area
		where the MDT data collection shall take place and the optional
		attributes MDTPositioningMethod, MDTSensorInformation allow to
		For this case the optional attribute areaScope defines the area scope
		of MDT, which is specified in clause 5.10.2 of TS 32.44. Additionally, the optional
		attributes PositioningMethod, SensorInformation allow to
		specify the positioning methods to use or the sensor information to
		include.

		@@ -1136,30 +1150,27 @@ module _3gpp-common-trace {
		TRACE_ONLY and IMMEDIATE_MDT_ONLY shall apply.

		- In case of LOGGED_MDT_ONLY additionally the following attributes
		shall be available: traceTarget, MDTAnonymizationOfData,
		MDTTraceCollectionEntityID, MDTLoggingInterval,
		MDTLoggingDuration, MDTReportType,
		MDTEventListForTriggeredMeasurements.

		For this case the optional attribute areaScope allows to specify
		the area in terms of cells or Tracking Area/Routing Area/Location area
		where the MDT data collection shall take place, the optional attribute
		MDTPLMNList allows to specify the PLMNs where measurement collection,
		shall be available: traceTarget, AnonymizationOfData,
		TraceCollectionEntityID, LoggingInterval,
		LoggingDuration, ReportType,
		EventListForTriggeredMeasurements.

		For this case the optional attribute areaScope defines the area
		scope of MDT, which is specified in clause 5.10.2 of TS 32.422.
		Additionaly, the optional attribute PLMNList allows to specify the PLMNs where measurement collection,
		status indication and log reporting is allowed, the optional attribute
		areaConfigurationForNeighCell allows to specify the area for
		which UE is requested to perform measurements logging for neighbour
		cells which have list of frequencies and the optional attribute
		MDTSensorInformation allows to specify the sensor information to
		SensorInformation allows to specify the sensor information to
		include.

		- In case of RLF_REPORT_ONLY and RCEF_REPORT_ONLY additionally the
		attribute traceTarget shall be available, the optional attribute
		areaScope allows to specify the eNB or list of eNBs or gNB or
		list of gNBs where the reports should be collected.
		attribute traceTarget shall be available.

		- In case of LOGGED_MBSFN_MDT additionally the following attributes
		shall be available: MDTAnonymizationOfData, MDTLoggingInterval,
		MDTLoggingDuration, MDTMBSFNAreaList.
		shall be available: AnonymizationOfData, LoggingInterval,
		LoggingDuration, MBSFNAreaList.

		Creation and deletion of TraceJob instances by MnS consumers is optional;
		when not supported, the TraceJob instances may be created and deleted by