1、 ETSI ES 201 873-5 V4.7.1 (2015-06) Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3; Part 5: TTCN-3 Runtime Interface (TRI) ETSI STANDARD ETSI ETSI ES 201 873-5 V4.7.1 (2015-06)2 Reference RES/MTS-201873-5 T3ed471 Keywords interface, methodology, runtime,
2、 testing, TRI, TTCN-3 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 enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice The present document can
3、be downloaded from: http:/www.etsi.org/standards-search The present document may be made available in electronic versions and/or in print. The content of any electronic and/or print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any
4、 existing or perceived difference in contents between such versions and/or in print, the only prevailing document is the print of the Portable Document Format (PDF) version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may b
5、e 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: https:/portal.etsi.org/Peopl
6、e/CommiteeSupportStaff.aspx Copyright Notification No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm except as authorized by written permission of ETSI. The content of the PDF version shall not be modified without the wr
7、itten authorization of ETSI. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2015. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTMand the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GP
8、PTM and LTE are Trade Marks of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. GSM and the GSM logo are Trade Marks registered and owned by the GSM Association. ETSI ETSI ES 201 873-5 V4.7.1 (2015-06)3 Contents Intellectual Property Rights 8g3Foreword . 8g3Mod
9、al verbs terminology 8g3Introduction 8g31 Scope 9g31.1 Compliance. 9g32 References 9g32.1 Normative references . 9g32.2 Informative references 10g33 Definitions and abbreviations . 10g33.1 Definitions 10g33.2 Abbreviations . 11g34 General Structure of a TTCN-3 Test System . 11g34.1 Entities in a TTC
10、N-3 Test System 12g34.1.1 Test Management and Control (TMC) 12g34.1.1.1 Test Management (TM) 12g34.1.1.2 Test Logging (TL) . 12g34.1.1.3 Coding and Decoding (CD) 12g34.1.1.4 Component Handling (CH) . 12g34.1.2 TTCN-3 Executable (TE) . 13g34.1.2.1 Executable Test Suite (ETS) . 13g34.1.2.2 TTCN-3 Runt
11、ime System (T3RTS) 13g34.1.2.3 Encoding/Decoding System (EDS) . 13g34.1.2.4 Timers in the TTCN-3 Executable 14g34.1.3 SUT Adaptor (SA) 14g34.1.4 Platform Adaptor (PA) 14g34.2 Interfaces in a TTCN-3 Test System 14g34.3 Execution requirements for a TTCN-3 test system 14g35 TTCN-3 Runtime Interface and
12、 operations 15g35.1 Overview of the TRI. 15g35.1.1 The triCommunication Interface . 15g35.1.2 The triPlatform Interface 15g35.1.3 Correlation between TTCN-3 and TRI Operation Invocations . 15g35.2 Error handling 16g35.3 Data interface . 17g35.3.1 Connection 17g35.3.2 Communication . 18g35.3.3 Timer
13、18g35.3.4 Miscellaneous . 19g35.4 Operation descriptions 19g35.5 Communication interface operations 19g35.5.1 triSAReset (TE SA) . 19g35.5.2 Connection handling operations . 20g35.5.2.1 triExecuteTestCase (TE SA) 20g35.5.2.2 triMap (TE SA) 20g35.5.2.3 triMapParam (TE SA) 20g35.5.2.4 triUnmap (TE SA)
14、 21g35.5.2.5 triUnmapParam (TE SA) 21g35.5.2.6 triEndTestCase (TE SA) . 21g35.5.3 Message based communication operations . 22g35.5.3.1 triSend (TE SA) 22g35.5.3.2 triSendBC (TE SA) 22g35.5.3.3 triSendMC (TE SA) . 23g3ETSI ETSI ES 201 873-5 V4.7.1 (2015-06)4 5.5.3.4 triEnqueueMsg (SA TE) . 23g35.5.4
15、Procedure based communication operations . 24g35.5.4.1 triCall (TE SA) . 24g35.5.4.2 triCallBC (TE SA) 25g35.5.4.3 triCallMC (TE SA) . 26g35.5.4.4 triReply (TE SA) 27g35.5.4.5 triReplyBC (TE SA) . 28g35.5.4.6 triReplyMC (TE SA) 29g35.5.4.7 triRaise (TE SA) . 29g35.5.4.8 triRaiseBC (TE SA) . 30g35.5.
16、4.9 triRaiseMC (TE SA) 30g35.5.4.10 triEnqueueCall (SA TE) . 31g35.5.4.11 triEnqueueReply (SA TE) 31g35.5.4.12 triEnqueueException (SA TE) . 32g35.5.5 Miscellaneous operations 32g35.5.5.1 triSUTactionInformal (TE SA) 32g35.6 Platform interface operations . 32g35.6.1 triPAReset (TE PA) . 32g35.6.2 Ti
17、mer operations . 33g35.6.2.1 triStartTimer (TE PA) 33g35.6.2.2 triStopTimer (TE PA). 33g35.6.2.3 triReadTimer (TE PA) 33g35.6.2.4 triTimerRunning (TE PA) 34g35.6.2.5 triTimeout (PA TE) 34g35.6.3 Miscellaneous operations 35g35.6.3.1 triExternalFunction (TE PA) 35g35.6.3.2 triSelf (PA TE) . 35g35.6.3.
18、3 triRnd (PA TE) . 35g36 Java language mapping 36g36.1 Introduction 36g36.2 Names and scopes 36g36.2.1 Names . 36g36.2.2 Scopes. 36g36.3 Type mapping . 36g36.3.1 Basic type mapping . 36g36.3.1.1 Boolean . 36g36.3.1.1.1 Methods. 37g36.3.1.2 String . 37g36.3.2 Structured type mapping . 37g36.3.2.1 Tri
19、PortIdType 37g36.3.2.1.1 Methods . 37g36.3.2.2 TriPortIdListType . 37g36.3.2.2.1 Methods . 38g36.3.2.3 TriComponentIdType 38g36.3.2.3.1 Methods . 38g36.3.2.4 TriComponentIdListType . 38g36.3.2.4.1 Methods . 39g36.3.2.5 TriMessageType 39g36.3.2.5.1 Methods . 39g36.3.2.6 TriAddressType 39g36.3.2.6.1 M
20、ethods . 40g36.3.2.7 TriAddressListType 40g36.3.2.7.1 Methods . 40g36.3.2.8 TriSignatureIdType . 40g36.3.2.8.1 Methods . 41g36.3.2.9 TriParameterType . 41g36.3.2.9.1 Methods . 41g36.3.2.10 TriParameterPassingModeType 41g36.3.2.10.1 Constants . 42g36.3.2.11 TriParameterListType . 42g3ETSI ETSI ES 201
21、 873-5 V4.7.1 (2015-06)5 6.3.2.11.1 Methods . 42g36.3.2.12 TriExceptionType . 42g36.3.2.12.1 Methods . 43g36.3.2.13 TriTimerIdType 43g36.3.2.13.1 Methods . 43g36.3.2.14 TriTimerDurationType 43g36.3.2.14.1 Methods . 43g36.3.2.15 TriFunctionIdType 44g36.3.2.15.1 Methods . 44g36.3.2.16 TriTestCaseIdTyp
22、e 44g36.3.2.16.1 Methods . 44g36.3.2.17 TriActionTemplateType 44g36.3.2.18 TriStatusType 44g36.3.2.18.1 Methods. 45g36.4 Constants 45g36.5 Mapping of interfaces . 45g36.5.1 Out and InOut Parameter Passing Mode . 46g36.5.2 triCommunication - Interface 46g36.5.2.1 triCommunicationSA 46g36.5.2.2 triCom
23、municationTE. 47g36.5.3 triPlatform - Interface . 48g36.5.3.1 TriPlatformPA . 48g36.5.3.2 TriPlatformTE . 48g36.6 Optional parameters . 48g36.7 TRI initialization 49g37 ANSI C language mapping. 49g37.1 Introduction 49g37.2 Names and scopes 49g37.2.1 Abstract type mapping 49g37.2.2 ANSI C type defini
24、tions . 50g37.2.3 IDL type mapping . 51g37.2.4 TRI operation mapping . 51g37.3 Memory management . 53g38 C+ language mapping 53g38.1 Introduction 53g38.2 Names and scopes 53g38.3 Memory management . 53g38.4 Void 53g38.5 Type mapping . 53g38.5.1 Encapsulated C+ types 54g38.5.2 Abstract data types 54g
25、38.5.2.1 QualifiedName 54g38.5.2.1.1 Methods . 54g38.5.2.2 TriAddress. 55g38.5.2.2.1 Methods . 55g38.5.2.3 TriAddressList 55g38.5.2.3.1 Methods . 55g38.5.2.4 TriComponentId 56g38.5.2.4.1 Methods . 56g38.5.2.5 TriComponentIdList 57g38.5.2.5.1 Methods . 57g38.5.2.6 TriException 57g38.5.2.6.1 Methods .
26、 57g38.5.2.7 TriFunctionId 58g38.5.2.7.1 Methods . 58g38.5.2.8 TriMessage 58g38.5.2.8.1 Methods . 58g38.5.2.9 TriParameter 59g38.5.2.9.1 Methods . 59g38.5.2.10 TriParameterList . 60g3ETSI ETSI ES 201 873-5 V4.7.1 (2015-06)6 8.5.2.10.1 Methods . 60g38.5.2.11 TriParameterPassingMode 60g38.5.2.12 TriPo
27、rtId 60g38.5.2.12.1 Methods . 61g38.5.2.13 TriPortIdList 61g38.5.2.13.1 Methods . 62g38.5.2.14 TriSignatureId . 62g38.5.2.14.1 Methods . 62g38.5.2.15 TriStatus 62g38.5.2.16 TriTestCaseId 63g38.5.2.16.1 Methods . 63g38.5.2.17 TriTimerDuration 63g38.5.2.17.1 Methods . 63g38.5.2.18 TriTimerId . 64g38.5
28、.2.18.1 Methods . 64g38.6 Mapping of interfaces . 64g38.6.1 TriCommunicationSA . 64g38.6.2 TriCommunicationTE . 66g38.6.3 TriPlatformPA 66g38.6.4 TriPlatformTE . 67g39 C# language mapping . 67g39.1 Introduction 67g39.2 Names and scopes 67g39.2.1 Names . 67g39.2.2 Scopes. 67g39.3 Null value mapping 6
29、7g39.4 Type mapping . 68g39.4.1 Basic type mapping . 68g39.4.1.1 Boolean . 68g39.4.1.1.1 Members 68g39.4.1.2 String . 68g39.4.2 Structured type mapping . 68g39.4.2.1 IQualifiedName . 68g39.4.2.1.1 Members 68g39.4.2.2 TriPortIdType 69g39.4.2.2.1 Members 69g39.4.2.3 TriPortIdListType . 69g39.4.2.3.1 M
30、embers 69g39.4.2.4 TriComponentIdType 69g39.4.2.4.1 Members 70g39.4.2.5 TriComponentIdListType . 70g39.4.2.5.1 Members 70g39.4.2.6 TriMessageType 70g39.4.2.6.1 Members 71g39.4.2.7 TriAddressType 71g39.4.2.7.1 Methods . 71g39.4.2.8 TriAddressListType 71g39.4.2.8.1 Members 71g39.4.2.9 TriSignatureIdTy
31、pe . 72g39.4.2.10 TriParameterPassingModeType 72g39.4.2.11 TriParameterType . 72g39.4.2.11.1 Members 72g39.4.2.12 TriParameterListType . 72g39.4.2.12.1 Members 72g39.4.2.13 TriExceptionType . 73g39.4.2.13.1 Methods . 73g39.4.2.14 TriTimerIdType 73g39.4.2.14.1 Members 73g39.4.2.15 TriTimerDurationTyp
32、e 73g39.4.2.15.1 Members 73g39.4.2.16 TriFunctionIdType 74g3ETSI ETSI ES 201 873-5 V4.7.1 (2015-06)7 9.4.2.17 TriTestCaseIdType 74g39.4.2.18 TriStatusType 74g39.5 Mapping of interfaces . 74g39.5.1 Out and inout parameter passing mode . 74g39.5.2 triCommunication interface 74g39.5.2.1 ITriCommunicati
33、onSA 75g39.5.2.2 ITriCommunicationTE 76g39.5.2.3 ITriPlatformPA . 76g39.5.2.4 ITriPlatformTE 76g39.6 Optional parameters . 77g3Annex A (normative): IDL Summary 78g3Annex B (informative): Use scenarios 82g3B.1 First scenario 82g3B.1.1 TTCN-3 fragment . 82g3B.1.2 Message sequence chart . 84g3B.2 Secon
34、d scenario 85g3B.2.1 TTCN-3 fragment . 85g3B.2.2 Message sequence chart . 86g3B.3 Third scenario . 87g3B.3.1 TTCN-3 fragment . 87g3B.3.2 Message sequence chart . 88g3Annex C (informative): Bibliography . 89g3History 90g3ETSI ETSI ES 201 873-5 V4.7.1 (2015-06)8 Intellectual Property Rights IPRs essen
35、tial 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 potential
36、ly 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:/ipr.etsi.org). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guara
37、ntee 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 ETSI Standard (ES) has been produced by ETSI Technical Committee Methods for Testing and
38、 Specification (MTS). The present document is part 5 of a multi-part deliverable. Full details of the entire series can be found in part 1 2. Modal verbs terminology In the present document “shall“, “shall not“, “should“, “should not“, “may“, “need not“, “will“, “will not“, “can“ and “cannot“ are to
39、 be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of provisions). “must“ and “must not“ are NOT allowed in ETSI deliverables except when used in direct citation. Introduction The present document consists of two distinct parts, the first part desc
40、ribing the structure of a TTCN-3 test system implementation and the second part presenting the TTCN-3 Runtime Interface specification. The first part introduces the decomposition of a TTCN-3 test system into four main entities: Test Management (TM), TTCN-3 Executable (TE), SUT Adaptor (SA), and Plat
41、form Adaptor (PA). In addition, the interaction between these entities, i.e. the corresponding interfaces, is defined. The second part of the present document specifies the TTCN-3 Runtime Interface (TRI). The interface is defined in terms of operations, which are implemented as part of one entity an
42、d called by other entities of the test system. For each operation, the interface specification defines associated data structures, the intended effect on the test system and any constraints on the usage of the operation. Note that this interface specification only defines interactions between the TS
43、I and the SUT as well as timer operations. ETSI ETSI ES 201 873-5 V4.7.1 (2015-06)9 1 Scope The present document provides the specification of the runtime interface for TTCN-3 test system implementations. The TTCN-3 Runtime Interface provides a standardized adaptation for timing and communication of
44、 a test system to a particular processing platform and the system under test, respectively. The present document defines the interface as a set of operations independent of target language. The interface is defined to be compatible with the TTCN-3 standard (see ETSI ES 201 873-1 2). The present docu
45、ment uses the CORBA Interface Definition Language (IDL) to specify the TRI completely. Clauses 6, 7 and 8 present language mappings for this abstract specification to the target languages Java, ANSI C, and C+. A summary of the IDL based interface specification is provided in annex A. 1.1 Compliance
46、The requirement for a TTCN-3 test system to be TRI compliant is to adhere to the interface specification stated in the present document as well as to one of the target language mappings included. EXAMPLE: If a vendor supports Java, the TRI operation calls and implementations, which are part of the T
47、TCN-3 executable, have to comply with the IDL to Java mapping specified in the present document. 2 References 2.1 Normative references References are either specific (identified by date of publication and/or edition number or version number) or non-specific. For specific references, only the cited v
48、ersion applies. For non-specific references, the latest version of the reference document (including any amendments) applies. Referenced documents which are not found to be publicly available in the expected location might be found at http:/docbox.etsi.org/Reference. NOTE: While any hyperlinks inclu
49、ded in this clause were valid at the time of publication, ETSI cannot guarantee their long term validity. The following referenced documents are necessary for the application of the present document. 1 Recommendation ITU-T X.290: “OSI conformance testing methodology and framework for protocol Recommendations for ITU-T applications - General concepts“. NOTE: The corresponding ISO/IEC standard is ISO/IEC 9646-1: “Information technology - Open Systems Interconnection - Conformance testing methodology an
