---
Author: Timea Moder
Version: 1551-CNL 113 834, Rev. A
Date: 2016-04-15
---
= SGsAP v13.2.0 Protocol Modules for TTCN-3 Toolset with TITAN, Function Description
:author: Timea Moder
:revnumber: 1551-CNL 113 834, Rev. A
:revdate: 2016-04-15
:toc:


*Abstract*

This is the description for the SGsAP v13.2.0 protocol module. The SGsAP v13.2.0 protocol modules are developed for the TTCN-3 Toolset with Titan. This document should be read together with the <<_2,Product Revision Information>>.

= Functionality

The SGsAP v13.2.0 protocol module implements the message structures of the <<_6,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 and correctly encoding/decoding messages when executing test suites using the Titan TTCN-3 test environment.

The SGsAP v13.2.0 protocol module uses <<_1,Titan’s RAW encoding attributes>> and hence is usable with the Titan test toolset only.

== Implemented protocols

This set of protocol modules implements protocol messages and constants of the SGsAP v13.2.0 protocol as described <<_6,here>>.

=== Modified and non-implemented Protocol Elements

None.

== Backward incompatibilities

None.

== 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 version CRL 113 200/5 R4A (5.4.pl0) or higher installed. For Installation Guide, see <<_5,here>>.

NOTE: This version of the test port is not compatible with Titan releases earlier than CRL 113 200/5 R4A.

= Usage

== Installation

The set of protocol modules can be used in developing TTCN-3 test suites using any text editor; however, to make the work more efficient, a TTCN-3-enabled text editor is recommended (for example nedit, xemacs). Since the SGsAP v13.2.0 protocol is used as a part of a TTCN-3 test suite, this requires TTCN-3 Test Executor to 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 the <<_3,User Guide for TITAN TTCN-3 Test Executor>>.

== Configuration

None.

== Examples

None.

= Interface description

== Top Level PDU

The top level PDU is the TTCN-3 union PDU_SGsAP.

[[encoding-decoding-and-other-related-functions]]
== Encoding/decoding and other related functions

This product also contains encoding/decoding functions, which assure correct encoding of messages when sent from Titan and correct decoding of messages when received by Titan.

=== Implemented encoding and decoding functions

[width="100%",cols="34%,33%,33%",options="header",]
|===
|Name |Type of formal parameters |Type of return value
|`enc_PDU_SGsAP` | PDU_SGsAP |octetstring

|`dec_PDU_SGsAP` | octetstring |PDU_SGsAP

|`enc_PDU_SGsAP_fast` |PDU_SGsAP |octetstring

|`dec_PDU_SGsAP_backtrack` |octetstring |PDU_SGsAP
|===

= Terminology

== Abbreviations

SGsAP:: SGs Application Protocol

TTCN-3:: Testing and Test Control Notation version 3

PDU:: Protocol Data Unit

= References

1. [[_1]]ETSI ES 201 873-1 v.3.2.1 (2007-02) +
The Testing and Test Control Notation version 3. Part 1: Core Language

2. [[_2]]109 21-CNL 113 834-1 Uen +
SGsAP v13.2.0 Protocol Modules for TTCN-3 Toolset with TITAN, Product Revision Information

3. [[_3]]1/ 198 17-CRL 113 200/5 Uen +
User Guide for TITAN TTCN-3 Test Executor

4. [[_4]]2/198 17-CRL 113 200/5 Uen +
Programmer’s Technical Reference for the TITAN TTCN-3 Test Executor

5. [[_5]]1/1531-CRL 113 200/5 Uen +
Installation Guide for the TITAN TTCN-3 Test Executor

6. [[_6]]3GPP TS 29.118 V13.2.0 (2015-09) +
Technical Specification +
3rd Generation Partnership Project; +
Technical Specification Group Core Network and Terminals; +
Mobility Management Entity (MME) – Visitor Location Register (VLR)SGs interface specification +
(Release 13)

=	Change information

==	R1A

Initial version.