ITU-T Z 170-2013 Testing and Test Control Notation version 3 TTCN-3 documentation comment specification (Study Group 17)《测试和测试控制符号版本3 TTCN-3文档注释规范 17号研究组》.pdf

1、 International Telecommunication Union ITU-T Z.170TELECOMMUNICATION STANDARDIZATION SECTOR OF ITU (07/2013) SERIES Z: LANGUAGES AND GENERAL SOFTWARE ASPECTS FOR TELECOMMUNICATION SYSTEMS Formal description techniques (FDT) Testing and Test Control Notation (TTCN) Testing and Test Control Notation ve

2、rsion 3: TTCN-3 documentation comment specification Recommendation ITU-T Z.170 ITU-T Z-SERIES RECOMMENDATIONS LANGUAGES AND GENERAL SOFTWARE ASPECTS FOR TELECOMMUNICATION SYSTEMS FORMAL DESCRIPTION TECHNIQUES (FDT) Specification and Description Language (SDL) Z.100Z.109 Application of formal descrip

3、tion techniques Z.110Z.119 Message Sequence Chart (MSC) Z.120Z.129 User Requirements Notation (URN) Z.150Z.159 Testing and Test Control Notation (TTCN) Z.160Z.179PROGRAMMING LANGUAGES CHILL: The ITU-T high level language Z.200Z.209 MAN-MACHINE LANGUAGE General principles Z.300Z.309 Basic syntax and

4、dialogue procedures Z.310Z.319 Extended MML for visual display terminals Z.320Z.329 Specification of the man-machine interface Z.330Z.349 Data-oriented human-machine interfaces Z.350Z.359 Human-machine interfaces for the management of telecommunications networks Z.360Z.379 QUALITY Quality of telecom

5、munication software Z.400Z.409 Quality aspects of protocol-related Recommendations Z.450Z.459 METHODS Methods for validation and testing Z.500Z.519 MIDDLEWARE Processing environment architectures Z.600Z.609 For further details, please refer to the list of ITU-T Recommendations. Rec. ITU-T Z.170 (07/

6、2013) i Recommendation ITU-T Z.170 Testing and Test Control Notation version 3: TTCN-3 documentation comment specification Summary Recommendation ITU-T Z.170 defines a documentation of TTCN-3 source code using special documentation comments. The source code documentation can then be produced automat

7、ically from the TTCN-3 core language, e.g., in the form of hypertext web pages. This revision of the Recommendation contains amendments, clarifications, corrigenda and editorial corrections. History Edition Recommendation Approval Study Group 1.0 ITU-T Z.170 2007-11-13 17 2.0 ITU-T Z.170 2011-03-16

8、17 3.0 ITU-T Z.170 2012-05-29 17 4.0 ITU-T Z.170 2013-07-14 17 ii Rec. ITU-T Z.170 (07/2013) FOREWORD The International Telecommunication Union (ITU) is the United Nations specialized agency in the field of telecommunications, information and communication technologies (ICTs). The ITU Telecommunicat

9、ion Standardization Sector (ITU-T) is a permanent organ of ITU. ITU-T is responsible for studying technical, operating and tariff questions and issuing Recommendations on them with a view to standardizing telecommunications on a worldwide basis. The World Telecommunication Standardization Assembly (

10、WTSA), which meets every four years, establishes the topics for study by the ITU-T study groups which, in turn, produce Recommendations on these topics. The approval of ITU-T Recommendations is covered by the procedure laid down in WTSA Resolution 1. In some areas of information technology which fal

11、l within ITU-Ts purview, the necessary standards are prepared on a collaborative basis with ISO and IEC. NOTE In this Recommendation, the expression “Administration“ is used for conciseness to indicate both a telecommunication administration and a recognized operating agency. Compliance with this Re

12、commendation is voluntary. However, the Recommendation may contain certain mandatory provisions (to ensure, e.g., interoperability or applicability) and compliance with the Recommendation is achieved when all of these mandatory provisions are met. The words “shall“ or some other obligatory language

13、such as “must“ and the negative equivalents are used to express requirements. The use of such words does not suggest that compliance with the Recommendation is required of any party. INTELLECTUAL PROPERTY RIGHTS ITU draws attention to the possibility that the practice or implementation of this Recom

14、mendation may involve the use of a claimed Intellectual Property Right. ITU takes no position concerning the evidence, validity or applicability of claimed Intellectual Property Rights, whether asserted by ITU members or others outside of the Recommendation development process. As of the date of app

15、roval of this Recommendation, ITU had not received notice of intellectual property, protected by patents, which may be required to implement this Recommendation. However, implementers are cautioned that this may not represent the latest information and are therefore strongly urged to consult the TSB

16、 patent database at http:/www.itu.int/ITU-T/ipr/. ITU 2013 All rights reserved. No part of this publication may be reproduced, by any means whatsoever, without the prior written permission of ITU. Rec. ITU-T Z.170 (07/2013) iii Table of Contents Page 1 Scope 1 2 References. 1 3 Definitions 1 3.1 Ter

17、ms defined elsewhere 1 3.2 Terms defined in this Recommendation . 1 4 Abbreviations and acronyms 1 5 Conventions 1 6 Endorsement . 1 Rec. ITU-T Z.170 (07/2013) 1 Recommendation ITU-T Z.170 Testing and Test Control Notation version 3: TTCN-3 documentation comment specification 1 Scope Recommendation

18、ITU-T Z.170 defines a documentation of TTCN-3 source code using special documentation comments. The source code documentation can then be produced automatically from the TTCN-3 Core Language, e.g., in the form of hypertext web pages. 2 References The following ITU-T Recommendations and other referen

19、ces contain provisions which, through reference in this text, constitute provisions of this Recommendation. At the time of publication, the editions indicated were valid. All Recommendations and other references are subject to revision; users of this Recommendation are therefore encouraged to invest

20、igate the possibility of applying the most recent edition of the Recommendations and other references listed below. A list of the currently valid ITU-T Recommendations is regularly published. The reference to a document within this Recommendation does not give it, as a stand-alone document, the stat

21、us of a Recommendation. ETSI ES 201 873-10 V4.5.1 ETSI ES 201 873-10 V4.5.1 (2013-04), Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3: TTCN-3 documentation comment specification. 3 Definitions 3.1 Terms defined elsewhere This Recommendation uses the foll

22、owing terms defined elsewhere: None. 3.2 Terms defined in this Recommendation This Recommendation defines the following terms: None. 4 Abbreviations and acronyms This Recommendation uses the following abbreviations and acronyms: CORBA Common Object Request Broker Architecture TTCN Testing and Test C

23、ontrol Notation 5 Conventions None. 6 Endorsement ETSI ES 201 873-10 V4.5.1 was approved by ITU-T as the basis for Recommendation ITU-T Z.170. Printed in Switzerland Geneva, 2013 SERIES OF ITU-T RECOMMENDATIONS Series A Organization of the work of ITU-T Series D General tariff principles Series E Ov

24、erall network operation, telephone service, service operation and human factors Series F Non-telephone telecommunication services Series G Transmission systems and media, digital systems and networks Series H Audiovisual and multimedia systems Series I Integrated services digital network Series J Ca

25、ble networks and transmission of television, sound programme and other multimedia signals Series K Protection against interference Series L Construction, installation and protection of cables and other elements of outside plant Series M Telecommunication management, including TMN and network mainten

26、ance Series N Maintenance: international sound programme and television transmission circuits Series O Specifications of measuring equipment Series P Terminals and subjective and objective assessment methods Series Q Switching and signalling Series R Telegraph transmission Series S Telegraph service

27、s terminal equipment Series T Terminals for telematic services Series U Telegraph switching Series V Data communication over the telephone network Series X Data networks, open system communications and security Series Y Global information infrastructure, Internet protocol aspects and next-generation networks Series Z Languages and general software aspects for telecommunication systems