A.1 Parameter description and mapping table

32.4233GPPRelease 16Subscriber and equipment traceTelecommunication managementTrace data definition and managementTS

The following table describes the XML trace file parameters.

Table : XML trace file parameters

XML element / XML attribute specification

Description

traceCollecFile

This is the top-level element. It identifies the file as a collection of trace or MDT data. This element includes:

– a file header (element "fileHeader")

– the collection of trace data items (elements "traceRecSession").

fileHeader

This is the trace file header element. This element includes:

– a version indicator (attribute specification "fileFormatVersion")

– the PLMN for the Participating Operator on who’s behalf the Trace Session was performed (element "pOPLMN")

– the vendor name of the sending network node (attribute specification "vendorName")

– the name of the sending network node (attribute specification "fileSender elementDn")

– the type of the sending network node (attribute specification "fileSender elementType")

– a time stamp (attribute specification "traceCollec beginTime").

fileHeader fileFormatVersion

This attribute specification identifies the file format version applied by the sender. The format version defined in the present document shall be the abridged number and version of this 3GPP document (see below).

The abridged number and version of a 3GPP document is constructed from its version specific full reference "3GPP […] (yyyy-mm)" by:

– removing the leading "3GPP TS"

– removing everything including and after the version third digit, representing editorial only changes, together with its preceding dot character

– from the resulting string, removing leading and trailing white space, replacing every multi character white space by a single space character and changing the case of all characters to uppercase.

fileHeader pOPLMN

Optional element identifies the PLMN for the Participating Operator. This parameter can be used when the node that is recording the data is shared between operators.

fileHeader vendorName

Optional attribute specification that has the following value part: vendor of the equipment that provided the trace file.

fileSender elementDn

Optional attribute specification that uniquely identifies the NE or EM that assembled this trace file, according to the definitions in 3GPP TS 32.300 [11].

fileSender elementType

Optional attribute specification that identifies type of the network node that generated the file. For MDT case, this attribute only has the type of "RNC" or ""eNodeB".

traceCollec beginTime

This attribute specification contains a timestamp that refers to the start of the first trace data that is stored in this file. It is a complete timestamp including day, time and delta UTC hour. E.g. "2001-09-11T09:30:47-05:00".

traceRecSession

Optional element that contains the traced data associated to a Trace Recording Session. It includes:

– the DN prefix (attribute specification "dnPrefix")

– the trace session identifier (element specification "traceSessionRef")

– the trace recording session identifier (attribute specification "traceRecSessionRef")

– the start time of the call (attribute specification "stime")

– the ue identifier (element "ue")

– the traced messages (elements "msg") for trace or the UE measurements (elements "meas") for MDT

traceRecSession dnPrefix

Optional attribute specification that provides the DN prefix (see 3GPP TS 32.300 [11]).

traceSessionRef

This element provides a unique trace session identifier as described in 3GPP TS 32.421 [2]. Trace Reference is composed of MCC digits, MNC digits, and Trace ID where:

  • MCC is in BCD format, 3 digits in length (element specification "MCC")
  • MNC is in BCD format, 1 to 3 digits in length, with no filler digit for MNCs less than 3 digits (element specification "MNC")
  • Trace ID is in hexadecimal format, 6 digits in length, hex letters (A through F) are capitalized(element specification "TRACE_ID").

traceRecSession traceRecSessionRef

Attribute specification that provides a unique trace recording session identifier as described in 3GPP TS 32.421 [2] and 3GPP TS 32.422 [3]. Trace Recording Session Reference is represented in hexadecimal format. No filler digits for hex numbers of less than four digits. All hex letters (A thru F) are capitalized.

traceRecSession stime

Optional attribute specification that provides the start time of the call.

ue

This element gives the ue identifier provided in trace activation messages. It includes:

– the ue identifier type (attribute specification "idType")

– the ue identifier value (attribute specification "idValue")

This element shall not be present in the Trace record of E-UTRAN.

ue idType

Attribute specification that provides the ue identifier type (IMSI, IMEI (SV), TAC, or Public User Identity). For management based MDT, IMSI or IMEI(SV) can not be selected as ue idType.

ue idValue

Attribute specification that provides the ue identifier value, represented in decimal. This attribute is optional for management based MDT.

msg

This element contains the information associated to a traced message. This element will not be included if the file is from the MME for retrieving the IMSI/IMEI (SV) information. It includes:

– the function name associated to the traced message (attribute specification "function")

– the time difference with attribute specification "traceCollec beginTime" (attribute specification "changeTime")

– a boolean value that indicates if the message is vendor specific (attribute specification "vendorSpecific")

– the protocol message name (attribute specification "name")

– the NE initiator of the protocol message (element "initiator")

– the NE target(s) of the protocol message (element "target")

– the encoded protocol message (element "rawMsg")

– the traced IEs, either simple (elements "ie") or complex (elements "ieGroup"), in any order

This element is trace specific and not used for MDT.

msg function

Attribute specification that provides the function name associated to the traced message (e.g. Iuu, Iu CS, Iub, Intra frequency measurement, Gb, …). This attribute is trace specific and not used for MDT.

msg changeTime

Attribute specification that provides the time difference with attribute specification "traceCollec beginTime". It is expressed in number of seconds and milliseconds (nbsec.ms). This attribute is trace specific and not used for MDT.

msg vendorSpecific

Attribute specification whose value part is a boolean value that indicates if the message is vendor specific (true) or not (false). This attribute is trace specific and not used for MDT.

msg name

Attribute specification that provides the protocol message name. This attribute is trace specific and not used for MDT.

initiator

Optional element that identifies the NE initiator of the protocol message. Each includes:

– the type of the network node that initiate the message (attribute specification "type")

– the LDN of NE initiator of the protocol message (element’s content). The element’s content may be empty in case the initiator is the sender or the mobile

This element is trace specific and not used for MDT.

initiator type

Optional attribute specification that provides the type of the network node that initiate the message, e.g. "RNC", "SGSN". This element is trace specific and not used for MDT.

target

Optional element that identifies the NE target(s) of the protocol message. It includes:

– the type of the network node that receive the message (attribute specification "type")

– the LDN or IP Address of NE target of the protocol message (element’s content). The element’s content may be empty in case the target is the sender or the mobile

This element is trace specific and not used for MDT.

target type

Optional attribute specification that provides the type of the network node that receive the message, e.g. "RNC", "SGSN". This element is trace specific and not used for MDT.

NumOfTargets

Optional attribute specification that provides the number of targets that the message is sent to. This is populated ONLY if the Target is not explicitly specified and is useful when there are a large number of targets that the message is sent to. This attribute is trace specific and not used for MDT.

rawMsg

Optional element that contains the encoded protocol message. It includes:

– the protocol name associated to the event (attribute specification "protocol")

– the protocol version (attribute specification "version")

– the hexadecimal encoded form of the message (element’s content)

This element is available only if the trace depth is maximum.

This attribute is trace specific and not used for MDT.

rawMsg protocol

Attribute specification that provides the protocol name associated to the event (e.g. "Ranap"). This attribute is trace specific and not used for MDT.

rawMsg version

Attribute specification that provides the protocol version. This attribute is trace specific and not used for MDT.

ieGroup

Optional element that contains a complex traced IE, i.e. an IE that contains other traced IEs. It includes:

– the IE group name (attribute specification "name")

– the IE group value (attribute specification "value")

– zero or more traced IEs, either simple (elements "ie") or complex (elements "ieGroup"), in any order

This element is available only if the trace depth is medium or minimum.

This attribute is trace specific and not used for MDT.

ieGroup name

Optional attribute specification that provides the IE group name (e.g. "RAB parameters").

ieGroup value

Optional attribute specification that provides the IE group value when it exists (e.g. "RAB identifier"). This attribute is trace specific and not used for MDT.

ie

Optional element that contains a simple traced IE, i.e. an IE decoded from the traced message. It includes:

– the IE name (attribute specification "name")

– the IE value (element’s content)

This element is available only if the trace depth is medium or minimum.

This attribute is trace specific and not used for MDT.

ie name

Attribute specification that provides the IE name (e.g. "Minimum DL Power"). This attribute is trace specific and not used for MDT.

meas

This element contains the information associated to a UE measurement in MDT task. It includes:

– the measurement name (attribute specification "meas name")

– the measurement value (element’s content)

This element is MDT specific and not used for trace.

meas name

Attribute specification that provides the IE name. The IEs are specified in the Trace Record for Immediate MDT measurements table. This attribute is MDT specific and not used for trace.

meas changeTime

Attribute specification that provides the time difference with attribute specification "traceCollec beginTime". It is expressed in number of seconds and milliseconds (nbsec.ms). This attribute is MDT specific and not used for trace.

meas vendorSpecific

Attribute specification whose value part is a boolean value that indicates if the measurement is vendor specific (true) or not (false). The vendor specific measurements are taken at eNB or RNC. This attribute is MDT specific and not used for trace.

target cell

Attribute identifies the serving cell that the UE measurement is taken. This attribute is MDT specific and not used for trace.

UE location

Optional attribute that identifies the UE location information when the measurement is taken. The IEs are specified in the Trace Record for UE location information table.This attribute is MDT specific and not used for trace.