diff --git a/usrguide/java_referenceguide/1-about_the_document.adoc b/usrguide/java_referenceguide/1-about_the_document.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..bc7c0197f43a8efc849a00167434e7dd67965b96
--- /dev/null
+++ b/usrguide/java_referenceguide/1-about_the_document.adoc
@@ -0,0 +1,22 @@
+= About the Document
+:toc:
+
+== Purpose
+
+The purpose of this document is to provide detailed information on writing components, for example, test ports, and so on, for executable test suites, for the Java side of the TITAN TTCN-3 Toolset.
+
+== Target Groups
+
+This document is intended for programmers of TTCN–3 test suites, using the prototype Java code generator provided in the plugins, with information in addition to that provided in the <<_13, TITAN User Guide>>, <<_16, API Technical Reference>> and <<_27, Programmers' Technical Reference Guide>>. It is recommended that the programmer reads the TITAN User Guide before reading this document.
+
+== Typographical Conventions
+
+This document uses the following typographical conventions:
+
+*Bold* is used to represent graphical user interface (GUI) components such as buttons, menus, menu items, dialog box options, fields and keywords, as well as menu commands. Bold is also used with ’+’ to represent key combinations. For example, *Ctrl+Click*
+
+The character `**/**' is used to denote a menu and sub-menu sequence. For example, *File / Open*.
+
+`Monospaced` font is used represent system elements such as command and parameter names, program names, path names, URLs, directory names and code examples.
+
+*`Bold monospaced`* font is used for commands that must be entered at the Command Line Interface (CLI).
diff --git a/usrguide/java_referenceguide/13-references.adoc b/usrguide/java_referenceguide/13-references.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..e3c7a33cf47789103f04942a2d453227ad0ed543
--- /dev/null
+++ b/usrguide/java_referenceguide/13-references.adoc
@@ -0,0 +1,82 @@
+= References
+
+[[_1]]
+* [1] link:https://www.etsi.org/deliver/etsi_es/201800_201899/20187301/04.01.01_60/es_20187301v040101p.pdf[Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3. Part 1: Core Language European Telecommunications Standards Institute ES 201 873-1 Version 4.1.1, July 2009]
+
+[[_2]]
+* [2] link:https://www.etsi.org/deliver/etsi_es/201800_201899/20187304/04.01.01_60/es_20187304v040101p.pdf[Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3. Part 4: TTCN–3 Operational Semantics European Telecommunications Standards Institute. ES 201 873-4 Version 4.1.1, June 2009]
+
+[[_3]]
+* [3] link:https://www.etsi.org/deliver/etsi_es/201800_201899/20187307/04.01.01_60/es_20187307v040101p.pdf[Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3. Part 7: Using ASN.1 with TTCN–3 European Telecommunications Standards Institute. ES 201 873-7 Version 4.1.1, July 2009]
+
+[[_4]]
+* [4] link:https://www.etsi.org/deliver/etsi_es/201800_201899/20187309/04.01.01_60/es_20187309v040101p.pdf[Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3. Part 9: Using XML Schema with TTCN–3 European Telecommunications Standards Institute. ES 201 873-9 Version 4.1.1, June 2009]
+
+[[_5]]
+* [5] link:https://www.etsi.org/deliver/etsi_es/202700_202799/202785/01.05.01_60/es_202785v010501p.pdf[Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3. TTCN-3 Language Extensions: Behaviour Types European Telecommunications Standards Institute. ES 202 785 Version 1.5.1, Aug 2017]
+
+[[_6]]
+* [6] link:https://www.itu.int/rec/T-REC-X.680-200207-S[ITU-T, X.680, Information TechnologyAbstract Syntax Notation One (ASN.1): Specification of basic notation International Telecommunication Union, July 2002]
+
+[[_7]]
+* [7] link:https://www.itu.int/rec/T-REC-X.681-200207-S[ITU-T, X.681, Information TechnologyAbstract Syntax Notation One (ASN.1): Information object specification International Telecommunication Union, July 2002]
+
+[[_8]]
+* [8] link:https://www.itu.int/rec/T-REC-X.682-200207-S[ITU-T, X.682, Information Technology Abstract Syntax Notation One (ASN.1): Constraint specification International Telecommunication Union, July 2002]
+
+[[_9]]
+* [9] link:https://www.itu.int/rec/T-REC-X.683-200207-S[ITU-T, X.683, Information TechnologyAbstract Syntax Notation One (ASN.1): Parameterization of ASN.1 specification International Telecommunication Union, July 2002]
+
+[[_10]]
+* [10] link:https://www.itu.int/rec/T-REC-X.690-200207-S[ITU-T, X.690, Information TechnologyASN.1 encoding rules: Specification of Basic Encoding Rules (BER), Canonical Encoding Rules (CER) and Distinguished Encoding Rules (DER)International Telecommunication Union, July 2002]
+
+[[_11]]
+* [11] ISO/IEC 10646-1, Information technology – Universal Multiple-Octet Coded Character Set (UCS) – Part 1: Architecture and Basic Multilingual Plane, Second edition, 200009-15
+
+[[_12]]
+* [12] link:https://tools.ietf.org/html/rfc3629[RFC3629: UTF-8, a transformation format of ISO 10646]
+
+[[_13]]
+* [13] link:https://github.com/eclipse/titan.core/blob/master/usrguide/userguide/[User Guide for TITAN TTCN-3 Test Executor]
+
+[[_14]]
+* [14] link:https://github.com/eclipse/titan.core/blob/master/usrguide/installationguide/[Installation guide for TITAN TTCN-3 Test Executor]
+
+[[_15]]
+* [15] link:https://github.com/eclipse/titan.core/blob/master/usrguide/releasenotes/[Release Notes for TITAN TTCN-3 Test Executor]
+
+[[_16]]
+* [16] link:https://github.com/eclipse/titan.core/blob/master/usrguide/apiguide/[API Technical Reference for TITAN TTCN-3 Test Executor]
+
+[[_17]]
+* [17] link:https://github.com/eclipse/titan.EclipsePlug-ins/tree/master/org.eclipse.titan.designer/docs/Eclipse_Designer_userguide/[User Guide for the TITAN Designer for the Eclipse]
+
+[[_18]]
+* [18] link:https://www.etsi.org/deliver/etsi_es/201800_201899/20187301/04.03.01_60/es_20187301v040301p.pdf[ETSI ES 201 373-1 V4.3.1 (2011-06)]
+
+[[_19]]
+* [19] link:http://gask2web.ericsson.se/service/get?DocNo=1092-212&Lang=EN&Rev=N&Format=PDFV1R2[1092-212 Uen (EN/LZB 101 01/1D) Product Changes]
+
+[[_20]]
+* [20] link:https://www.itu.int/rec/T-REC-X.696-201508-I[ITU-T, X.696, Information TechnologyASN.1 encoding rules: Specification of Octet Encoding Rules (OERInternational Telecommunication Union, August 2015]
+
+[[_21]]
+* [21] link:https://www.etsi.org/deliver/etsi_es/202700_202799/202781/01.04.01_60/es_202781v010401p.pdf[ETSI ES 202 781 V1.4.1. (2015-06 Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3; TTCN-3 Language Extensions: Configuration and Deployment Support)]
+
+[[_22]]
+* [22] link:https://tools.ietf.org/html/rfc7049[RFC7049: Concise Binary Object Representation (CBOR) (October 2013)]
+
+[[_23]]
+* [23] link:http://bsonspec.org/spec.html[BSON specification version 1.1]
+
+[[_24]]
+* [24] link:https://docs.mongodb.com/manual/reference/mongodb-extended-json/#bson-data-types-and-associated-representations[MongoDB Extended JSON document]
+
+[[_25]]
+* [25] link:https://www.etsi.org/deliver/etsi_es/201800_201899/20187311/04.07.01_60/es_20187311v040701p.pdf[Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3. Part 11: Using JSON with TTCN–3 European Telecommunications Standards Institute. ES 201 873-11 Version 4.7.1, June 2017]
+
+[[_26]]
+* [26] link:https://www.etsi.org/deliver/etsi_es/202700_202799/202782/01.03.01_60/es_202782v010301p.pdf[ETSI ES 202 782 V1.3.1. (2015-06 Methods for Testing and Specification (MTS); The Testing and Test Control Notation version 3; TTCN-3 Language Extensions: TTCN-3 Performance and Real Time Testing)]
+
+[[_27]]
+* [27] link:https://github.com/eclipse/titan.core/blob/master/usrguide/referenceguide/[Programmers' Technical Reference Guide for the TITAN TTCN-3 Toolset]
diff --git a/usrguide/java_referenceguide/14-abbreviations.adoc b/usrguide/java_referenceguide/14-abbreviations.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..dfa4c5d9da32a7785fa46f9ffa911ab9980cc611
--- /dev/null
+++ b/usrguide/java_referenceguide/14-abbreviations.adoc
@@ -0,0 +1,105 @@
+= Abbreviations
+
+API:: Application Programming Interface
+
+ASCII:: American Standard Code for Information Interchange
+
+ASN.1:: Abstract Syntax Notation One
+
+ATS:: Abstract Test Suite
+
+BER:: Basic Encoding Rules (of ASN.1)
+
+BNF:: Backus–Naur Formalism
+
+CER:: Canonical Encoding Rules (of ASN.1)
+
+CPP:: Cello Packet Platform
+
+CR:: Change Request
+
+DER:: Distinguished Encoding Rules (of ASN.1)
+
+DNS:: Domain Name Server
+
+DTD:: Document Type Description
+
+ETS:: Executable Test Suite
+
+ETSI:: European Telecommunications Standards Institute
+
+FIFO:: First In, First Out
+
+GCC:: GNU Compiler Collection
+
+GUI:: Graphical User Interface
+
+HC:: Host Controller
+
+HTML:: Hypertext Markup Language
+
+HTTP:: HyperText Transfer Protocol
+
+IDL:: Interface Description Language
+
+IE:: Information Element
+
+IP:: Internet Protocol
+
+ISO:: International Organization for Standardization
+
+JSON:: JavaScript Object Notation
+
+LCOV:: A graphical front-end for GCC’s coverage testing tool
+
+LSB:: Least Significant Bit
+
+MC:: Main Controller
+
+MSB:: Most Significant Bit
+
+MTC:: Main (or Master) Test Component
+
+OSE:: Open System Environment
+
+PDU:: Protocol Data Unit
+
+pl:: Patch Level
+
+PTC:: Parallel Test Component
+
+PT:: Port Type
+
+SOAP:: Simple Object Access Protocol
+
+SUT:: System Under Test
+
+TC:: Test Component (either MTC or PTC)
+
+TCC:: Test Competence Center
+
+TCP:: Transmission Control Protocol
+
+TLV:: Tag, length, value
+
+TPD:: Titan Project Descriptor
+
+TR:: Trouble Report
+
+TTCN:: Testing and Test Control Notation
+
+TTCN–2:: Tree and Tabular Combined Notation version 2
+
+TTCN–3:: Tree and Tabular Combined Notation version 3 (formerly)Testing and Test Control Notation (new resolution)
+
+UDP:: User Datagram Protocol
+
+URL:: Universal Resource Locator
+
+URI:: Uniform Resource Identifier
+
+W3C:: World Wide Web Consortium
+
+XML:: W3C Extensible Markup Language
+
+XSD:: W3C XML Schema Definition
diff --git a/usrguide/java_referenceguide/JavaReferenceGuide.adoc b/usrguide/java_referenceguide/JavaReferenceGuide.adoc
new file mode 100644
index 0000000000000000000000000000000000000000..769994cc92503931292c237b3761b7b93b651095
--- /dev/null
+++ b/usrguide/java_referenceguide/JavaReferenceGuide.adoc
@@ -0,0 +1,102 @@
+---
+Author: Jenő Balaskó
+Version: 2/198 17-CRL 113 200/6, Rev. E
+Date: 2018-12-03
+
+---
+= Programmers' Technical Reference Guide for the Java side of the TITAN TTCN-3 Toolset
+:author: Jenő Balaskó
+:revnumber: 2/198 17-CRL 113 200/6, Rev. E
+:revdate: 2019-29-04
+:title-logo-image: images/titan_logo.png
+:sectnums:
+:doctype: book
+:toc:
+
+ifdef::env-github,backend-html5[]
+image::images/titan_logo.png[alt]
+endif::[]
+
+*Abstract*
+
+This document describes detailed information on writing components of executable test suites for the Java side of the TITAN TTCN-3 Toolset.
+
+*Copyright*
+
+Copyright (c) 2000-2019 Ericsson Telecom AB. +
+All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0 that accompanies this distribution, and is available at +
+https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.html.
+
+*Disclaimer*
+
+The contents of this document are subject to revision without notice due to continued progress in methodology, design and manufacturing. Ericsson should have no liability for any error or damage of any kind resulting from the use of this document.
+
+////
+TTCN-3 Limitations in this Version
+Clarifications to the TTCN-3 Standard
+TTCN–3 Language Extensions
+Supported ASN.1 Constructs and Limitations
+Compiling TTCN–3 and ASN.1 Modules
+XSD to TTCN-3 Converter ... kulso hivas
+Code Coverage of TTCN-3 Modules
+The TTCN-3 Debugger
+Tips & Troubleshootings
+
+API guide -bol
+Generating the Skeleton
+Message es procedure based example
+Test Port functions
+Logger plugins
+Encoding
+Mapping TTCN-3 Data Type to Java constructs
+////
+
+
+ifdef::env-github,backend-html5[]
+* link:1-about_the_document.adoc[About the document]
+////
+* link:2-ttcn-3_limitations_in_this_version.adoc[TTCN-3 Limitations in this Version]
+* link:3-clarifications_to_the_ttcn-3_standard.adoc[Clarifications to the TTCN-3 Standard]
+* link:4-ttcn3_language_extensions.adoc[TTCN–3 Language Extensions]
+* link:5-supported_asn1_constructs_and_limitations.adoc[Supported ASN.1 Constructs and Limitations]
+* link:6-compiling_ttcn3_and_asn1_modules.adoc[Compiling TTCN–3 and ASN.1 Modules]
+* link:7-the_run-time_configuration_file.adoc[The Run-time Configuration File]
+* link:8-the_titan_project_descriptor_file.adoc[The TITAN Project Descriptor File]
+* link:9-xsd_to_ttcn-3_converter.adoc[XSD to TTCN-3 Converter]
+* link:10-code_coverage_of_ttcn-3_modules.adoc[Code Coverage of TTCN-3 Modules]
+* link:11-the_ttcn-3_debugger.adoc[The TTCN-3 Debugger]
+* link:12-tips_&_troubleshooting.adoc[Tips & Troubleshootings]
+* link:2-test_ports.adoc[Test Ports]
+* link:3-logger_plug-ins.adoc[Logger Plug-ins]
+* link:4-encoding_and_decoding.adoc[Encoding and Decoding]
+* link:5-mapping_ttcn3_data_types_to_c+\+_constructs.adoc[Mapping TTCN–3 Data Types to {cpp} Constructs]
+* link:6-tips_&_troubleshooting.adoc[Tips & Troubleshooting]
+////
+* link:13-references.adoc[References]
+* link:14-abbreviations.adoc[Abbreviations]
+endif::[]
+
+
+ifndef::env-github,backend-html5[]
+include::1-about_the_document.adoc[leveloffset=+1]
+////
+//include::2-ttcn-3_limitations_in_this_version.adoc[leveloffset=+1]
+//include::3-clarifications_to_the_ttcn-3_standard.adoc[leveloffset=+1]
+//include::4-ttcn3_language_extensions.adoc[leveloffset=+1]
+//include::5-supported_asn1_constructs_and_limitations.adoc[leveloffset=+1]
+//include::6-compiling_ttcn3_and_asn1_modules.adoc[leveloffset=+1]
+//include::7-the_run-time_configuration_file.adoc[leveloffset=+1]
+//include::8-the_titan_project_descriptor_file.adoc[leveloffset=+1]
+//include::9-xsd_to_ttcn-3_converter.adoc[leveloffset=+1]
+//include::10-code_coverage_of_ttcn-3_modules.adoc[leveloffset=+1]
+//include::11-the_ttcn-3_debugger.adoc[leveloffset=+1]
+//include::12-tips_&_troubleshooting.adoc[leveloffset=+1]
+//include::2-test_ports.adoc[leveloffset=+1]
+//include::3-logger_plug-ins.adoc[leveloffset=+1]
+//include::4-encoding_and_decoding.adoc[leveloffset=+1]
+//include::5-mapping_ttcn3_data_types_to_c++_constructs.adoc[leveloffset=+1]
+//include::6-tips_&_troubleshooting.adoc[leveloffset=+1]
+////
+include::13-references.adoc[leveloffset=+1]
+include::14-abbreviations.adoc[leveloffset=+1]
+endif::[]
diff --git a/usrguide/java_referenceguide/images/dualfaced.png b/usrguide/java_referenceguide/images/dualfaced.png
new file mode 100644
index 0000000000000000000000000000000000000000..739104871c6c56d1991f1fecd23ecc5106a2fa22
Binary files /dev/null and b/usrguide/java_referenceguide/images/dualfaced.png differ
diff --git a/usrguide/java_referenceguide/images/projecthierarchy_graph.png b/usrguide/java_referenceguide/images/projecthierarchy_graph.png
new file mode 100644
index 0000000000000000000000000000000000000000..6edd52c34753187eef29cfa8a1c258abe0352656
Binary files /dev/null and b/usrguide/java_referenceguide/images/projecthierarchy_graph.png differ
diff --git a/usrguide/java_referenceguide/images/struct.png b/usrguide/java_referenceguide/images/struct.png
new file mode 100644
index 0000000000000000000000000000000000000000..73199b67d39b10c1c5843b22053e7aadfd292ba6
Binary files /dev/null and b/usrguide/java_referenceguide/images/struct.png differ
diff --git a/usrguide/java_referenceguide/images/titan_logo.png b/usrguide/java_referenceguide/images/titan_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..f1e7539e4fbfe31344787adaff8698170bccbf71
Binary files /dev/null and b/usrguide/java_referenceguide/images/titan_logo.png differ