SIST ES 201 873-6 V4.12.1:2020
(Main)The present document specifies the control interfaces for TTCN-3 test system implementations. The TTCN-3 Control
Interfaces provide a standardized adaptation for management, test component handling and encoding/decoding of a test
system to a particular test platform. The present document defines the interfaces as a set of operations independent of a
target language.
The interfaces are defined to be compatible with the TTCN-3 standard (see clause 2). The interface definition uses the
CORBA Interface Definition Language (IDL) to specify the TCI completely. Clauses 8, 9, 10, 11 and 12 present
language mappings for this abstract specification to the target languages Java™, ANSI C, C++, XML and C#.
A summary of the IDL-based interface specification is provided in annex A.
NOTE: Java™ is the trade name of a programming language developed by Oracle Corporation. This information
is given for the convenience of users of the present document and does not constitute an endorsement by
ETSI of the programming language named. Equivalent programming languages may be used if they can
be shown to lead to the same results.
Metode za preskušanje in specificiranje (MTS) - 3. različica zapisa preskušanja in krmiljenja preskusov - 6. del: Krmilni vmesnik TTCN-3 (TCI)
General Information
Standards Content (sample)
SLOVENSKI STANDARD
SIST ES 201 873-6 V4.12.1:2020
01-julij-2020
Metode za preskušanje in specificiranje (MTS) - 3. različica zapisa preskušanja in
krmiljenja preskusov - 6. del: Krmilni vmesnik TTCN-3 (TCI)Methods for Testing and Specification (MTS) - The Testing and Test Control Notation
version 3 - Part 6: TTCN-3 Control Interface (TCI)Ta slovenski standard je istoveten z: ETSI ES 201 873-6 V4.12.1 (2020-05)
ICS:
33.040.01 Telekomunikacijski sistemi Telecommunication systems
na splošno in general
SIST ES 201 873-6 V4.12.1:2020 en
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.
---------------------- Page: 1 ----------------------SIST ES 201 873-6 V4.12.1:2020
---------------------- Page: 2 ----------------------
SIST ES 201 873-6 V4.12.1:2020
ETSI ES 201 873-6 V4.12.1 (2020-05)
ETSI STANDARD
Methods for Testing and Specification (MTS);
The Testing and Test Control Notation version 3;
Part 6: TTCN-3 Control Interface (TCI)
---------------------- Page: 3 ----------------------
SIST ES 201 873-6 V4.12.1:2020
2 ETSI ES 201 873-6 V4.12.1 (2020-05)
Reference
RES/MTS-201873-6v4.12.1
Keywords
control, interface, methodology, TCI, testing,
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 enregistrée à la
Sous-Préfecture de Grasse (06) N° 7803/88
Important notice
The present document can 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
existing or perceived difference in contents between such versions and/or in print, the prevailing version of an ETSI
deliverable is the one made publicly available in PDF format at www.etsi.org/deliver.
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
https://portal.etsi.org/TB/ETSIDeliverableStatus.aspxIf you find errors in the present document, please send your comment to one of the following services:
https://portal.etsi.org/People/CommiteeSupportStaff.aspxCopyright 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 written authorization of ETSI.
The copyright and the foregoing restriction extend to reproduction in all media.© ETSI 2020.
All rights reserved.
DECT™, PLUGTESTS™, UMTS™ and the ETSI logo are trademarks of ETSI registered for the benefit of its Members.
3GPP™ and LTE™ are trademarks of ETSI registered for the benefit of its Members and
of the 3GPP Organizational Partners.oneM2M™ logo is a trademark of ETSI registered for the benefit of its Members and
of the oneM2M Partners.GSM and the GSM logo are trademarks registered and owned by the GSM Association.
ETSI
---------------------- Page: 4 ----------------------
SIST ES 201 873-6 V4.12.1:2020
3 ETSI ES 201 873-6 V4.12.1 (2020-05)
Contents
Intellectual Property Rights .............................................................................................................................. 16
Foreword ........................................................................................................................................................... 16
Modal verbs terminology .................................................................................................................................. 16
1 Scope ...................................................................................................................................................... 17
2 References .............................................................................................................................................. 17
2.1 Normative references ....................................................................................................................................... 17
2.2 Informative references ...................................................................................................................................... 18
3 Definition of terms, symbols and abbreviations ..................................................................................... 18
3.1 Terms ................................................................................................................................................................ 18
3.2 Symbols ............................................................................................................................................................ 19
3.3 Abbreviations ................................................................................................................................................... 19
4 Introduction ............................................................................................................................................ 20
5 Compliance ............................................................................................................................................. 20
6 General structure of a TTCN-3 test system ............................................................................................ 21
6.1 Entities in a TTCN-3 test system ...................................................................................................................... 21
6.1.0 Types of entities .......................................................................................................................................... 21
6.1.1 Test Management and Control (TMC)........................................................................................................ 22
6.1.1.0 Test Management and Control Entities ................................................................................................. 22
6.1.1.1 Test Management (TM) ........................................................................................................................ 22
6.1.1.2 Coding and Decoding (CD) .................................................................................................................. 23
6.1.1.3 Component Handling (CH) ................................................................................................................... 23
6.1.1.4 Test Logging (TL) ................................................................................................................................. 24
6.1.2 TTCN-3 Executable (TE) ........................................................................................................................... 24
6.1.3 SUT Adaptor (SA) ...................................................................................................................................... 24
6.1.4 Platform Adaptor (PA) ................................................................................................................................ 24
6.2 Execution requirements for a TTCN-3 test system .......................................................................................... 24
7 TTCN-3 control interface and operations ............................................................................................... 25
7.1 Overview of the TCI......................................................................................................................................... 25
7.1.0 TCI role in a TTCN-3 test system ............................................................................................................... 25
7.1.1 Correlation between TTCN-3 and TCI operation invocations .................................................................... 25
7.1.1.0 Mapping of TTCN-3 operations to TCI operations ............................................................................... 25
7.1.1.1 TTCN-3 operations with TCI operation equivalent .............................................................................. 26
7.1.1.2 TTCN-3 operations with TCI operation pair equivalent ....................................................................... 26
7.1.1.3 TTCN-3 operations without direct TCI operation equivalent ............................................................... 27
7.1.1.3.0 Mapping of TTCN-3 operations to series of TCI operations ........................................................... 27
7.1.1.3.1 Test case stop operation ................................................................................................................... 27
7.2 TCI data ............................................................................................................................................................ 27
7.2.0 Abstract data types ...................................................................................................................................... 27
7.2.1 General abstract data types ......................................................................................................................... 28
7.2.1.0 Use of general abstract data types ......................................................................................................... 28
7.2.1.1 Management .......................................................................................................................................... 28
7.2.1.2 Communication ..................................................................................................................................... 29
7.2.2 Abstract TTCN-3 data types and values ..................................................................................................... 29
7.2.2.0 Definition and scope of use ................................................................................................................... 29
7.2.2.1 Abstract TTCN-3 data types ................................................................................................................. 29
7.2.2.2 Abstract TTCN-3 values ....................................................................................................................... 31
7.2.2.2.0 Basic rules ....................................................................................................................................... 31
7.2.2.2.1 The abstract data type Value ......................................................................................................... 32
7.2.2.2.2 The abstract data type IntegerValue ........................................................................................ 35
7.2.2.2.3 The abstract data type FloatValue ............................................................................................. 35
7.2.2.2.4 The abstract data type BooleanValue ........................................................................................ 35
7.2.2.2.5 The abstract data type CharstringValue ................................................................................. 35
ETSI---------------------- Page: 5 ----------------------
SIST ES 201 873-6 V4.12.1:2020
4 ETSI ES 201 873-6 V4.12.1 (2020-05)
7.2.2.2.6 The abstract data type UniversalCharstringValue ............................................................ 36
7.2.2.2.7 The abstract data type BitstringValue .................................................................................... 36
7.2.2.2.8 The abstract data type OctetstringValue ............................................................................... 37
7.2.2.2.9 The abstract data type HexstringValue .................................................................................... 38
7.2.2.2.10 The abstract data type RecordValue ........................................................................................... 39
7.2.2.2.11 The abstract data type RecordOfValue ...................................................................................... 39
7.2.2.2.12 The abstract data type UnionValue ............................................................................................. 41
7.2.2.2.13 The abstract data type EnumeratedValue ................................................................................. 41
7.2.2.2.14 The abstract data type VerdictValue ........................................................................................ 41
7.2.2.2.15 The abstract data type AddressValue ........................................................................................ 42
7.2.2.3 Abstract TTCN-3 matching mechanisms .............................................................................................. 42
7.2.2.3.1 The abstract data type MatchingMechanism ............................................................................ 42
7.2.2.3.2 The abstract data type MatchingList ........................................................................................ 42
7.2.2.3.3 The abstract data type ValueRange ............................................................................................. 43
7.2.2.3.4 The abstract data type CharacterPattern ............................................................................... 43
7.2.2.3.5 The abstract data type MatchDecodedContent ........................................................................ 44
7.2.2.4 Data types for complex TTCN-3 properties .......................................................................................... 44
7.2.2.4.0 Scope of use of TTCN-3 properties ................................................................................................. 44
7.2.2.4.1 The abstract data type LengthRestriction ............................................................................ 44
7.2.2.4.2 The abstract data type Permutation ........................................................................................... 44
7.2.2.4.3 The abstract data type RangeBoundary ...................................................................................... 45
7.2.3 Abstract logging types ................................................................................................................................ 45
7.2.3.1 The abstract data type TciValueTemplate ............................................................................................. 45
7.2.3.2 The abstract data type TciNonValueTemplate ...................................................................................... 45
7.2.3.3 The Value List and Mismatch Types .................................................................................................... 46
7.2.3.4 The Status Types ................................................................................................................................... 46
7.3 TCI operations .................................................................................................................................................. 47
7.3.0 The TCI interfaces ...................................................................................................................................... 47
7.3.1 The TCI-TM interface ................................................................................................................................ 48
7.3.1.0 Scope of use .......................................................................................................................................... 48
7.3.1.1 TCI-TM required ................................................................................................................................... 48
7.3.1.1.0 Scope of use ..................................................................................................................................... 48
7.3.1.1.1 tciRootModule ................................................................................................................................. 48
7.3.1.1.2 tciGetImportedModules ................................................................................................................... 49
7.3.1.1.3 tciGetModuleParameters ................................................................................................................. 49
7.3.1.1.4 tciGetTestCases ............................................................................................................................... 49
7.3.1.1.5 tciGetTestCaseParameters ............................................................................................................... 49
7.3.1.1.6 tciGetTestCaseTSI ........................................................................................................................... 49
7.3.1.1.7 tciStartTestCase ............................................................................................................................... 50
7.3.1.1.8 tciStopTestCase ............................................................................................................................... 50
7.3.1.1.9 tciStartControl ................................................................................................................................. 50
7.3.1.1.10 tciStopControl ................................................................................................................................. 50
7.3.1.1.11 tciGetControlParameters ................................................................................................................. 51
7.3.1.1.12 tciStartControlWithParameters ........................................................................................................ 51
7.3.1.2 TCI-TM provided .................................................................................................................................. 51
7.3.1.2.0 Scope of use ..................................................................................................................................... 51
7.3.1.2.1 tciTestCaseStarted ........................................................................................................................... 51
7.3.1.2.2 tciTestCaseTerminated .................................................................................................................... 51
7.3.1.2.3 tciControlTerminated ...................................................................................................................... 52
7.3.1.2.4 tciGetModulePar.............................................................................................................................. 52
7.3.1.2.5 tciLog .............................................................................................................................................. 52
7.3.1.2.6 tciError............................................................................................................................................. 52
7.3.1.2.7 tciControlTerminatedWithResult .................................................................................................... 53
7.3.2 The TCI-CD interface ................................................................................................................................. 53
7.3.2.0 Scope of use .......................................................................................................................................... 53
7.3.2.1 TCI-CD required ................................................................................................................................... 54
7.3.2.1.0 Scope of use ..................................................................................................................................... 54
7.3.2.1.1 getTypeForName ............................................................................................................................. 54
7.3.2.1.2 getInteger ......................................................................................................................................... 54
7.3.2.1.3 getFloat ............................................................................................................................................ 54
ETSI---------------------- Page: 6 ----------------------
SIST ES 201 873-6 V4.12.1:2020
5 ETSI ES 201 873-6 V4.12.1 (2020-05)
7.3.2.1.4 getBoolean ....................................................................................................................................... 54
7.3.2.1.5 Void ................................................................................................................................................. 54
7.3.2.1.6 getCharstring ................................................................................................................................... 55
7.3.2.1.7 getUniversalCharstring .................................................................................................................... 55
7.3.2.1.8 getHexstring .................................................................................................................................... 55
7.3.2.1.9 getBitstring ...................................................................................................................................... 55
7.3.2.1.10 getOctetstring .................................................................................................................................. 55
7.3.2.1.11 getVerdict ........................................................................................................................................ 55
7.3.2.1.12 tciErrorReq ...................................................................................................................................... 55
7.3.2.2 TCI-CD provided .................................................................................................................................. 55
7.3.2.2.0 Scope of use ..................................................................................................................................... 55
7.3.2.2.1 decode .............................................................................................................................................. 56
7.3.2.2.2 encode .............................................................................................................................................. 56
7.3.2.2.3 decodeValue .................................................................................................................................... 56
7.3.2.2.4 encodeValue .................................................................................................................................... 57
7.3.3 The TCI-CH interface ................................................................................................................................. 57
7.3.3.0 Scope of use .......................................................................................................................................... 57
7.3.3.1 TCI-CH required ................................................................................................................................... 58
7.3.3.1.0 Scope of use ..................................................................................................................................... 58
7.3.3.1.1 tciEnqueueMsgConnected ............................................................................................................... 58
7.3.3.1.2 tciEnqueueCallConnected ............................................................................................................... 58
7.3.3.1.3 tciEnqueueReplyConnected ............................................................................................................. 59
7.3.3.1.4 tciEnqueueRaiseConnected ............................................................................................................. 59
7.3.3.1.5 tciCreateTestComponent ................................................................................................................. 59
7.3.3.1.6 tciStartTestComponent .................................................................................................................... 60
7.3.3.1.7 tciStopTestComponent .................................................................................................................... 60
7.3.3.1.8 tciConnect ........................................................................................................................................ 60
7.3.3.1.9 tciDisconnect ................................................................................................................................... 60
7.3.3.1.10 tciMap .............................................................................................................................................. 61
7.3.3.1.11 tciMapParam ................................................................................................................................... 61
7.3.3.1.12 tciUnmap ......................................................................................................................................... 61
7.3.3.1.13 tciUnmapParam ............................................................................................................................... 61
7.3.3.1.14 tciTestComponentTerminated ......................................................................................................... 62
7.3.3.1.15 tciTestComponentRunning .............................................................................................................. 62
7.3.3.1.16 tciTestComponentDone ................................................................................................................... 62
7.3.3.1.17 tciGetMTC ....................................................................................................................................... 62
7.3.3.1.18 tciExecuteTestCase .......................................................................................................................... 63
7.3.3.1.19 tciReset ............................................................................................................................................ 63
7.3.3.1.20 tciKillTestComponent ..................................................................................................................... 63
7.3.3.1.21 tciTestComponentAlive ................................................................................................................... 63
7.3.3.1.22 tciTestComponentKilled .................................................................................................................. 64
7.3.3.1.23 tciCallTestComponent ..................................................................................................................... 64
7.3.3.1.24 tciTestComponentCallTerminated ................................................................................................... 64
7.3.3.2 TCI-CH provided .................................................................................................................................. 65
7.3.3.2.0 Scope of use ..................................................................................................................................... 65
7.3.3.2.1 tciSendConnected ............................................................................................................................ 65
7.3.3.2.2 tciSendConnectedBC ....................................................................................................................... 65
7.3.3.2.3 tciSendConnectedMC ...................................................................................................................... 65
7.3.3.2.4 tciCallConnected ............................................................................................................................. 66
7.3.3.2.5 tciCallConnectedBC ........................................................................................................................ 66
7.3.3.2.6 tciCallConnectedMC ....................................................................................................................... 67
7.3.3.2.7 tciReplyConnected .......................................................................................................................... 67
7.3.3.2.8 tciReplyConnectedBC ..................................................................................................................... 68
7.3.3.2.9 tciReplyConnectedMC .................................................................................................................... 68
7.3.3.2.10 tciRaiseConnected ........................................................................................................................... 69
7.3.3.2.11 tciRaiseConnectedBC ...................................................................................................................... 69
7.3.3.2.12 tciRaiseConnectedMC ..................................................................................................................... 69
7.3.3.2.13 tciCreateTestComponentReq ........................................................................................................... 70
7.3.3.2.14 tciStartTestComponentReq .................................................................
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.