ETSI TS 132 625 V6.3.0 (2004-12) Technical Specification Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Telecommunication management; Configuration Management (CM); Generic network resources Integration Reference Point (IRP): Bulk CM eXtensible Markup Language (XML) file format definition (3GPP TS 32.625 version 6.3.0 Release 6) R GLOBAL SYSTEM FOR MOBILE COMMUNICATIONS 3GPP TS 32.625 version 6.3.0 Release 6 1 ETSI TS 132 625 V6.3.0 (2004-12) Reference RTS/TSGS-0532625v630 Keywords GSM, UMTS ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N° 348 623 562 00017 - NAF 742 C Association à but non lucratif enregistrée à la Sous-Préfecture de Grasse (06) N° 7803/88 Important notice Individual copies of the present document can be downloaded from: http://www.etsi.org The present document may be made available in more than one electronic version or in print. In any case of existing or perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at http://portal.etsi.org/tb/status/status.asp If you find errors in the present document, please send your comment to one of the following services: http://portal.etsi.org/chaircor/ETSI_support.asp Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. © European Telecommunications Standards Institute 2004. All rights reserved. DECTTM, PLUGTESTSTM and UMTSTM are Trade Marks of ETSI registered for the benefit of its Members. TIPHONTM and the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI 3GPP TS 32.625 version 6.3.0 Release 6 2 ETSI TS 132 625 V6.3.0 (2004-12) Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http://webapp.etsi.org/IPR/home.asp). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the present document. Foreword This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under http://webapp.etsi.org/key/queryform.asp . ETSI 3GPP TS 32.625 version 6.3.0 Release 6 3 ETSI TS 132 625 V6.3.0 (2004-12) Contents Intellectual Property Rights................................................................................................................................2 Foreword.............................................................................................................................................................2 Foreword.............................................................................................................................................................4 Introduction........................................................................................................................................................4 1 Scope........................................................................................................................................................5 2 References................................................................................................................................................5 3 Definitions and abbreviations...................................................................................................................5 3.1 Definitions..........................................................................................................................................................5 3.2 Abbreviations.....................................................................................................................................................7 4 Structure and content of configuration data XML files............................................................................7 Annex A (normative): Configuration data file NRM-specific XML schema (file name "genericNrm.xsd")..................................................................8 Annex B (informative): XML schema electronic files.........................................................................13 Annex C (informative): Change history...............................................................................................14 History..............................................................................................................................................................15 ETSI 3GPP TS 32.625 version 6.3.0 Release 6 4 ETSI TS 132 625 V6.3.0 (2004-12) Foreword This Technical Specification has been produced by the 3rd Generation Partnership Project (3GPP). The contents of the present document are subject to continuing work within the TSG and may change following formal TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an identifying change of release date and an increase in version number as follows: Version x.y.z where: x the first digit: 1 presented to TSG for information; 2 presented to TSG for approval; 3 or greater indicates TSG approved document under change control. y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, updates, etc. z the third digit is incremented when editorial only changes have been incorporated in the document. Introduction The present document is part of a TS-family covering the 3rd Generation Partnership Project; Technical Specification Group Services and System Aspects; Telecommunication management; as identified below: 32.621: "Configuration Management (CM); Generic network resources Integration Reference Point (IRP): Requirements". 32.622: "Configuration Management (CM);Generic network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 32.623: "Configuration Management (CM);Generic network resources Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) Solution Set (SS)"; 32.624: "Configuration Management (CM);Generic network resources: Integration Reference Point (IRP): Common Management Information Protocol (CMIP) Solution Set (SS)". 32.625: "Configuration Management (CM);Generic network resources Integration Reference Point (IRP): Bulk CM eXtensible Markup Language (XML) file format definition". Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by functions in the Operations Systems (OSs) or NEs. CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an optimisation programme (e.g. modifications), and to maintain the overall Quality of Service (QoS). The CM actions are initiated either as single actions on single NEs of the 3G network, or as part of a complex procedure involving actions on many resources/objects in one or several NEs. ETSI 3GPP TS 32.625 version 6.3.0 Release 6 5 ETSI TS 132 625 V6.3.0 (2004-12) 1 Scope The present document provides the NRM-specific part related to the Generic Network Resources IRP NRM [1] of the XML file format definition for the Bulk Configuration Management IRP IS [2]. The main part of this XML file format definition is provided by 3GPP TS 32.615 [3]. Bulk CM XML file formats are based on XML [4], XML Schema [5] [6] [7] and XML Namespace [8] specifications. This File Format Definition specification is related to 3GPP TS 32.622 V6.3.X. 2 References The following documents contain provisions which, through reference in this text, constitute provisions of the present document. • References are either specific (identified by date of publication, edition number, version number, etc.) or non-specific. • For a specific reference, subsequent revisions do not apply. • For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document. [1] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic network resources Integration Reference Point (IRP): Network Resource Model (NRM)". [2] 3GPP TS 32.612: "Telecommunication management; Configuration Management (CM); Bulk CM Integration Reference Point (IRP): Information Service (IS)". [3] 3GPP TS 32.615: "Telecommunication management; Configuration Management (CM); Bulk CM Integration Reference Point (IRP): eXtensible Markup Language (XML) file format definition". [4] W3C REC-xml-20001006: "Extensible Markup Language (XML) 1.0 (Second Edition)". [5] W3C REC-xmlschema-0-20010502: "XML Schema Part 0: Primer". [6] W3C REC-xmlschema-1-20010502: "XML Schema Part 1: Structures". [7] W3C REC-xmlschema-2-20010502: "XML Schema Part 2: Datatypes". [8] W3C REC-xml-names-19990114: "Namespaces in XML". 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the following terms and definitions apply: XML file: file containing an XML document XML document: composed of the succession of an optional XML declaration followed by a root XML element NOTE: See [4]; in the scope of the present document. XML declaration: it specifies the version of XML being used NOTE: See [4]. ETSI 3GPP TS 32.625 version 6.3.0 Release 6 6 ETSI TS 132 625 V6.3.0 (2004-12) XML element: has a type, is identified by a name, may have a set of XML attribute specifications and is either composed of the succession of an XML start-tag followed by the XML content of the XML element followed by an XML end-tag, or composed simply of an XML empty-element tag; each XML element may contain other XML elements NOTE: See [4]. empty XML element: having an empty XML content; an empty XML element still possibly has a set of XML attribute specifications; an empty XML element is either composed of the succession of an XML start-tag directly followed by an XML end-tag, or composed simply of an XML empty-element tag NOTE: See [4]. XML content (of an XML element): empty if the XML element is simply composed of an XML empty-element tag; otherwise the part, possibly empty, of the XML element between its XML start-tag and its XML end-tag XML start-tag: the beginning of a non-empty XML element is marked by an XML start-tag containing the name and the set of XML attribute specifications of the XML element NOTE: See [4]. XML end-tag: the end of a non-empty XML element is marked by an XML end-tag containing the name of the XML element NOTE: See [4]. XML empty-element tag: composed simply of an empty-element tag containing the name and the set of XML attribute specifications of the XML element. NOTE: See [4]. XML attribute specification: has a name and a value NOTE: See [4]. DTD: defines structure and content constraints to be respected by an XML document to be valid with regard to this DTD NOTE: See [4]. XML schema: more powerful than a DTD, an XML schema defines structure and content constraints to be respected by an XML document to conform with this XML schema; through the use of XML namespaces several XML schemas can be used together by a single XML document; an XML schema is itself also an XML document that shall conform with the XML schema for XML schemas NOTE: See [5], [6] and [7]. XML namespace: enables qualifying element and attribute names used in XML documents by associating them with namespaces identified by different XML schemas NOTE: See [8], in the scope of the present document. XML complex type: defined in an XML schema; cannot be directly used in an XML document; can be the concrete type or the derivation base type for an XML element type or for another XML complex type; ultimately defines constraints for an XML element on its XML attribute specifications and/or its XML content NOTE: See [5], [6] and [7]. XML element type: declared by an XML schema; can be directly used in an XML document; as the concrete type of an XML element, directly or indirectly defines constraints on its XML attribute specifications and/or its XML content; can also be the concrete type or the derivation base type for another XML element type NOTE: See [5], [6] and [7]. ETSI 3GPP TS 32.625 version 6.3.0 Release 6 7 ETSI TS 132 625 V6.3.0 (2004-12) 3.2 Abbreviations For the purposes of the present document, the following abbreviations apply: CM Configuration Management DTD Document Type Definition EDGE Enhanced Data for GSM Evolution GERAN GSM/EDGE Radio Access Network GSM Global System for Mobile communication IRP Integration Reference Point IS Information Service NRM Network Resource Model UMTS Universal Mobile Telecommunications System UTRAN Universal Terrestrial Radio Access Network XML eXtensible Markup Language 4 Structure and content of configuration data XML files 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. ETSI 3GPP TS 32.625 version 6.3.0 Release 6 8 ETSI TS 132 625 V6.3.0 (2004-12) 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" 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 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"/> ETSI 3GPP TS 32.625 version 6.3.0 Release 6 9 ETSI TS 132 625 V6.3.0 (2004-12) <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" 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> </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> ETSI