1、 I n t e r n a t i o n a l T e l e c o m m u n i c a t i o n U n i o n ITU-T Z.170 TELECOMMUNICATION STANDARDIZATION SECTOR OF ITU (10/2017) SERIES Z: LANGUAGES AND GENERAL SOFTWARE ASPECTS FOR TELECOMMUNICATION SYSTEMS Formal description techniques (FDT) Testing and Test Control Notation (TTCN) Tes
2、ting and Test Control Notation version 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.
3、109 Application of formal description 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.179 PROGRAMMING LANGUAGES CHILL: The ITU-T high level language Z.200Z.209 MAN-MACHINE LANGUAGE General princ
4、iples Z.300Z.309 Basic syntax and 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.3
5、60Z.379 QUALITY Quality of telecommunication 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 Reco
6、mmendations. Rec. ITU-T Z.170 (10/2017) 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 Testing and Test Control Notation 3 (TTCN-3) source code using special documentat
7、ion 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. This revision of the Recommendation contains amendments, clarifications, corrigenda and editorial corrections. History Edition Recommendation Approv
8、al Study Group Unique ID* 1.0 ITU-T Z.170 2007-11-13 17 11.1002/1000/9284 2.0 ITU-T Z.170 2011-03-16 17 11.1002/1000/11072 3.0 ITU-T Z.170 2012-05-29 17 11.1002/1000/11605 4.0 ITU-T Z.170 2013-07-14 17 11.1002/1000/11967 5.0 ITU-T Z.170 2017-10-14 17 11.1002/1000/13381 _ * To access the Recommendati
9、on, type the URL http:/handle.itu.int/ in the address field of your web browser, followed by the Recommendations unique ID. For example, http:/handle.itu.int/11.1002/1000/11830-en. ii Rec. ITU-T Z.170 (10/2017) FOREWORD The International Telecommunication Union (ITU) is the United Nations specialize
10、d agency in the field of telecommunications, information and communication technologies (ICTs). The ITU Telecommunication 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
11、 view to standardizing telecommunications on a worldwide basis. The World Telecommunication Standardization Assembly (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 Recomme
12、ndations is covered by the procedure laid down in WTSA Resolution 1. In some areas of information technology which fall 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 conc
13、iseness to indicate both a telecommunication administration and a recognized operating agency. Compliance with this Recommendation is voluntary. However, the Recommendation may contain certain mandatory provisions (to ensure, e.g., interoperability or applicability) and compliance with the Recommend
14、ation is achieved when all of these mandatory provisions are met. The words “shall“ or some other obligatory language 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.
15、 INTELLECTUAL PROPERTY RIGHTSITU draws attention to the possibility that the practice or implementation of this Recommendation may involve the use of a claimed Intellectual Property Right. ITU takes no position concerning the evidence, validity or applicability of claimed Intellectual Property Right
16、s, whether asserted by ITU members or others outside of the Recommendation development process. As of the date of approval of this Recommendation, ITU had not received notice of intellectual property, protected by patents, which may be required to implement this Recommendation. However, implementers
17、 are cautioned that this may not represent the latest information and are therefore strongly urged to consult the TSB patent database at http:/www.itu.int/ITU-T/ipr/. ITU 2018 All rights reserved. No part of this publication may be reproduced, by any means whatsoever, without the prior written permi
18、ssion of ITU. Rec. ITU-T Z.170 (10/2017) 1 Recommendation ITU-T Z.170 Testing and Test Control Notation version 3: TTCN-3 documentation comment specification 1 Scope This Recommendation defines a documentation of TTCN-3 source code using special documentation comments. The source code documentation
19、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 references contain provisions which, through reference in this text, constitute provisions of this Recommendation. At the time of pub
20、lication, the editions indicated were valid. All Recommendations and other references are subject to revision; users of this Recommendation are therefore encouraged to investigate the possibility of applying the most recent edition of the Recommendations and other references listed below. A list of
21、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 status 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 (
22、MTS); The Testing and Test Control Notation version 3; Part 10: TTCN-3 documentation comment specification. 3 Definitions 3.1 Terms defined elsewhere None. 3.2 Terms defined in this Recommendation None. 4 Abbreviations and acronyms This Recommendation uses the following abbreviations and acronyms: T
23、TCN Testing and Test Control Notation TTCN-3 Testing and Test Control Notation version 3 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, 2018 SERIES OF ITU-T RECOMMENDATIONS Series A Organiz
24、ation of the work of ITU-T Series D Tariff and accounting principles and international telecommunication/ICT economic and policy issues Series E Overall network operation, telephone service, service operation and human factors Series F Non-telephone telecommunication services Series G Transmission s
25、ystems and media, digital systems and networks Series H Audiovisual and multimedia systems Series I Integrated services digital network Series J Cable networks and transmission of television, sound programme and other multimedia signals Series K Protection against interference Series L Environment a
26、nd ICTs, climate change, e-waste, energy efficiency; construction, installation and protection of cables and other elements of outside plant Series M Telecommunication management, including TMN and network maintenance Series N Maintenance: international sound programme and television transmission ci
27、rcuits Series O Specifications of measuring equipment Series P Telephone transmission quality, telephone installations, local line networks Series Q Switching and signalling, and associated measurements and tests Series R Telegraph transmission Series S Telegraph services terminal equipment Series T
28、 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, next-generation networks, Internet of Things and smart cities Series Z Languages and general software aspects for telecommunication systems
