4 Structure and content of configuration data XML files

32.6253GPPConfiguration Management (CM)Generic network resources Integration Reference Point (IRP): Bulk CM eXtensible Markup Language (XML) file format definitionRelease 9Telecommunication managementTS

The overall description of the file format of configuration data XML files is provided by 3GPP TS 32.615 [3].

Annex A of the present document defines the NRM-specific XML schema genericNrm.xsd for the Generic Network Resources IRP NRM defined in 3GPP TS 32.622 [1].

XML schema genericNrm.xsd explicitly declares NRM-specific XML element types for the related NRM.

The definition of those NRM-specific XML element types complies with the generic mapping rules defined in 3GPP TS 32.615 [3], with the following exception: as defined in 3GPP TS 32.615 [3], the vsData XML element type has an empty XML content.

Additionally, XML schema genericNrm.xsd also provides the following global XML declarations and definitions:

– XML complex type NrmClass: derivation base type (see [5], [6] and [7]) for all NRM class associated XML element types (see 3GPP TS 32.615 [3]);

– XML element type vsData: derivation base type (see [5], [6] and [7]) for all vendor-specific XML element types (see 3GPP TS 32.615 [3]);

– XML element type SubNetworkOptionallyContainedNrmClass: substitution group head (see [5], [6] and [7]) for all XML element types associated to further NRM classes optionally contained under SubNetwork NRM class;

– XML element type ManagedElementOptionallyContainedNrmClass: substitution group head (see [5], [6] and [7]) for all XML element types associated to further NRM classes optionally contained under ManagedElement NRM class.

Annex A (normative):
Configuration data file NRM-specific XML schema (file name "genericNrm.xsd")

The following XML schema genericNrm.xsd is the NRM-specific schema for the Generic Network Resources IRP NRM defined in 3GPP TS 32.622 [1]:

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

<!–

3GPP TS 32.625 Generic Network Resources IRP

Bulk CM Configuration data file NRM-specific XML schema

genericNrm.xsd

–>

<schema

targetNamespace="http://www.3gpp.org/ftp/specs/archive/32_series/32.625#genericNrm"

elementFormDefault="qualified"

attributeFormDefault="unqualified"

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

xmlns:xn="http://www.3gpp.org/ftp/specs/archive/32_series/32.625#genericNrm"

>

<!– Base XML type for all NRM class associated XML elements –>

<complexType name="NrmClass">

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

<attribute name="modifier" use="optional">

<simpleType>

<restriction base="string">

<enumeration value="create"/>

<enumeration value="delete"/>

<enumeration value="update"/>

</restriction>

</simpleType>

</attribute>

</complexType>

<!– Generic Network Resources IRP NRM attribute related XML types –>

<simpleType name="dn">

<restriction base="string">

<maxLength value="400"/>

</restriction>

</simpleType>

<complexType name="dnList">

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

<element name="dn" type="xn:dn"/>

</sequence>

</complexType>

<simpleType name="linkType">

<list>

<simpleType>

<restriction base="string">

<enumeration value="Signalling"/>

<enumeration value="Bearer"/>

<enumeration value="OAM_AND_P"/>

<enumeration value="Other"/>

</restriction>

</simpleType>

</list>

</simpleType>

<complexType name="linkListType">

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

<element name="dn" type="xn:dn"/>

</sequence>

</complexType>

<!– Generic Network Resources IRP NRM class associated XML elements –>

<element name="SubNetwork">

<complexType>

<complexContent>

<extension base="xn:NrmClass">

<sequence>

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

<complexType>

<all>

<element name="userLabel" minOccurs="0"/>

<element name="userDefinedNetworkType" minOccurs="0"/>

<element name="setOfMcc" minOccurs="0"/>

</all>

</complexType>

</element>

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

<element ref="xn:SubNetwork"/>

<element ref="xn:ManagedElement"/>

<element ref="xn:MeContext"/>

<element ref="xn:ManagementNode"/>

<element ref="xn:IRPAgent"/>

<element ref="xn:SubNetworkOptionallyContainedNrmClass"/>

<element ref="xn:VsDataContainer"/>

</choice>

</sequence>

</extension>

</complexContent>

</complexType>

</element>

<element name="ManagedElement">

<complexType>

<complexContent>

<extension base="xn:NrmClass">

<sequence>

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

<complexType>

<all>

<element name="managedElementType" minOccurs="0"/>

<element name="userLabel" minOccurs="0"/>

<element name="vendorName" minOccurs="0"/>

<element name="userDefinedState" minOccurs="0"/>

<element name="locationName" minOccurs="0"/>

<element name="swVersion" minOccurs="0"/>

<element name="managedBy" type="xn:dnList" minOccurs="0"/>

</all>

</complexType>

</element>

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

<element ref="xn:IRPAgent"/>

<element ref="xn:ManagedElementOptionallyContainedNrmClass"/>

<element ref="xn:VsDataContainer"/>

</choice>

</sequence>

</extension>

</complexContent>

</complexType>

</element>

<element name="MeContext">

<complexType>

<complexContent>

<extension base="xn:NrmClass">

<sequence>

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

<complexType/>

</element>

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

<element ref="xn:ManagedElement"/>

</choice>

</sequence>

</extension>

</complexContent>

</complexType>

</element>

<element name="ManagementNode">

<complexType>

<complexContent>

<extension base="xn:NrmClass">

<sequence>

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

<complexType>

<all>

<element name="userLabel" minOccurs="0"/>

<element name="vendorName" minOccurs="0"/>

<element name="locationName" minOccurs="0"/>

<element name="managedElements" type="xn:dnList" minOccurs="0"/>

<element name="swVersion" minOccurs="0"/>

<element name="userDefinedState" minOccurs="0"/>

</all>

</complexType>

</element>

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

<element ref="xn:IRPAgent"/>

<element ref="xn:VsDataContainer"/>

</choice>

</sequence>

</extension>

</complexContent>

</complexType>

</element>

<element name="IRPAgent">

<complexType>

<complexContent>

<extension base="xn:NrmClass">

<sequence>

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

<complexType>

<all>

<element name="systemDN" minOccurs="0"/>

</all>

</complexType>

</element>

</sequence>

</extension>

</complexContent>

</complexType>

</element>

<element name="VsDataContainer">

<complexType>

<complexContent>

<extension base="xn:NrmClass">

<sequence>

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

<complexType>

<all>

<element name="vsDataType" minOccurs="0"/>

<element name="vsDataFormatVersion" minOccurs="0"/>

<element ref="xn:vsData" minOccurs="0"/>

</all>

</complexType>

</element>

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

<element ref="xn:VsDataContainer"/>

</choice>

</sequence>

</extension>

</complexContent>

</complexType>

</element>

<!–

IRPAgent IOC attributes

–>

<element name="systemDN" type="xn:dn"/>

<!–

VsDataContainer NRM class vsData attribute associated empty XML element

–>

<complexType name="vsData"/>

<element name="vsData" type="xn:vsData"/>

<!–

Abstract head XML element for all XML elements associated to further

NRM classes optionally contained under SubNetwork NRM class

–>

<element

name="SubNetworkOptionallyContainedNrmClass"

type="xn:NrmClass"

abstract="true"

/>

<!–

Abstract head XML element for all XML elements associated to further

NRM classes optionally contained under ManagedElement NRM class

–>

<element

name="ManagedElementOptionallyContainedNrmClass"

type="xn:NrmClass"

abstract="true"

/>

</schema>

Annex B (informative):
Void

Annex C (informative):
Change history

Change history

Date

TSG #

TSG Doc.

CR

Rev

Subject/Comment

Cat

Old

New

Jun 2002

SA_16

SP-020298

Submitted to TSG SA #16 for Information

1.0.0

Sep 2002

SA_17

SP-020460

Submitted to TSG SA #17 for Approval

2.0.0

5.0.0

Jun 2003

SA_20

SP-030287

0001

Correction of Generic NRM XML schema namespace URIs

F

5.0.0

5.1.0

Jun 2003

SA_20

SP-030288

0002

Generic NRM XML schema dependencies removal

F

5.0.0

5.1.0

Sep 2003

Editorials & Cosmetics

5.1.0

5.1.1

Oct 2003

Attached to this TS the normative XML schema electronic files corresponding to Sept 2003 TS 32.625

5.1.1

5.1.2

Dec 2003

SA_22

SP-030648

0003

Add SetofMcc attribute in Generic NRM XML definition for NRM alignment

B

5.1.2

6.0.0

Mar 2004

SA_23

SP-040131

0005

Add the capability to contain instances of VsDataContainer to some MOs – Align with IS 32.622

A

6.0.0

6.1.0

Jun 2004

SA_24

SP-040259

0007

Removal of XML schema URI dependencies

A

6.1.0

6.2.0

Jun 2004

SA_24

SP-040258

0009

Correction of the annex related to XML schema electronic files publication

A

6.1.0

6.2.0

Jun 2004

SA_24

SP-040251

0011

Correction of legal values for managedElementType attribute

A

6.1.0

6.2.0

Dec 2004

SA_26

SP-040808

0013

Correct attribute for the managementScope association – Align with IS in 32.622

A

6.2.0

6.3.0

Mar 2005

SA_27

SP-050046

0014

Add genericNRM.xsd for new IMS Links

B

6.3.0

6.4.0

Mar 2005

SA_27

SP-050046

0016

Error corrections to genericNRM.xsd

A

6.3.0

6.4.0

Jun 2005

SA_28

SP-050296

0019

Remove the xxxIRPs from the Schema – Align with the IS in TS 32.622

F

6.4.0

6.5.0

Jun 2005

SA_28

SP-050296

0020

Correction of inappropriate XML type for a list of Distinguished Names

F

6.4.0

6.5.0

Sep 2005

SA_29

SP-050461

0023

Correct genericNrm.xsd XML schema

F

6.5.0

6.6.0

Sep 2006

SA_33

SP-060535

0024

Correct the use of dnList instead of string type for indicating multiple DN

F

6.6.0

6.7.0

Jun 2007

SA_36

Automatic upgrade to Rel-7 (no CR) at freeze of Rel-7. Deleted reference to CMIP SS, discontinued from R7 onwards.

6.7.0

7.0.0

Sep 2007

SA_37

SP-070612

0025

Define LinkListSet Type – Align with 3GPP2

F

7.0.0

7.1.0

Dec 2008

SA_42

SP-080846

0026

Make globally available IRPAgent IOC attribute

C

7.1.0

8.0.0

Dec 2009

SA_46

SP-090719

0028

Discontinue from Rel-9 onwards the XML schema extraction and storage

F

8.0.0

9.0.0

Dec 2009

SA_46

SP-090719

0027

Align with IS

F

8.0.0

9.0.0