47.6. CTI System Resource

47.6. CTI System Resource
	Chapter 47. CTI System

The majority of the parameters which are present in CTI Routing can be defined as the 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
       NAT-PREFIX:0        INT-PREFIX:00      COUNTRY-CODE:39      
       TON-TO-PREFIX:YES  
       OPC-QUEUES-PREFIX:8
       MAIL-BODY:STANDARD                     MAIL-FILTER-INTERVAL:3
       MAIL-FROM:AUTO (ctisys@abilis_cpx)
       MOH:YES                                MOH-MSG:*
       MOH-DIR:C:\APP\CTI\MOH\
       - 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:YES        swac-chans:10        SWAC-EC-ADAPT:YES
       SWAC-EC-TAIL:32         SWAC-EC-RX-HPF:YES   SWAC-EC-NLP-MODE:CNG
       SWAC-EC-TAIL-BASE:0                          SWAC-EC-NLP:YES
       SWAC-PRECEDENCE:NO
       - Audio compressors defaults -------------------------------------------
       IN-GAIN:0       OUT-GAIN:0      SIG-GAIN:0        DJ:100     MJ:250
       DTMF-HIGH:-4    DTMF-LOW:-4     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:3   BC:Speech
       - POTS defaults --------------------------------------------------------
       CLIP:EXT       CLIP-STD:ETSI     CLIP-TAS:RP            CLIP-LEVEL:600
       SENSING:YES    ABF:NO   HPF:NO   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   
       HOTEL-ALARM-CDO:#
       HOTEL-DISA-SERVICE:hotel (!)            HOTEL-DISA-USER:hotel (!)
       - 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         
       - 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 |  110 | 2000 |    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:LIST
       +----------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
       | P1:..P10:|  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |  .  |
       |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 |  31 |  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 isn't 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 aren't allowed. Case is preserved.

OUTDIAL-TONE

Enable/disable the outside dial tone generation [NO, YES]. The outdial tone is used so as to remind users to dial a prefix, or select in another way, an outside line.

OUTDIAL-DIGIT

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

MOH

Enable/disable Music on Hold service. Music on Hold refers to music played to callers while they are waiting on hold.

MOH-DIR

Music on Hold 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\"). By default: "C:\APP\CTI\MOH\".

MOH-MSG

Name of the file holding the music/message to be played.

"#" : Do not play any music/message.
"*" : Play all music/message files in alphabetic order.
From 1 up to 20 characters. Names holding spaces must be written between quotation marks (E.g.: "Dft music").

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\").

	Note
	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.

Tip

Interesting chapters:

Section 73.18, “How to configure Last Calling Service”;

Section 50.5.6, “Last Calling Service for a SIP user”.

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 Address Book section are:

ADDRBOOK-SOURCE: Select which Address Book service to use [ABILIS-ADDRBOOK, LDAP-LOCAL, LDAP-REMOTE].
ADDRBOOK-SYNC: Select which Address Book Abilis users must be entered and kept synchronized [NO, LDAP, ABILIS, ALL].
addrbook-dir: bilis Address Book 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\"). Only for ADDRBOOK-SOURCE equal to ABILIS-ADDRBOOK.
ADDRBOOK-PUB-MAX: Maximum allowed number of PUBLIC contacts in Abilis Address Book [0..10000]. Only for ADDRBOOK-SOURCE equal to ABILIS-ADDRBOOK.
ADDRBOOK-PRIV-MAX: Maximum allowed number of individual user PRIVATE contacts in Abilis Address Book [0..10000]. Only for ADDRBOOK-SOURCE equal to ABILIS-ADDRBOOK.
LDAP-SEARCH-BASE-DN: Ldap Base-DN. From 0 up to 64 Alphanumeric extended characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks (E.g.: "str1 str2"). Only for ADDRBOOK-SOURCE equal to LDAP-REMOTE.
LDAP-REM-ACCOUNT: Ldap Account. From 0 up to 16 Alphanumeric extended characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks (E.g.: "str1 str2"). Only for ADDRBOOK-SOURCE equal to LDAP-REMOTE.

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 isn't 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

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:

Echo canceller (EC) is available up to 32 ms but it can raise up to 128 ms in the version with the additional Octasic chip (EEC).
Fax relay isn't currently supported.
Mixing cards with and without additional DSPs isn't allowed, as well as mixing embedded vocoders and additional DSPs on the same card.

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:

HDLC channels (named HDLC-B);
G.729a support (named G.729a);
Echo canceller tail (named EC).

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 - Not Saved (SAVE CONF), Not Refreshed (INIT) ----------------------
       ------------------------------------------------------------------------
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      NO   0    (64)
       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

The section named Software Audio Compressors configuration (SWAC) allows to choose some parameters of the SWAC.

With SWAC is possible to use cards without DSPs and let the main x86 CPU to perform echo cancellation and voice compression.The card must be equipped with an adequate number of HDLC controllers usable for transparent data transfer. There are of course limits of the number of simultaneous channels that depends on echo canceller tail, x86 cpu power, and required residual cpu power for the other activities.

	Important
	SWAC requires separate licence.

	Note
	SWAC doesn't support FAX-MODEM RELAY.

The most important parameters of Software Audio Compressors configuration (SWAC) section are:

swac-enabled: Enable software audio compression [NO, YES].
swac-chans: Number of software audio channels [0..255]. Only for SWAC:YES.
SWAC-EC-TAIL: Software echo canceler maximal tail length [0..32 1 msec steps]. Only for SWAC:YES.
SWAC-PRECEDENCE: Sets precedence in use of SWAC channels respect to HWAC (DSP) [NO, YES]. Only for SWAC:YES.

The following command shows the available number of SWAC:

[17:12:34] ABILIS_CPX:d d ctisys

RES:CtiSys --------------------------------------------------------------------
       CTI_System_general_properties                                           
       CTIR-STATE:ENABLED     CALLS-CURRENT:0      CALLS-PEAK:1
       AC-STATE:ENABLED       AC-CURRENT:0         AC-PEAK:1
       ------------------------------------------------------------------------
       -- Number of simultaneous calls ----------------------------------------
                      | State: Alerting/Connected |        State: Any         |
       ---------------|---Current---|----Peak-----|---Current---|----Peak-----|
       TR             |           0 |           0 |           0 |           0 |
       DATA           |           0 |           0 |           0 |           0 |
       VtoCISDA       |           0 |           1 |           0 |           1 |
       CISDAtoCISDA   |           0 |           1 |           0 |           1 |
       CISDAtoV       |           0 |           1 |           0 |           1 |
       ALL            |           0 |           1 |           0 |           1 |
       ------------------------------------------------------------------------
       - AC and SWAC common available coders ----------------------------------
       -- Coder ---|-- Bit rates (kbps) --|-- Coder ---|-- Bit rates (kbps) --|
       G.711A      |64                    |G.711u      |64                    |
       G.729A      |8                     |TRANSPARENT |64                    |
       Spirit      |6.4, 7.2, 8, 8.8, 9.6 |
       ------------------------------------------------------------------------
       - SWAC and MCD limits by CPU -------------------------------------------
       MAX-SWAC-0ms:5    MAX-SWAC-8ms:4    MAX-SWAC-16ms:4    MAX-SWAC-32ms:4
       MAX-MCD-SPIRIT:5                    MAX-MCD-G729A:6
       - SWAC and MCD diagnostics ---------------------------------------------
       CUR-SWAC:0   PEAK-SWAC:0   REST-SWAC:5   MAX-SWAC:5    LIMIT-SWAC:CPU
       CUR-MCD:0    PEAK-MCD:0                  MAX-HDLC:8
       ------------------------------------------------------------------------
       - Clock Sources for H100 cards -----------------------------------------
       CLK:INT
       - Clock Sources for NOT-H100 cards -------------------------------------
       --- CARD ---|- CLK -|
       BSE-1       |  INT  |
       ------------------------------------------------------------------------

	Note
	In this example, the maximum number of SWAC is 5 and is limited by CPU.

If it's limited by number of HDLC, that supports TRANSPARENT mode, the parameter LIMIT-SWAC is HDLC.

[17:12:34] ABILIS_CPX:d d ctisys

RES:CtiSys --------------------------------------------------------------------
       CTI_System_general_properties                                           
       CTIR-STATE:ENABLED     CALLS-CURRENT:2      CALLS-PEAK:4
       AC-STATE:ENABLED       AC-CURRENT:2         AC-PEAK:4
       ------------------------------------------------------------------------
       -- Number of simultaneous calls ----------------------------------------
                      | State: Alerting/Connected |        State: Any         |
       ---------------|---Current---|----Peak-----|---Current---|----Peak-----|
       TR             |           0 |           2 |           0 |           2 |
       DATA           |           0 |           0 |           0 |           0 |
       VtoCISDA       |           1 |           3 |           1 |           3 |
       CISDAtoCISDA   |           0 |           3 |           0 |           3 |
       CISDAtoV       |           1 |           2 |           1 |           3 |
       ALL            |           2 |           4 |           2 |           4 |
       ------------------------------------------------------------------------
       - AC and SWAC common available coders ----------------------------------
       -- Coder ---|-- Bit rates (kbps) --|-- Coder ---|-- Bit rates (kbps) --|
       G.711A      |64                    |G.711u      |64                    |
       G.729A      |8                     |TRANSPARENT |64                    |
       Spirit      |6.4, 7.2, 8, 8.8, 9.6 |
       ------------------------------------------------------------------------
       - SWAC and MCD limits by CPU -------------------------------------------
       MAX-SWAC-0ms:28   MAX-SWAC-8ms:24   MAX-SWAC-16ms:22   MAX-SWAC-32ms:19
       MAX-MCD-SPIRIT:28                   MAX-MCD-G729A:34
       - SWAC and MCD diagnostics ---------------------------------------------
       CUR-SWAC:2   PEAK-SWAC:5   REST-SWAC:6   MAX-SWAC:8    LIMIT-SWAC:HDLC
       CUR-MCD:0    PEAK-MCD:2                  MAX-HDLC:8
       ------------------------------------------------------------------------
       - Clock Sources for H100 cards -----------------------------------------
       CLK:38 
       - Clock Sources for NOT-H100 cards -------------------------------------
                          *** No NOT-H100 cards running ***

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:

SC

Silence compression [NO, YES]. Enable or disable the compression of the “silence” during compressed calls for bandwidth use reduction.

FM-RELAY

Fax/Data relay [NO, YES]. Enable or disable the Fax Relay management. The Fax/Data relay is supported only by physical Audio Compressors.

	Important
	To use the transcoding by MCD or SWAC is necessary to set the `FM-RELAY`:`NO`.

DJ

Default jitter buffer size [0..1000 ms]. Set the default compensating time of voice frames arrival variation (very important on WAN realized on Internet connections).

MJ

Maximum jitter buffer size [0..1000 ms]. Sets the maximum compensating time of voice frames arrival variation (very important on WAN realized on Internet connections).

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 DJ and MJ 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: DJ:80 and MJ:250.

TRANSCODING

Choose transcoding performed by CPU (MCD) or by audio compressors (AC) [MCD-FIRST, AC-FIRST, MCD-ONLY, AC-ONLY].

	Important
	To use the transcoding by MCD is necessary to set the `FM-RELAY`:`NO`.

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

NUM-LENGTH

Number of digits required in 'NUM' for POTS/VPOTS [1..20].

	Tip
	Interesting chapter: Section 76.4.3, “How can I change the POTS/VPOTS number length?”.

BC

Bearer capability in outgoing calls [Speech, 3.1khz].

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

CLIP: Caller Identification Presentation [NO: clip disabled, YES: clip enabled, EXT: the display of the phone will show the address book name, if is supported from the phone].
SENSING: Measure electrical parameters currently present at the analogue interface [NO, YES].
HOTEL-ALARM-CDO: Number called by DISA callback when HOTEL ALARM event takes place. "#" or up to 20 digits ['0'..'9'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes.
HOTEL-DISA-SERVICE: Name of an existing CtiDisa service for DISA CallBack. "#" or up to 16 Alphanumeric extended characters. Case is preserved. If the service is not configured, the "(!)" mark is displayed beside the name.
HOTEL-DISA-USER: Name of an existing CtiDisa user for DISA CallBack. "#" or up to 16 Alphanumeric extended characters. Case is preserved. If the user is not configured, the "(!)" mark is displayed beside the name.

In the VPOTS defaults section there are general parameters of CTI VPOTS Ports (PCphone) . The most important are:

vpots-udp-locport: Local UDP port for PCphone [1..65535]. By default is 28282.
VPOTS-IP-PERMIT: Allowed IP addresses. One or two IP addresses in the range [1-126.x.x.x, 127.0.0.1, 128-223.x.x.x] separated by ':' (colon) or the name of an IP/IR/RU/MR list between single quotes or "*" or "#".
VPOTS-SP: Maximum permitted coder bit rate [64000, 8000].

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

CELL-GAIN-IN: Input gain adjustment [MUTE, -84..+6 dB].
CELL-GAIN-OUT: Output gain adjustment [MUTE, -84..+6 dB].
CELL-CODEC-GAIN-IN: Audio-codec input gain adjustment [MUTE, -126..+32 dB].
CELL-CODEC-GAIN-OUT: Audio-codec output gain adjustment [MUTE, -59..+5 dB].
pdn-rxbuf: Size, in kbytes, of the PDN receive buffer [10..255].

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's 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's possible to select where the port(s) take the ISDN clock signal. These are the available values:

INT: Clock signal is generated by Abilis.
ANYTE: Clock signal is taken from one of the TE ISDN ports that are present in the configuration; scanning from left to right.
LIST: Clock signal is taken from one of the ports manually inserted into P1...P50 fields; scanning from left to right.

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:#


47.5. CTI Router Overview		47.7. Redirecting