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 .  

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-GFT Emulator. Only the ROSE field has to be edited in the .acb file by using the BER Encoder for QSIG-GFT

Creating the ASN1 Data fields of the QSIG-GFT messages

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-GFT 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 Connection 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.
 

[Home]   [Products]  [Help Notes]  [Technical notes]  [Search]  [Site map]  [PDF Library]  [Contact]

Last modification: 27/02/04