A.2 XML file format definition – TechSpec

A.2 XML file format definition

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

Tools: ARFCN - Frequency Conversion for 5G NR/LTE/UMTS/GSM

For encoding of the information content, XML (see Extensible Markup Language (XML) 1.0, W3C Recommendation [5] , [6], [7], [8] and [9]) will be used. The XML schema contains the mark-up declarations that provide a grammar for the trace file format. The XML schema is defined below.

A.2.1 XML trace/MDT file diagram

The following figure A.2.1-1 describes the XML element structure of a trace/MDT XML file.

Figure A.2.1-1 : XML trace/MDT file diagram

NOTE: In case a trace only recording session, the elements/attributes (such as "meas") which are specific to MDT but not used for trace should be excluded from the file; In case a MDT only recording session, the elements/attributes (such as "msg") which are specific to trace but not used for MDT should be excluded from the file: In case of a combined trace and MDT recording session, all the elements/attributes are included in the file.

A.2.2 Trace data file XML schema

The following XML schema traceData.xsd is the schema for trace or MDT data XML files:

<?xml version="1.0" encoding="UTF-8"?>

<!–

3GPP TS 32.423 Subscriber and Equipment Trace or MDT data definition and management

Trace data file XML schema

traceData.xsd

–>

<schema

targetNamespace=

"http://www.3gpp.org/ftp/specs/archive/32_series/32.423#traceData"

elementFormDefault="qualified"

xmlns="http://www.w3.org/2001/XMLSchema"

xmlns:td=

"http://www.3gpp.org/ftp/specs/archive/32_series/32.423#traceData"

>

<!– XML types specific for Trace data file –>

<complexType name="TraceReference">
<sequence>
<element name="MCC" type="td:MCCtype"/>

<element name="MNC" type="td:MNCtype"/>

<element name="TRACE_ID" type="td:Trace_IDtype"/>

</sequence>

</complexType>

<simpleType name="traceRecSessionRef">

<restriction base="hexBinary">

<maxLength value="2"/>

</restriction>

</simpleType>

<simpleType name="MCCtype">

<restriction base="string">

<pattern value="\d{3}"/>

</restriction>

</simpleType>

<simpleType name="MNCtype">

<restriction base="positiveInteger">

<maxExclusive value="1000"/>

</restriction>

</simpleType>

<complexType name="PLMNtype">

<sequence>

<element name="MCC" type="td:MCCtype"/>

<element name="MNC" type="td:MNCtype"/>

</sequence>

</complexType>

<simpleType name="Trace_IDtype">

<restriction base=" hexBinary">

<length value="3"/>

</restriction>

</simpleType>

<!– Trace data file root XML element –>

<element name="traceCollecFile">

<complexType>

<sequence>

<element name="fileHeader">

<complexType>

<sequence>

<element name="fileSender">

<complexType>

<attribute name="elementDn" type="string" use="optional"/>

<attribute name="elementType" type="string" use="optional"/>

</complexType>

</element>

<element name="traceCollec">

<complexType>

<attribute name="beginTime" type="dateTime" use="required"/>

</complexType>

</element>

<element name="pOPLMN" type="td:PLMNtype" minOccurs="0" maxOccurs="1"/> </sequence>

<attribute name="fileFormatVersion" type="string" use="required"/>

<attribute name="vendorName" type="string" use="optional"/>

</complexType>

</element>

<element name="traceRecSession" minOccurs="0" maxOccurs="unbounded">

<complexType>

<sequence>

<element name="ue" minOccurs="0">

<complexType>

<attribute name="idType" type="string" use="required" />

<attribute name="idValue" type="long" use="required"/>

</complexType>

</element>

<!– Element specific to trace data file –>

<element name="msg" minOccurs="0" maxOccurs="unbounded">

<complexType>

<sequence>

<element name="initiator" minOccurs="0">

<complexType>

<simpleContent>

<extension base="string">

<attribute name="type" type="NCName" use="optional"/>

</extension>

</simpleContent>

</complexType>

</element>

<element name="target" minOccurs="0" maxOccurs="unbounded">

<complexType>

<simpleContent>

<extension base="string">

<attribute name="type" type="NCName" use="optional"/>

</extension>

</simpleContent>

</complexType>

</element>

<element name="rawMsg" minOccurs="0">

<complexType>

<simpleContent>

<extension base="hexBinary">

<attribute name="protocol" type="string" use="required"/>

<attribute name="version" type="string" use="required"/>

<attribute name="NumOfTargets" type="integer" use="optional"/>

</extension>

</simpleContent>

</complexType>

</element>

<choice minOccurs="0" maxOccurs="unbounded">

<element ref="td:ie"/>

<element ref="td:ieGroup"/>

</choice>

</sequence>

<attribute name="function" type="string" use="required"/>

<attribute name="name" type="string" use="required"/>

<attribute name="changeTime" type="float" use="required"/>

<attribute name="vendorSpecific" type="boolean" use="required"/>

</complexType>

</element>

<!– Element specific to MDT data file –>

<element name="meas" minOccurs="0" maxOccurs="unbounded">

<complexType>

<simpleContent>

<extension base="string">

<attribute name="name" type="string" use="required"/>

<attribute name="changeTime" type="float" use="required"/>

<attribute name="vendorSpecific" type="boolean" use="required"/>

<attribute name="targetCell" type="string" use="required"/>

<attribute name="ueLocation" type="string" use="optional"/>

</extension>

</simpleContent>

</complexType>

</element>

<element name="traceSessionRef" type="td:TraceReference"/>

</sequence>

<attribute name="dnPrefix" type="string" use="optional"/>

<attribute name="traceRecSessionRef" type="td:traceRecSessionRef" use="required"/>

<attribute name="stime" type="dateTime" use="optional"/>

</complexType>

</element>

</sequence>

</complexType>

</element>

<!– Additional supporting XML elements –>

<element name="ieGroup">

<complexType>

<choice minOccurs="0" maxOccurs="unbounded">

<element ref="td:ie"/>

<element ref="td:ieGroup"/>

</choice>

<attribute name="name" type="string" use="optional"/>

<attribute name="value" type="string" use="optional"/>

</complexType>

</element>

<element name="ie">

<complexType>

<simpleContent>

<extension base="string">

<attribute name="name" type="string" use="required"/>

</extension>

</simpleContent>

</complexType>

</element>

</schema>

Annex B (normative):
Trace Report File Conventions and Transfer Procedure