|
ETSI Standard
Methods for Testing and Specification (MTS);
The Testing and Test Control Notation version 3;
Part 5: TTCN-3 Runtime Interface (TRI)
---------------------- Page: 1 ----------------------
2 ETSI ES 201 873-5 V4.1.1 (2009-06)
Reference
RES/MTS-00107-5 T3 ed411 TRI
Keywords
interface, MTS, testing, TRI, TTCN
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 2009.
All rights reserved.
TM TM TM TM
DECT , PLUGTESTS , UMTS , TIPHON , the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered
for the benefit of its Members.
TM
3GPP is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners.
LTE™ is a Trade Mark of ETSI currently being 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
---------------------- Page: 2 ----------------------
3 ETSI ES 201 873-5 V4.1.1 (2009-06)
Contents
Intellectual Property Rights . 7
Foreword . 7
Introduction . 7
1 Scope . 8
1.1 Compliance. 8
2 References . 8
2.1 Normative references . 8
2.2 Informative references . 9
3 Definitions and abbreviations . 9
3.1 Definitions . 9
3.2 Abbreviations . 10
4 General Structure of a TTCN-3 Test System . 10
4.1 Entities in a TTCN-3 Test System . 11
4.1.1 Test Management and Control (TMC). 11
4.1.1.1 Test Management (TM) . 11
4.1.1.2 Test Logging (TL) . 11
4.1.1.3 Coding and Decoding (CD) . 11
4.1.1.4 Component Handling (CH) . 11
4.1.2 TTCN-3 Executable (TE) . 11
4.1.2.1 Executable Test Suite (ETS) . 12
4.1.2.2 TTCN-3 Runtime System (T3RTS) . 12
4.1.2.3 Encoding/Decoding System (EDS) . 12
4.1.2.4 Timers in the TTCN-3 Executable . 12
4.1.3 SUT Adaptor (SA) . 13
4.1.4 Platform Adaptor (PA) . 13
4.2 Interfaces in a TTCN-3 Test System . 13
4.3 Execution requirements for a TTCN-3 test system . 13
5 TTCN-3 Runtime Interface and operations . 14
5.1 Overview of the TRI. 14
5.1.1 The triCommunication Interface . 14
5.1.2 The triPlatform Interface . 14
5.1.3 Correlation between TTCN-3 and TRI Operation Invocations . 14
5.2 Error handling . 15
5.3 Data interface . 15
5.3.1 Connection . 16
5.3.2 Communication . 16
5.3.3 Timer . 17
5.3.4 Miscellaneous . 17
5.4 Operation descriptions . 17
5.5 Communication interface operations . 18
5.5.1 triSAReset (TE → SA) . 18
5.5.2 Connection handling operations . 18
5.5.2.1 triExecuteTestCase (TE → SA) . 18
5.5.2.2 triMap (TE → SA) . 18
5.5.2.3 triUnmap (TE → SA) . 19
5.5.2.4 triEndTestCase (TE → SA) . 19
5.5.3 Message based communication operations . 19
5.5.3.1 triSend (TE → SA) . 19
5.5.3.2 triSendBC (TE → SA) . 20
5.5.3.3 triSendMC (TE → SA) . 20
5.5.3.4 triEnqueueMsg (SA → TE) . 21
5.5.4 Procedure based communication operations . 21
ETSI
---------------------- Page: 3 ----------------------
4 ETSI ES 201 873-5 V4.1.1 (2009-06)
5.5.4.1 triCall (TE → SA) . 21
5.5.4.2 triCallBC (TE → SA) . 22
5.5.4.3 triCallMC (TE → SA) . 23
5.5.4.4 triReply (TE → SA) . 24
5.5.4.5 triReplyBC (TE → SA) . 25
5.5.4.6 triReplyMC (TE → SA) . 26
5.5.4.7 triRaise (TE → SA) . 26
5.5.4.8 triRaiseBC (TE → SA) . 27
5.5.4.9 triRaiseMC (TE → SA) . 27
5.5.4.10 triEnqueueCall (SA → TE) . 28
5.5.4.11 triEnqueueReply (SA → TE) . 28
5.5.4.12 triEnqueueException (SA → TE) . 29
5.5.5 Miscellaneous operations . 29
5.5.5.1 triSUTactionInformal (TE → SA) . 29
5.5.5.2 triSUTactionTemplate (TE → SA) . 29
5.6 Platform interface operations . 29
5.6.1 triPAReset (TE → PA) . 29
5.6.2 Timer operations . 30
5.6.2.1 triStartTimer (TE → PA) . 30
5.6.2.2 triStopTimer (TE → PA). 30
5.6.2.3 triReadTimer (TE → PA) . 30
5.6.2.4 triTimerRunning (TE → PA) . 31
5.6.2.5 triTimeout (PA → TE) . 31
5.6.3 Miscellaneous operations . 32
5.6.3.1 triExternalFunction (TE → PA) . 32
6 Java language mapping . 32
6.1 Introduction . 32
6.2 Names and scopes . 32
6.2.1 Names . 32
6.2.2 Scopes . 33
6.3 Type mapping . 33
6.3.1 Basic type mapping . 33
6.3.1.1 Boolean . 33
6.3.1.1.1 Methods . 33
6.3.1.2 String . 33
6.3.2 Structured type mapping . 33
6.3.2.1 TriPortIdType . 34
6.3.2.1.1 Methods . 34
6.3.2.2 TriPortIdListType . 34
6.3.2.2.1 Methods . 34
6.3.2.3 TriComponentIdType . 35
6.3.2.3.1 Methods . 35
6.3.2.4 TriComponentIdListType . 35
6.3.2.4.1 Methods . 35
6.3.2.5 TriMessageType . 36
6.3.2.5.1 Methods . 36
6.3.2.6 TriAddressType . 36
6.3.2.6.1 Methods . 36
6.3.2.7 TriAddressListType . 37
6.3.2.7.1 Methods . 37
6.3.2.8 TriSignatureIdType . 37
6.3.2.8.1 Methods . 37
6.3.2.9 TriParameterType . 38
6.3.2.9.1 Methods . 38
6.3.2.10 TriParameterPassingModeType . 38
6.3.2.10.1 Constants . 38
6.3.2.11 TriParameterListType . 39
6.3.2.11.1 Methods . 39
6.3.2.12 TriExceptionType . 39
6.3.2.12.1 Methods . 39
ETSI
---------------------- Page: 4 ----------------------
5 ETSI ES 201 873-5 V4.1.1 (2009-06)
6.3.2.13 TriTimerIdType . 40
6.3.2.13.1 Methods . 40
6.3.2.14 TriTimerDurationType . 40
6.3.2.14.1 Methods . 40
6.3.2.15 TriFunctionIdType . 40
6.3.2.15.1 Methods . 40
6.3.2.16 TriTestCaseIdType . 41
6.3.2.16.1 Methods . 41
6.3.2.17 TriActionTemplateType . 41
6.3.2.18 TriStatusType . 41
6.3.2.18.1 Methods . 41
6.4 Constants . 42
6.5 Mapping of interfaces . 42
6.5.1 Out and InOut Parameter Passing Mode . 42
6.5.2 triCommunication - Interface . 42
6.5.2.1 triCommunicationSA . 43
6.5.2.2 triCommunicationTE. 44
6.5.3 triPlatform - Interface . 44
6.5.3.1 TriPlatformPA . 44
6.5.3.2 TriPlatformTE . 45
6.6 Optional parameters . 45
6.7 TRI initialization . 45
6.8 Error handling . 45
7 ANSI C language mapping. . 45
7.1 Introduction . 45
7.2 Names and scopes . 45
7.2.1 Abstract type mapping . 46
7.2.2 ANSI C type definitions . 47
7.2.3 IDL type mapping . 47
7.2.4 TRI operation mapping . 47
7.3 Memory management . 49
7.4 Error handling . 49
8 C++ language mapping . 49
8.1 Introduction . 49
8.2 Names and scopes . 49
8.3 Memory management . 49
8.4 Error handling . 50
8.5 Type mapping . 50
8.5.1 Encapsulated C++ types. 50
8.5.2 Abstract data types . 50
8.5.2.1 QualifiedName . 50
8.5.2.1.1 Methods . 50
8.5.2.2 TriAddress . 51
8.5.2.2.1 Methods . 51
8.5.2.3 TriAddressList . 52
8.5.2.3.1 Methods . 52
8.5.2.4 TriComponentId . 53
8.5.2.4.1 Methods . 53
8.5.2.5 TriComponentIdList . 54
8.5.2.5.1 Methods . 54
8.5.2.6 TriException. 54
8.5.2.6.1 Methods . 55
8.5.2.7 TriFunctionId . 55
8.5.2.7.1 Methods . 55
8.5.2.8 TriMessage . 55
8.5.2.8.1 Methods . 56
8.5.2.9 TriParameter. 56
8.5.2.9.1 Methods . 56
8.5.2.10 TriParameterList . 57
8.5.2.10.1 Methods .
...