Clarinet QSIG-GFT User Program

The Clarinet QSIG-GFT User program allows to simulate a QSIG Transit Network.

Functions of the program

The QSIG-GFT program is provided as a template delivered in the Clarinet Run-time Package. It supports the following functions:

  • Settings of QSIG emulator parameters.
  • Running the commands to the QSIG emulator.

Installation of QSIG-GFT program

The QSIG-GFT  set of files is automatically copied to \clatools by the Clarinet Run-time install procedure (version greater than 10.1).

Importing a template of QSIG-GFT

The Clarinet Run-time package includes factory-designed templates  for QSIG-GFT User Simulation (qsig_gft_user_e1.acp) and QSIG-GFT Network simulation (qsig_gft_net_e1.acp).

Selecting one of these templates is accessible by the 'Profile/New' command and is located in the QSIG sub-tree,  which creates a copy of the set of files.

The QSIG-GFT files are copied in the current directory:

  • qsig_gft.exe: the executable user-program file
  • qsig_gft configuration: Shortcut to qsig_gft.exe to edit parameters
  • gft_readme.txt: basic information
  • qsig_gft_net_e1.acp or qsig_gft_user_e1.acp

Setting GFT-Emulator parameters

The shortcut 'qsig_gft configuration' has the default directory 'Cladata' setup in the 'Start in' field. It should be manually change if working in another directory.

The shortcut provides access to the  to the edition of the GFT-emulator parameters.

The qsig_gft configuration shortcut launches from Windows, the edition of QSIG_GFT emulator parameters. By default the contents is empty.

Before launching the profile, the user has to define the messages used for:

  • Call independent Connection oriented service
  • Connectionless transport service
  • Reply to a incoming PDU 

The Call Independent Connection-oriented service allows to define the messages which are transmitted by manual command to the GFT panel when executing the profile

The reply configuration allows the user to define the ASN1 fields included in the reply PDU when a specific operation value is checked in the Received Invoke PDU.

The messages editor allows to enter types of fields:

  • Addresses and Causes values
  • Data fields of FACILITY IEs encoded in ASN1. The 'Edit' button allows to launch the BER-Encoder tool to create/modify the ASN1 content of Facility IE fields.

These ASN1 contents have to be saved in fields defined in Clarinet ASN1 files (.acb extension) in the current directory 

Creating the ASN1 Data fields of the QSIG-GFT messages

 

 

The Clarinet BER-encoder tool can be initialized by an import of  ASN1 Templates. 
A set of templates corresponding to QSIG-GFT services is provided in the QSIG template directory.
 

The ASN1 content of the template can be modified by using the ASN1 tools
At the end of the edition the new ASN1 content has to be saved to a new acb file located in the current directory. 
All the mandatory fields displayed with (M) have to be filled before launching the execution of the profile.

At the end of edition the content of the messages used by the executable is automatically saved to a file (located in the current directory) having the same basename than the executable and .ini extension (default  qsig_gft.ini).

This file includes only the references of ASN1 files (.acb extension) 

Setting the QSIG-GFT profiles

  The qsig_gft_net_e1 or qsig_gft_user_e1 profiles use both the user-program mode.

Setting QSIG-Emulator parameters

The qsig_gft_net_e1 or qsig_gft_user_e1 profiles use the parameters defined in Q921 and QSIG panels.

The Field 'Initialize GFT-Control' in QSIG basic emulator must be selected to get the values defined in the QSIG-GFT emulator configuration (saved in the file qsig_gft.ini)

Running the User-Program from the Clarinet profile.

The additional window launched by the profile executing a User-Program allows to control the QSIG_GFT emulator.
The Content of the Facility IE consists of two ASN1 fields:
  • the header  for Network Facility Extensions
  • the ROSE field corresponding to the ASN1 sting edited with the BER encoder.

The header is automatically added by the Clarinet QSIG-DFT Emulator.

 Facility IE including a QSIG-Rose-ServiceAvailable-Invoke

Facility IE including a QSIG-Rose-CalledName-Invoke

After launching the profile, the user has to send commands for:

  • Calling independent Connexion oriented service: messages + Comm identifier value
  • Connectionless transport service: messages GF unitData request

The primitives of service used at the interface between QSIG-GFT emulator and the User-Program are displayed at the bottom of  the panel:

  • Ci: Clarinet interface number i
  • (O,n): Outgoing Comm number n
  • (I,n): Incoming Comm number n

The templates are provided to directly start running the QSIG-GFT protocol. For intensive use, the user is invited to customize the settings:

  • creating a working directory for saving the QSIG-GFT
  • changing the names: the qsig_gft.exe file uses  by default qsig_gft.ini settings. Different base names are allowed for couple (.exe,.ini) files.
The BER Encoder could be used to encode Facilities in the regular QSIG simulator. In this case the content of the IE Facility has to be copied in several steps:
  • the header  for Network Facility Extensions corresponding to QSIG-NetworkFacilityExtension.
  • the ROSE field corresponding to the QSIG-Rose-APDU
 

home     Quick start     Specifications     Connections     Features     How to?     Notes     Search     Site Map

updated:  27-Feb-04