IEC 61970-402:2008

Energy management system application program interface (EMS-API) - Part 402: Common services

IEC 61970-402:2008(E) provides the base functionality considered necessary and common that is provided by neither the normative standards incorporated by reference nor the new APIs specified in the IEC 61970-403 to IEC 61970-449 generic interface standards. An application is expected to use the Common Services in conjunction with the generic interfaces.
This publication is of core relevance for Smart Grid.

General Information

• Status: Replaced
• Publication Date: 23-Jun-2008
• ICS: 33.200 - Telecontrol. Telemetering
• Technical Committee: TC 57 - Power systems management and associated information exchange
• Drafting Committee: WG 13 - TC 57/WG 13
• Current Stage: WPUB - Publication withdrawn
• Completion Date: 26-Aug-2011

Relations

• Replaced By: IEC TR 62541-1:2010 - OPC Unified Architecture - Part 1: Overview and Concepts
• Effective Date: 05-Sep-2023

Standards Content (Sample)

IEC 61970-402
Edition 1.0 2008-06
INTERNATIONAL
STANDARD
Energy management system application program interface (EMS-API) –
Part 402: Common services
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form

or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from
either IEC or IEC's member National Committee in the country of the requester.
If you have any questions about IEC copyright or have an enquiry about obtaining additional rights to this publication,

please contact the address below or your local IEC member National Committee for further information.

IEC Central Office
3, rue de Varembé
CH-1211 Geneva 20
Switzerland
Email: [e-mail]
Web: www.iec.ch
About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.

About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigenda or an amendment might have been published.
ƒ Catalogue of IEC publications: www.iec.ch/searchpub
The IEC on-line Catalogue enables you to search by a variety of criteria (reference number, text, technical committee,…).
It also gives information on projects, withdrawn and replaced publications.
ƒ IEC Just Published: www.iec.ch/online_news/justpub
Stay up to date on all new IEC publications. Just Published details twice a month all new publications released. Available
on-line and also by email.
ƒ Electropedia: www.electropedia.org
The world's leading online dictionary of electronic and electrical terms containing more than 20 000 terms and definitions
in English and French, with equivalent terms in additional languages. Also known as the International Electrotechnical
Vocabulary online.
ƒ Customer Service Centre: www.iec.ch/webstore/custserv
If you wish to give us your feedback on this publication or need further assistance, please visit the Customer Service
Centre FAQ or contact us:
Email: [e-mail]
Tel.: [phone]
Fax: [phone]
IEC 61970-402
Edition 1.0 2008-06
INTERNATIONAL
STANDARD
Energy management system application program interface (EMS-API) –
Part 402: Common services
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
PRICE CODE
W
ICS 33.200 ISBN 2-8318-9850-1
– 2 – 61970-402 © IEC:2008(E)
CONTENTS
FOREWORD.4

INTRODUCTION.6

1 Scope.7

2 Normative references.8

3 Terms and definitions .8

4 Background .8

5 Common services identifiers (normative).9

5.1 DAF resource identifiers interface .9
5.2 Extended resource ID service .10
5.2.1 General .10
5.2.2 get_uris().11
5.2.3 set_uris() .11
5.2.4 create_resource_ids() .12
6 Common services descriptions (normative) .12
7 IECTC 57Views (normative) .14
7.1 General .14
7.2 IECTC 57View motivations (informative) .14
7.2.1 General .14
7.2.2 Problem example (informative).15
7.2.3 IECTC 57View description (normative) .16
7.2.4 IECTC 57View examples (informative) .16
7.2.5 Node properties (normative).18
7.3 The IECTC 57Physical view (normative).18
7.3.1 General .18
7.3.2 IECTC 57Physical view hierarchy .19
7.4 The IECTC 57Eventing View (normative) .21
7.4.1 General .21
7.4.2 IECTC 57EventingView properties.21
8 Context support (normative).22
Annex A (informative) TC 57 Views discussion .23
Annex B (informative) Proxy architecture.28
Annex C (informative) The IEC 61970 services and mapping IEC 61968 verbs.29

Bibliography .36

Figure 1 – DAF resource identifiers model .9
Figure 2 – GDA extended resource identifiers model .11
Figure 3 – Resource descriptions .12
Figure 4 – Resource descriptions:SimpleValue .13
Figure 5 – Fictitious information model .15
Figure 6 – Fictitious populated model displayed in tree .15
Figure 7 – IECTC 57Views .16
Figure 8 – Example TC 57 PhysicalView (informative) .17
Figure 9 – Example IECTC 57EventingView (informative) .17

61970-402 © IEC:2008(E) – 3 –
Figure A.1 – Non-CIM-compliant example of a full mesh network of object classes and

instances .23

Figure A.2 – Non-CIM-compliant example of traditional view of utility data .24

Figure A.3 – Non-CIM-compliant example of customer data within a network view .24

Figure A.4 – Non-CIM-compliant example of a full mesh view .25

Figure A.5 – Subscribing to data using share path information .26

Figure A.6 – TC 57 View used as a subscription topic tree.27

Table 1 – DAF resource identifiers operations .10
Table 2 – GDA extended resource identifiers operations.11
Table 3 – DAF resource description iterator.13
Table 4 – Format of view version.18
Table 5 – First level associations used in the TC 57PhysicalView .19
Table 6 – Second level associations used in the TC 57PhysicalView.19
Table 7 – Third level associations used in the TC 57PhysicalView .20
Table 8 – Fourth level associations used in the TC 57PhysicalView .20
Table 9 – Fifth level associations used in the TC 57PhysicalView .20
Table 10 – Format of TC 57PhysicalView properties .21
Table 11 – Format of TC 57EventingView properties.22
Table C.1 – Mapping IEC 61968 verbs to IEC 61970 services .31

– 4 – 61970-402 © IEC:2008(E)
INTERNATIONAL ELECTROTECHNICAL COMMISSION

____________
ENERGY MANAGEMENT SYSTEM APPLICATION

PROGRAM INTERFACE (EMS-API) –
Part 402: Common services
FOREWORD
1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising
all national electrotechnical committees (IEC National Committees). The object of IEC is to promote
international co-operation on all questions concerning standardization in the electrical and electronic fields. To
this end and in addition to other activities, IEC publishes International Standards, Technical Specifications,
Technical Reports, Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC
Publication(s)”). Their preparation is entrusted to technical committees; any IEC National Committee interested
in the subject dealt with may participate in this preparatory work. International, governmental and non-
governmental organizations liaising with the IEC also participate in this preparation. IEC collaborates closely
with the International Organization for Standardization (ISO) in accordance with conditions determined by
agreement between the two organizations.
2) The formal decisions or agreements of IEC on technical matters express, as nearly as possible, an international
consensus of opinion on the relevant subjects since each technical committee has representation from all
interested IEC National Committees.
3) IEC Publications have the form of recommendations for international use and are accepted by IEC National
Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC
Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any
misinterpretation by any end user.
4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications
transparently to the maximum extent possible in their national and regional publications. Any divergence
between any IEC Publication and the corresponding national or regional publication shall be clearly indicated in
the latter.
5) IEC provides no marking procedure to indicate its approval and cannot be rendered responsible for any
equipment declared to be in conformity with an IEC Publication.
6) All users should ensure that they have the latest edition of this publication.
7) No liability shall attach to IEC or its directors, employees, servants or agents including individual experts and
members of its technical committees and IEC National Committees for any personal injury, property damage or
other damage of any nature whatsoever, whether direct or indirect, or for costs (including legal fees) and
expenses arising out of the publication, use of, or reliance upon, this IEC Publication or any other IEC
Publications.
8) Attention is drawn to the Normative references cited in this publication. Use of the referenced publications is
indispensable for the correct application of this publication.
9) Attention is drawn to the possibility that some of the elements of this IEC Publication may be the subject of
patent rights. IEC shall not be held responsible for identifying any or all such patent rights.

International Standard IEC 61970-402 has been prepared by IEC technical committee 57:
Power systems management and associated information exchange.
The text of this standard is based on the following documents:
FDIS Report on voting
57/928/FDIS 57/947/RVD
Full information on the voting for the approval of this standard can be found in the report on
voting indicated in the above table.
A list of all parts of the IEC 61970 series, under the general title Energy management system
application program interface (EMS-API), can be found on the IEC website.

61970-402 © IEC:2008(E) – 5 –
This publication has been drafted in accordance with the ISO/IEC Directives, Part 2.

The committee has decided that the contents of this publication will remain unchanged until the

maintenance result date indicated on the IEC web site under "http://webstore.iec.ch" in the data

related to the specific publication. At this date, the publication will be

• reconfirmed;
• withdrawn;
• replaced by a revised edition, or

• amended.
A bilingual version of this publication may be issued at a later date.

– 6 – 61970-402 © IEC:2008(E)
INTRODUCTION
This standard is one of the IEC 61970 series parts that define an application program interface

(AP
...