updated thresholdinfo, thereby removed CR22, file is same in R18 and R19 (f4549187) · Commits · SA5 – Management & Orchestration and Charging / Management and Orchestration APIs

yang-models/_3gpp-common-fm.yang

+140 −6

Original line number	Diff line number	Diff line
		@@ -7,7 +7,6 @@ module _3gpp-common-fm {
		import _3gpp-common-top { prefix top3gpp; }
		import _3gpp-common-yang-types { prefix types3gpp; }
		import _3gpp-common-yang-extensions { prefix yext3gpp; }
		import _3gpp-common-measurements { prefix meas3gpp; }

		organization "3GPP SA5";
		contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
		@@ -17,11 +16,9 @@ module _3gpp-common-fm {
		TTA, TTC). All rights reserved.";
		reference "3GPP TS 28.111";

		revision 2025-03-25 { reference CR-0026; }
		revision 2025-02-07 { reference CR-0022 ; }
		revision 2025-03-25 { reference "CR-0025 CR-0026"; }
		revision 2024-05-12 {
		description "The definition of the module was moved from TS 28.623 to
		TS 28.111";
		description "The definition of the module was from TS 28.623 to TS 28.111";
		reference CR-0008 ;
		}
		revision 2024-03-06 { reference CR-0333 ; }
		@@ -136,6 +133,141 @@ module _3gpp-common-fm {
		}
		}

		grouping ThresholdHysteresisGrp {
		description "The ThresholdHysteresis defines the threshold boundaries to
		control the hysteresis mechanism.

		The high attribute of ThresholdHysteresis identifies the higher value of
		a threshold with hysteris, the integer type is used for counter
		thresholds and the float type for gauge thresholds. The low attribute
		of ThresholdHysteresis identifies the lower value of a threshold with
		hysteresis, applicable only to gauge thresholds.";

		leaf high {
		type union {
		type int64;
		type decimal64 {
		fraction-digits 7;
		}
		}
		mandatory true;
		description "Higher value of a threshold with hysteris, the integer type
		is used for counter thresholds and the float type for gauge
		thresholds.";
		}

		leaf low {
		type decimal64 {
		fraction-digits 7;
		}
		description "Lower value of a threshold with hysteresis, applicable
		only to gauge thresholds.";
		}
		}

		grouping ThresholdLevelIndGrp {
		description "The up attribute indicates for counter and gauge thresholds
		that the threshold crossing occurred when going up. The down attribute
		only indicates for gauge thresholds that the threshold crossing occurred
		when going down, applicable only to gauge thresholds.";

		list up {
		description "Indicates for counter and gauge thresholds that the
		threshold crossing occurred when going up.";
		max-elements 1;
		key idx;
		leaf idx { type int32; }
		uses ThresholdHysteresisGrp;
		}

		list down {
		description "Indicates for gauge thresholds that the threshold crossing
		occurred when going down, applicable only to gauge thresholds.";
		max-elements 1;
		key idx;
		leaf idx { type int32; }
		uses ThresholdHysteresisGrp;
		}
		}

		grouping ThresholdCrossingGrp {
		description "The datatype indicates the crossed threshold
		information regardless of the gauge threshold, which represents an
		instantaneous value that changes over time, or the counter threshold,
		which represents monotonically increasing cumulative quantity.

		The observedMeasurement attribute of TheresholdInfo specifies the name
		of the monitored measurement that crossed the threshold and that
		caused the notification (Rec. ITU-T X. 733[8]). The observedValue
		attribute indicates the value of the gauge or counter which crossed
		the threshold. This may be different from the threshold value if, for
		example, the gauge may only take on discrete values. Integer values
		are used for counters and float values for gauges (Rec. ITU-T X. 733).
		Note that a 'number' type property can contain both integers and
		floating point numbers.

		For the thresholdLevel attribute, in the case of a gauge, it specifies
		a pair of threshold values, the first being the value of the crossed
		threshold and the second, its corresponding hysteresis; in the case of
		a counter, it specifies only the threshold value (Rec. ITU-T X. 733).

		For the armTime attribute, for a gauge threshold, it specifies the
		time at which the threshold was last re-armed, namely the time after
		the previous threshold crossing at which the hysteresis value of the
		threshold was exceeded thus again permitting generation of
		notifications when the threshold is crossed; for a counter threshold,
		the later of the time at which the threshold offset was last applied,
		or the time at which the counter was last initialized (for resettable
		counters) (Rec. ITU-T X. 733).";

		leaf observedMeasurement {
		type string;
		mandatory true;
		description "The name of the monitored measurement that crossed the
		threshold and that caused the notification (Rec. ITU-T X. 733 ";
		}

		leaf observedValue {
		type union {
		type int64;
		type decimal64 {
		fraction-digits 7;
		}
		}
		mandatory true;
		description "The value of the gauge or counter which crossed the
		threshold. This may be different from the threshold value if, for
		example, the gauge may only take on discrete values.
		Integer values are used for counters and float values for gauges
		(Rec. ITU-T X. 733). Note that a 'number' type property can contain
		both integers and floating point numbers.";
		}

		list thresholdLevel {
		description "In the case of a gauge the threshold level specifies
		a pair of threshold values, the first being the value of the crossed
		threshold and the second, its corresponding hysteresis; in the case
		of a counter the threshold level specifies only the threshold value
		(Rec. ITU-T X. 733).";
		max-elements 1;
		key idx;
		leaf idx { type int32; }
		uses ThresholdLevelIndGrp;
		}

		leaf armTime {
		type yang:date-and-time;
		description "For a gauge threshold, the time at which the threshold
		was last re-armed, namely the time after the previous threshold
		crossing at which the hysteresis value of the threshold was
		exceeded thus again permitting generation of notifications when the
		threshold is crossed. For a counter threshold, the later of the time
		at which the threshold offset was last applied, or the time at
		which the counter was last initialized (for resettable counters)
		(Rec. ITU-T X. 733)";
		}
		}

		grouping AlarmRecordGrp {
		description "Contains alarm information of an alarmed object instance.
		A new record is created in the alarm list when an alarmed object
		@@ -267,7 +399,9 @@ module _3gpp-common-fm {
		config false ;
		yext3gpp:notNotifyable;
		description "Indicates the crossed threshold";
		uses meas3gpp:ThresholdInfoGrp;
		key idx;
		leaf idx { type int32; }
		uses ThresholdCrossingGrp;
		}

		list stateChangeDefinition {