M2UA Protocol Modules For TTCN-3 Toolset With TITAN, User Guide
M2UA Protocol Modules For TTCN-3 Toolset With TITAN, User Guide
Presumed Knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Protocol Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Terminology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
About This Document
How to Read This Document
This is the User Guide for the M2UA protocol module. The M2UA protocol module is developed for
the TTCN-3 Toolset with TITAN. This document should be read together with Function Specification
[3].
Presumed Knowledge
To use this protocol module the knowledge of the TTCN-3 language [1] is essential.
M2UA is specified in the IETF RFC [4]. A Function Specification was not available.
System Requirements
Protocol modules are a set of TTCN-3 source code files that can be used as part of TTCN-3 test suites
only. Hence, protocol modules alone do not put specific requirements on the system used. However
in order to compile and execute a TTCN-3 test suite using the set of protocol modules the following
system requirements must be satisfied:
• TITAN TTCN-3 Test Executor R7A (1.7.pl0) or higher installed. For installation guide see [2].
This version of the protocol module is not compatible with TITAN releases earlier
NOTE
than R7A.
Protocol Modules
Overview
Protocol modules implement the messages structure of the related protocol in a formalized way,
using the standard specification language TTCN-3. This allows defining of test data (templates) in
the TTCN-3 language [1] and correctly encoding/decoding messages when executing test suites
using the Titan TTCN-3 test environment.
Protocol modules are using Titan’s RAW encoding attributes [2] and hence are usable with the Titan
test toolset only.
The table below contains the implemented messages and the corresponding TTCN-3 type records.
Using those type records, templates can be defined to send and receive a given message.
1
Message name Reference Corresponding type record in
M2UA_Types.ttcn
Establish Request [4] 3.3.1.3 M2UA_EST_REQ
Establish Confirm [4] 3.3.1.3 M2UA_EST_CFM
Release Request [4] 3.3.1.4 M2UA_REL_REQ
Release Confirm [4] 3.3.1.4 M2UA_REL_CFM
Release Indication [4] 3.3.1.4 M2UA_REL_IND
State Request [4] 3.3.1.5 M2UA_STATE_REQ
State Confirm [4] 3.3.1.6 M2UA_STATE_CFM
State Indication [4] 3.3.1.7 M2UA_STATE_IND
Data Retrieval Request [4] 3.3.1.9 M2UA_DATA_RETR_REQ
Data Retrieval Confirm [4] 3.3.1.10 M2UA_DATA_RETR_CFM
Data Retrieval Indication [4] 3.3.1.11 M2UA_DATA_RETR_IND
Data Retrieval Compete [4] 3.3.1.12 M2UA_DATA_RETR_COMP_IND
Indication
Congestion Indication [4] 3.3.1.8 M2UA_CONG_IND
Data Acknowledge [4] 3.3.1.2 M2UA_DATA_ACK
ASP Up [4] 3.3.2.1 M2UA_ASPUP
ASP Up Ack [4] 3.3.2.2 M2UA_ASPUP_Ack
ASP Down [4] 3.3.2.3 M2UA_ASPDN
ASP Down Ack [4] 3.3.2.4 M2UA_ASPDN_Ack
ASP Active [4] 3.3.2.7 M2UA_ASPAC
ASP Active Ack [4] 3.3.2.8 M2UA_ASPAC_Ack
ASP Inactive [4] 3.3.2.9 M2UA_ASPIA
ASP Inactive Ack [4] 3.3.2.10 M2UA_ASPIA_Ack
Heartbeat [4] 3.3.2.5 M2UA_BEAT
Heartbeat Ack [4] 3.3.2.6 M2UA_BEAT_Ack
Error [4] 3.3.3.1 M2UA_ERR
Notify [4] 3.3.3.2 M2UA_NTFY
Registration Request [4] 3.3.4.1 M2UA_REG_REQ
Registration Response [4] 3.3.4.2 M2UA_REG_RSP
Deregistration Request [4] 3.3.4.3 M2UA_DEREG_REQ
Deregistration Response [4] 3.3.4.4 M2UA_DEREG_RSP
Installation
The set of protocol modules can be used in developing TTCN-3 test suites using any text editor.
Howeve,r to make the work more efficient a TTCN-3-enabled text editor is recommended (e.g. nedit,
2
xemacs). Since the M2UA protocol is used as a part of a TTCN-3 test suite, this requires TTCN-3 Test
Executor be installed before the module can be compiled and executed together with other parts of
the test suite. For more details on the installation of TTCN-3 Test Executor see the relevant section of
[2].
Configuration
None.
Example
There are no examples available for this protocol module.
Terminology
Application Server Process (ASP)
A process instance of an application Server. Examples of Application Server Processes are primary
or backup MGC instances.
Abbreviations
ASP
Application Server Process
ISDN
Integrated Services Digital Network
M2UA
Message Transfer Part 2 User Application Layer Protocol
MGC
Media Gateway Controller
PDU
Protocol Data Unit
TEI
Terminal Endpoint Identifier
TTCN-3
Testing and Test Control Notation version 3
3
References
[1] ETSI ES 201 873-1 v.3.1.1 (06/2005)The Testing and Test Control Notation version 3. Part 1: Core
Language
[3] M2UA Protocol Modules for TTCN-3 Toolset with TITAN, Function Specification