46.8. CTI System Resource

The majority of the parameters which are present in CTI Routing can be defined as default value (Sys): the default value will be the one setup by the CTISYS resource.

Use the following command to display the parameters of the resource; the d p ctisys ? command shows the meaning of parameters.

[14:59:02] ABILIS_CPX:d p ctisys

RES:CtiSys --------------------------------------------------------------------
Run    DESCR:CTI_System_general_properties
       - Router ---------------------------------------------------------------
       ROUTING:PREFIX      max-c-tofrom-cisda:50    au-law:A-LAW    NPOO-CT:NO 
       OUTDIAL-TONE:NO     OUTDIAL-DIGIT:0
       MAIL-FROM:AUTO (ctisys@abilis_cpx_)
       MAIL-BODY:STANDARD  MAIL-FILTER-INTERVAL:3
       NAT-PREFIX:0        INT-PREFIX:00      COUNTRY-CODE:39      
       TON-TO-PREFIX:YES  
       OPC-QUEUES-PREFIX:
       MOH:YES
       MOH-DIR:C:\APP\CTI\MOH\
       MOH-MSG:*
       - Last Calling number Service ------------------------------------------
       LCST:6      lcs-dir:C:\APP\CTI\LCS\
       - CallTry --------------------------------------------------------------
       CALLTRY-TOUT:60    CALLTRY-NRTY:15      
       - Address Book ---------------------------------------------------------
       ADDRBOOK-SOURCE:ABILIS-ADDRBOOK     ADDRBOOK-SYNC:NO
       addrbook-dir:C:\APP\CTI\ADDRBOOK\
       ADDRBOOK-PUB-MAX:2000               ADDRBOOK-PUB-PROTECTED:NO
       ADDRBOOK-PRIV-MAX:100                
       - EEC ------------------------------------------------------------------
       TAIL:128      NLP:YES             CNM:NORMAL             AEC:NO
       TAIL-BASE:0   NLP-A:1             VQE-TONE-DISABLER:YES  AEC-TAIL:1024
       HLC:NO        NLP-B:0             VQE-ACT-DELAY:300      AEC-ERL-DFT:0
       HLC-THR:-10                       ERL-DFT:-6
       - Dsp firmwares and configurations for C6412 on QPRIX, PB22X and PB44X -
       CARD-TYPE: (AC482  EEC) | fw:      hdlc-b: g.729a: ec:    ac:
       ------------------------+------------------------------------
       1           no     no   | D64V          8     YES  32    (10)
       2           no     yes  | D64V          8     YES   0    (18)
       3           yes    no   | D64A         32
       4           yes    yes  | D64A         32
       ------------------------+------------------------------------
       - Dsp firmwares for AC48x ----------------------------------------------
       dsp1-fw:D1C4F3            dsp2-fw:D2C4F3         
       dsp1-coderset:NORMAL      dsp2e-fw:D2C4F6
       - Software Audio Compressors configuration (SWAC) ----------------------
       swac-enabled:NO         
       - Audio compressors defaults -------------------------------------------
       IN-GAIN:0       OUT-GAIN:0      SIG-GAIN:0        DJ:80      MJ:250
       DTMF-HIGH:-4    DTMF-LOW:-6     DTMF:OUTBAND
       FM-RELAY:YES    FM-LEVEL:-9     ECM:YES           FMDJ:200   FMMJ:400
       SC:YES          SID-GEN:NO      SID-USE:NO
       AT:NO           AT-CODE:C       AT-DURATION:100
       CODERS:G.711,Spirit,G.729A,Transp
       HIPASS-FLT:YES  POST-FLT:YES    TRANSCODING:MCD-FIRST
       - POTS/VPOTS defaults --------------------------------------------------
       NUM-LENGTH:2   BC:Speech
       - POTS defaults --------------------------------------------------------
       CLIP:YES       CLIP-STD:ETSI     CLIP-TAS:RP            CLIP-LEVEL:600
       SENSING:YES    ABF:NO   HPF:YES  DEBOUNCE:16            MIN-FLASH:50
       COUNTRY:IT (SL-IT.BIN)                                  MAX-FLASH:200
       POTS-IN-GAIN-ADJ:COUNTRY         POTS-OUT-GAIN-ADJ:COUNTRY  
       POTS-AT:NO     POTS-AT-CODE:C    POTS-AT-DURATION:100   POTS-AT-GAIN:0
       POTS-DT:NO     POTS-DT-CODE:D    POTS-DT-DURATION:100   
       - VPOTS defaults -------------------------------------------------------
       vpots-udp-locport:28282  VPOTS-IP-PERMIT:*
       VPOTS-SP:64000
       - CELL (GSM/UMTS) defaults ---------------------------------------------
       CELL-GAIN-IN:0               CELL-GAIN-OUT:0             pdn-rxbuf:30
       CELL-CODEC-GAIN-IN:0         CELL-CODEC-GAIN-OUT:0         
       - HDLC -----------------------------------------------------------------
       dmaframe:2100   bdframe:2100 bcframe:264  bvframe:264
       rxdmabuf:3      bdrxbuf:14   bcrxbuf:3    bvrxbuf:3
       txdmabuf:2      bdtxbuf:1    bctxbuf:1    bvtxbuf:3
       - Tones and ringing patterns -------------------------------------------
         - Tones -------------------+------+------+------+------+------+------+
         TONESET:ABILIS             |  T1  |  S1  |  T2  |  S2  |  T3  |  S3  |
                          ----------+------+------+------+------+------+------|
                          DIAL-xx:  |(7000)|(   0)|(   0)|(   0)|(   0)|(   0)|
                       OUTDIAL-xx:  |( 200)|( 200)|( 600)|(1000)|(   0)|(   0)|
                         ALERT-xx:  |(1000)|(4000)|(   0)|(   0)|(   0)|(   0)|
                          BUSY-xx:  |( 500)|( 500)|(   0)|(   0)|(   0)|(   0)|
                          DISC-xx:  |( 200)|( 200)|(   0)|(   0)|(   0)|(   0)|
                          HOLD-xx:  |  110 |  110 |  110 | 1500 |    0 |    0 |
                          MENU-xx:  |  110 | 2000 |    0 |    0 |    0 |    0 |
                        CW-EXT-xx:  |  200 |  200 |  200 | 7000 |    0 |    0 |
                        CW-INT-xx:  |  100 |  400 |  100 |  100 |  100 | 7000 |
                            PC-xx:  |   60 |   60 |   60 | 4000 |    0 |    0 |
         - POTS Ringing ------------+------+------+------+------+------+------+
                           EXT-xx:  | 1000 | 4000 |    0 |    0 |    0 |    0 |
                           INT-xx:  |  400 |  200 |  400 | 3000 |    0 |    0 |
                           PKC-xx:  |  500 |  500 |  500 |  500 | 1500 | 2000 |
                         CITO1-xx:  | 1500 | 1000 | 1500 | 6000 |    0 |    0 |
                         CITO2-xx:  |  500 |  500 |  500 |  500 |  500 | 6000 |
                         CITO3-xx:  |  300 |  300 |  800 |  300 |  300 | 6000 |
                                    +------+------+------+-------------+------+
       - Clock Sources for H100 cards -----------------------------------------
       CLK:ANYTE
       +----------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
       | P1:..P10:|( 32)|( 33)|( 34)|( 35)|( 36)|( 37)|( 38)|  .  |  .  |  .  |
       |P11:..P20:|  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |
       |P21:..P30:|  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |
       |P31:..P40:|  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |
       |P41:..P50:|  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |
       +----------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
       - Clock Sources for NOT-H100 cards -------------------------------------
       +------------+-------+-----+-----+-----+-----+-----+-----+-----+-----+
       | CARD:      | CLK:  | P1: | P2: | P3: | P4: | P5: | P6: | P7: | P8: |
       +------------+-------+-----+-----+-----+-----+-----+-----+-----+-----+
       | BSE-1      | ANYTE |  32 |  33 |  34 |  35 |  36 |  37 |  38 |  .  |
       +------------+-------+-----+-----+-----+-----+-----+-----+-----+-----+

These are the most frequently used parameters.

In the Router section, the parameter ROUTING (Routing Management) allows to set two kinds of CTI Routing functioning:

ROUTING

Routing management [EN-BLOC, PREFIX]

  • EN-BLOC. The CTI Router waits to receive the complete number (from the line, the PABX or other connected devices) before choosing the routing. The routing table management is easier, but the disadvantage is that, at the end of dialing, the user must press the “#” on the phone or wait a time out of (generally) 5 seconds (see parameter DIALT on CTI Ports) before the call starts.

  • PREFIX. The CTI Router verifies the rule to match at the receipt of a single digit. The configuration of the CTI Routing table is a bit more difficult and delicate, but the advantage is that the user is not required to press “#” on the phone or wait any time at the end of dialing.

MAIL-FROM

Sender of e-mail on call failure/forwarding. "SYS" or "AUTO" or a valid e-mail address.

  • SYS: the mail sender configured in CXGEN 'MAIL-SENDER' is used;

  • AUTO: a fixed value is used (e.g. ctisys@<cp-prompt>);

  • e-mail address: from 0 up to 128 ASCII printable characters. Spaces are not allowed. Case is preserved.

OUTDIAL-TONE

Enable/disable the outside dial tone generation [NO, YES]

OUTDIAL-DIGIT

Digit for outside selection ['0'..'9']

The section Last Calling number Service allows to choose two system parameters:

LCST

Last Calling number Service records timeout [NONE, 1..999 hour]

lcs-dir

Last Calling number Service Working directory path. Physical full path in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the '\' character. Max. 128 characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks (E.g.: "C:\My dir\").

The Last Calling number Service is useful if UMTS Box is installed, but it can be used with ISDN ports, CLUSTERS, as well as with SIP and IAX users.

The section CallTry allows to configure two parameters about call-try feature:

CALLTRY-TOUT

Timeout [30..600 sec]

CALLTRY-NRTY

Number of retry [1..30]

The most important parameters of EEC section are:

AEC

Acoustic Echo Canceller. When set to YES is enables for ALL the EEC channels the capability to cancel acoustic echo too. In normal telecom applications the AEC is not needed.

TAIL-BASE

The EEC can cancel echo in the range 0..128 msec. By specifying here a value greater than 0 the range is value+128ms. For example if TAIL-BASE is 256, the EEC is able to cancel echo between 256 and 384 msec.

[Tip]Tip

Use the following command to display the availability of Extended Echo Canceler (EEC):

[14:25:58] ABILIS_CPX:d d ctieec

-------------------------------------------------------------------------------
EEC  Card      Chan State     CurDelay  MaxDelay  Tail TailBase CurERL  MaxERL
-------------------------------------------------------------------------------
  0  QPRI-1    0    FREE      
  1  QPRI-1    1    FREE      
  2  QPRI-1    2    FREE      
  3  QPRI-1    3    FREE      
  4  QPRI-1    4    FREE      
  5  QPRI-1    5    FREE      
  6  QPRI-1    6    FREE      
  7  QPRI-1    7    FREE      
  8  QPRI-1    8    FREE      
  9  QPRI-1    9    FREE      
 10  QPRI-1    10   FREE      
 11  QPRI-1    11   FREE      
 12  QPRI-1    12   FREE      
 13  QPRI-1    13   FREE      
 14  QPRI-1    14   FREE      
 15  QPRI-1    15   FREE      
 16  QPRI-1    16   FREE      
 17  QPRI-1    17   FREE      
 18  QPRI-1    18   FREE      
 19  QPRI-1    19   FREE      
 20  QPRI-1    20   FREE      
 21  QPRI-1    21   FREE      
 22  QPRI-1    22   FREE      
 23  QPRI-1    23   FREE      
 24  QPRI-1    24   FREE      
 25  QPRI-1    25   FREE      
 26  QPRI-1    26   FREE      
 27  QPRI-1    27   FREE      
 28  QPRI-1    28   FREE      
 29  QPRI-1    29   FREE      
 30  QPRI-1    30   FREE      
 31  QPRI-1    31   FREE      
 32  QPRI-1    32   FREE      
 33  QPRI-1    33   FREE      
 34  QPRI-1    34   FREE      
 35  QPRI-1    35   FREE      
 36  QPRI-1    36   FREE      
 37  QPRI-1    37   FREE      
 38  QPRI-1    38   FREE      
 39  QPRI-1    39   FREE      
 40  QPRI-1    40   FREE      
 41  QPRI-1    41   FREE      
 42  QPRI-1    42   FREE      
 43  QPRI-1    43   FREE      
 44  QPRI-1    44   FREE      
 45  QPRI-1    45   FREE      
 46  QPRI-1    46   FREE      
 47  QPRI-1    47   FREE      
 48  QPRI-1    48   FREE      
 49  QPRI-1    49   FREE      
 50  QPRI-1    50   FREE      
 51  QPRI-1    51   FREE      
 52  QPRI-1    52   FREE      
 53  QPRI-1    53   FREE      
 54  QPRI-1    54   FREE      
 55  QPRI-1    55   FREE      
 56  QPRI-1    56   FREE      
 57  QPRI-1    57   FREE      
 58  QPRI-1    58   FREE      
 59  QPRI-1    59   FREE      
 60  QPRI-1    60   FREE      
 61  QPRI-1    61   FREE      
 62  QPRI-1    62   FREE      
 63  QPRI-1    63   FREE

The output of the above command is the following if Abilis is equipped with mixed ECC cards and non-ECC cards:

[14:33:25] ABILIS_CPX:d d ctieec

-------------------------------------------------------------------------------
EEC  Card      Chan State     CurDelay  MaxDelay  Tail TailBase CurERL  MaxERL
-------------------------------------------------------------------------------
                                *** No EECs ***

The section named Dsp firmwares and configurations for C6412 on QPRIX and PB44X allows to choose some parameters of the embedded vocoders.

TRANSPARENT, G711 and G729a vocoders are available as embedded vocoders through QPRIX and PB44X. The advantage is there's no need of additional DSP. The most important characteristics and limitations are:

The choice of vocoders and echo canceller tail defines the number of available channels (ac). This number is automatically computed by Abilis once the type of vocoder and the echo canceller tail are set.

On the left side of the section there is the card type, this is required because the QPRIX and PB44X can be manufactured in 4 main types. On the right side there are 3 parameters to configure:

The ac value is automatically computed and shows the number of available voice channels (in the above example there are 18 channels for card type 2). Use the command s p ctisys card-type:2 g.729a:no to disable g729a support for card type 2. The number of available channels (ac) is automatically updated to 64.

[17:12:34] ABILIS_CPX:_d p ctisys dsp

RES:CtiSys --------------------------------------------------------------------
Run    DESCR:CTI_System_general_properties
       - Dsp firmwares and configurations for C6412 on QPRIX, PB22X and PB44X -
       CARD-TYPE: (AC482  EEC) | fw:      hdlc-b: g.729a: ec:    ac:
       ------------------------+------------------------------------
       1           no     no   | D64V          8     YES  32    (10)
       2           no     yes  | D64V          8     YES   0    (18)
       3           yes    no   | D64A         32
       4           yes    yes  | D64A         32
       ------------------------+------------------------------------
       - Dsp firmwares for AC48x ----------------------------------------------
       dsp1-fw:D1C4F3            dsp2-fw:D2C4F3         
       dsp1-coderset:NORMAL      dsp2e-fw:D2C4F6

Into Audio compressors defaults section there are the default values used in the system profile (Sys).

When a compressed call between two Abilis is setup, the coder use must be “negotiated”: the available coders set is defined in CODERS field. The order of the list items defines also the order of scan precessing.

CODERS:G.711,G.726,G.727,GSM6.10,Spirit,G.723.1,G.729A,Transp

In this section there are other interesting and very important parameters:

[Tip]Tip

As is well known, Internet lines are affected from latency and time arrival variation of frames caused by network congestion, timing drift, or route changes (this is the definition of jitter). When Internet lines are used for the VoIp application, it's fundamental to set the properly CTISYS parameter to obtain good results and good quality communication.

The jitter buffer is managed by DFT-JBUF and MAX-J BUF parameters. Too low values can cause chopped voice (sensation of metallic sound) during emptying of jitter-buffer. Too high values can modify the voice tone and introduce a perceptible delay of voice (also echo can be noticed). For a good optimization evaluating the line in use is needed.

Generally, on lines with a low time arrival variation of the frames, good values can be: DFT-JBUF:80 and MAX-JBUF:250.

In the POTS defaults section there are general parameters of CTI POTS Ports. The most important are:

Through CELL section, the administrator can configure some system parameter for UMTS BOX devices:

In the Tones and ringing patterns section, the TONESET parameter allows to choose the dial tone and other tones (i.e. alerting tone, busy tone…). By default, it is set to ABILIS and it means that the dial tone is a continuous one, but others are available: ITALY (simulates the Italian Telecom dial tone) or USERDEF (allows the user to customize the tones). The tones change by configuring the sequence and the duration of TONEs and SILENCEs (T1, S1, T2...).

       - Tones and ringing patterns -------------------------------------------
         - Tones -------------------+------+------+------+------+------+------+
         TONESET:ABILIS             |  T1  |  S1  |  T2  |  S2  |  T3  |  S3  |
                          ----------+------+------+------+------+------+------|
                          DIAL-xx:  |(7000)|(   0)|(   0)|(   0)|(   0)|(   0)|
                      OUT-DIAL-xx:  |( 200)|( 200)|( 600)|(1000)|(   0)|(   0)|
                         ALERT-xx:  |(1000)|(4000)|(   0)|(   0)|(   0)|(   0)|
                          BUSY-xx:  |( 500)|( 500)|(   0)|(   0)|(   0)|(   0)|
                          DISC-xx:  |( 200)|( 200)|(   0)|(   0)|(   0)|(   0)|
                          HOLD-xx:  |  110 |  110 |  110 | 1500 |    0 |    0 |
                          MENU-xx:  |  110 | 2000 |    0 |    0 |    0 |    0 |
                        CW-EXT-xx:  |  200 |  200 |  200 | 7000 |    0 |    0 |
                        CW-INT-xx:  |  100 |  400 |  100 |  100 |  100 | 7000 |
                            PC-xx:  |   60 |   60 |   60 | 4000 |    0 |    0 |
         - POTS Ringing ------------+------+------+------+------+------+------+
                           EXT-xx:  | 1000 | 4000 |    0 |    0 |    0 |    0 |
                           INT-xx:  |  400 |  200 |  400 | 3000 |    0 |    0 |
                           PKC-xx:  |  500 |  500 |  500 |  500 | 1500 | 2000 |
                         CITO1-xx:  | 1500 | 1000 | 1500 | 6000 |    0 |    0 |
                         CITO2-xx:  |  500 |  500 |  500 |  500 |  500 | 6000 |
                         CITO3-xx:  |  300 |  300 |  800 |  300 |  300 | 6000 |
                                    +------+------+------+-------------+------+

Into Clock sources section it is possible to select where the port(s) take the ISDN clock signal. These are the available values:

Ctisys parameters are distributed to all the routings, but on each routing they can be manually changed.

[15:28:36] ABILIS_CPX:d ctire pr:4

Last change: 16/06/2015 15:02:45 CET

-------------------------------------------------------------------------------
PR:4   DESCR:
   ACT:YES  EDT:NO   BCI:VOICE                     BCO:*        EEC:NO
   NEXT:NO           POI:G2    SR:#        GI:#    OUT:Abilis2
   LAST:ANY          CDI:*                         CDO:*
   T301:Dft          CGI:*                         CGO:*
   UDT:NO            SDI:*                         SDO:*
   LCS:NO            SGI:*                         SGO:*
   LCST:Sys          RGI:*                         RGO:*
   IG:Sys       OG:Sys      SG:Sys      DL:Sys       DH:Sys
   FMRLY:Sys    FAXSP:AUTO  MODSP:AUTO  FMLVL:Sys    FMDJ:Sys   FMMJ:Sys
   SP:6400      SC:Sys      DJ:Sys      MJ:Sys                  ECM:SYS
   CODERS:Sys
   SPOUT:*      SCOUT:*     DJOUT:*     MJOUT:*     
   CODERSOUT:*
   TI1:ALL,00:00-23:59                TI2:#  TI3:#  TI4:#  TI5:#