46.6. CTI Router

The CTI Router is a smart telephone exchange. As a simplified description we may say that CTI Router processes an incoming call in following steps: it receives the call request, it finds an appropriate routing, it performs the outgoing call.

To manage the CTI Router the following commands are used:

The d ctir ? command shows all available parameters.

The following table explanes the meaning of those special values.

Table 46.2. Special characters and values available in CTI routing table

ValueDescriptionExamples
*can be used to replace a sequence of digits or a part of it (at the beginning or the end of a sequence)CDI:*, CDI:2345*, CDI:*456
*identifies all Ctip ports ISDN, POTS, VPOTS, CELLPOI:*
*identifies all clustersSR:*
**identify all Ctip ports, including special ones. Whole set is ISDN, POTS, VPOTS, CELL, Iax, Sip, Disa, Vo, Vm, Vr, Mix, Sl.POI:**
?in a sequence of numbers it can be used to mean “any digitCDI:4??, CDI:???234, CDI:34??67, CDI:123?
#means “NONECGO:#
##forces disallowCGO:##
#!forces allowCGO:#!
n, nn, nnnidentify Cti ports ISDN, POTS, VPOTS, CELL.OUT:31
Gn, Gnnidentify Cti groupsGI:G1
G*identifies "all groups"GI:G*
PBXCTI POTS Port groupOUT:PBX
IaxIAX connectionOUT:Iax
SipSIP connectionOUT:Sip
DisaDISA connectionOUT:Disa
VoVirtual Office connectionOUT:Vo
VmVoice Mail connectionOUT:Vm
VrVoice Recorder connectionOUT:Vr
MixVoice Mixer connectionOUT:Mix
SLDATA connectionOUT:SL
'list'specification of an element list, type IN (list of ISDN numbers) or RU (Rule), or MR (Master Rule)CDI:'node', CDI:'ToAbilis2'
'list'identifies a list of clusters (list type EC)SR:'clusterlist'
'macro'macro functionsCDO:'CDI.S2'
<AUTO-I> , <AUTO-O>special value of OUT fieldOUT:<AUTO-I> , OUT:<AUTO-O>

[Tip]Tip

The characters * and ? can be combined, example: “*2??35?” or “15??74*”.

46.6.1. Display CTI Routing Table (D CTIR)

It shows the CTI routings table in a short format. If priority is omitted, the command shows all routings.

[12:06:58] ABILIS_CPX:d ctir

Last change: 16/06/2015 09:13:29 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  #    Abilis2  #   101       *                    *                   
    NO           ANY         NO   Dft  *                    *                   
    6400   Sys   *     *     Sys  Sys  *                    *                   
--------------------------------------------------------------------------------

Below the meaning of the most important parameters:

BCI

Bearer capability input [TR, DATA, VOICE, Speech, 3.1Khz, UDI, RDI, UDI-TA, Video]. The values Speech, UDI, RDI, 3.1Khz, UDI-TA, Video are the regular ITU values, while TR, DATA, VOICE are a shortcuts for combinations:

  • Speech: The bearer capability BC speech is used for an ordinary voice call and the network may route the call over analogue circuits and may use voice compression, echo cancellation and echo suppresion for instance.

  • 3.1Khz: The bearer capability BC 3.1 kHz Audio is used for voice grade information, i.e. non voice calls but where the information is coded as analogue signals within the 300 Hz to 3.1 kHz frequency band. This is typically used for modems, e.g. ordinary data or telefax.

  • UDI: The bearer capability 64 kbit Unrestricted Digital Information (UDI.) is used for calls where the information is digitally coded, i.e. data of some description. This type of connection is often referred to as Clear Channel. It can for instance be a Video applic application or a Group four fax.

  • RDI: The bearer capability 64 kbit Restricted Digital Information (RDI) is digitally coded information at 56 kbit/s. The reason for this bearer capability is some American 1.5 Mbit CAS networks. This BC is used in the same way as the BC 64 kbit Unrestricted. Some networks charges less for this type of call than for a full 64 bit unrestricted. This BC is only supported in US ISDN protocols, thus making international calls with bearer capability impossible.

  • TR = any value

  • DATA = UDI, RDI

  • VOICE = Speech, 3.1 Khz

    [Warning]Warning

    Please do not confuse TYPE:TR (TDM transparent connection) with BCI:TR (any BC value accepted)

POI

Input port/group [#, *, **, G*, G0..G32, PBX, 1..600, Sl, Iax, Sip, Disa, Vo], where:

  • * = Any CTI port ISDN/POTS/VPOTS/CELL

  • ** = Any CTI port, including Iax, Sip, Disa, Vo

SR

Input cluster/group [#, *, G*, G0..G32, cluster name or EC/RU/MR list name between single quote]. The cluster name must correspond to an existing CTI cluster. The list name must correspond to an existing EC/RU/MR list.

GI

Input group [#, G*, G0..G32]

OUT

Output group/port/cluster [#, G0..G32, PBX, 1..600, Sl, Iax, Sip Disa, Vo, Vm, Mix, Sl, <AUTO-I>, <AUTO-O>. The cluster name must correspond to an existing CTI cluster.

  • <AUTO-I> : by specifying this value in DS, the routing will be matched according to the standard rules. The destination cluster will be chosen by comparing the field CDI with the NUMs set in each cluster. When the match is found, the correspondent cluster will be the real destination of the call.

  • <AUTO-O> : by specifying this value in DS, the routing will be matched according to the standard rules. The destination cluster will be chosen by comparing the field CDO with the NUMs set in each cluster. When the match is found, the correspondent cluster will be the real destination of the call.

CDI

Input called address [0..9, *, #, ?, 'list'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes, or [##, $]. (E.g.: 123, 123*, 12?, 12?*, *, #, ##, $, 'listname', 123'listname') See HELP ISDN ATTRIBUTES for details on attributes. See HELP SPECIAL VALUES for details on meaning of special values.

CDO

Output called address [0..9, *, #, 'macro'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes. (E.g.: 123, *, #, 123'cdi', 'cdi'123'cgi.s5', 'sdi', ''listname'', ''listname.cd'', ''listname.cg'.s2', ''listname'.s5') See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

CGI

Input calling address [0..9, *, #, ?, 'list'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or PI [a, r, m, q] and/or SI [y, v, w, z, j] attributes, or [##, $]. (E.g.: 123, 123*, 12?, 12?*, *, #, ##, $, 'listname', 123'listname') See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

CGO

Output calling address [0..9, *, #, 'macro'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or PI [a, r, m, q] and/or SI [y, v, w, z] attributes. (E.g.: 123, *, #, 123'cdi', 'cdi'123'cgi.s5', 'sdi', ''listname'', ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', 12''listname''34) See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

[Note]Note

The values of parameters CDI, CDO, CGI, CGO, can be optionally preceeded by TON (Type Of Number). TON can have the following values:

Table 46.3. Type Of Number

uUnknown
iInternational number
nNational number
o(Operator network) Network specific number
sSubscriber number
c(Coded) Abbreviated number
hAlphanumeric (GSM/UMTS only)


SDI

Input called sub-address [AlphaNumExt, *, ?, #, ##, $, 'list']. (E.g.: ho11, me1*, ho??12?, ho?12?*, *, #, 'listname', AA'listname') See HELP ISDN VALUES for details on meaning of special values.

SDO

Output called sub-address [AlphaNumExt, *, #, 'macro']. (E.g.: home123, *, #, home123'sgi', 'sgi'home123'cdi.s5', 'sdi' ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', AAA''listname.cd'', AAA'sdi'BBB''listname'.s5') See HELP ISDN VALUES for details on meaning of special values.

SGI

Input calling sub-address [AlphaNumExt, *, ?, #, ##, $, 'list']. (E.g.: ho11, me1*, ho??12?, ho?12?*, *, #, 'listname', AA'listname') See HELP ISDN VALUES for details on meaning of special values.

SGO

Output calling sub-address [AlphaNumExt, *, #, 'macro']. (E.g.: home123, *, #, home123'sgi', 'sgi'home123'cdi.s5', 'sdi' ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', AAA''listname.cd'', AAA'sgi'BBB''listname'.s5') See HELP ISDN VALUES for details on meaning of special values.

RGI

Input redirecting address [0..9, *, #, ?, 'list'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or PI [a, r, m, q] and/or SI [y, v, w, z, j] attributes, or [##, $]. (E.g.: 123, 123*, 12?, 12?*, *, #, ##, $, 'listname', 123'listname') See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

RGO

Output redirecting address [0..9, *, #, 'macro'], optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or PI [a, r, m, q] and/or SI [y, v, w, z] attributes. (E.g.: 123, *, #, 123'cdi', 'cdi'123'cgi.s5', 'sdi', ''listname'', ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', 12''listname''34) See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

BCO

Bearer capability output [*, Speech, 3.1Khz, UDI: Unrestricted Digital Information, RDI: Restricted Digital Information, UDI-TA:Unrestricted Digital Information with Tones/Announcement, Video]

NEXT

Alternative routing selection [N (or NO), U (or UNLIMITED), L (or LIMITED), T (or TRANSFERT), BB (or BUTBUSY)] or the name of ICAUSE/RU/MR list between single quotes (E.g.: T or BUTBUSY or 'my_causes').The admitted values are the following:

  • N (or No): in the event of failure of the routing, no procedure for seeking an alternative routing is put into effect.

  • L (or Limited): next routing is evaluated only for internal causes, i.e. those with location=0xFF (i.e. network out of service, all channels engaged, etc…);

  • U (or Unlimited): next routing is evaluated for every cause except: 0x91 (user busy) or 0x93 (no user responding, user alerted);

  • T (or Transfer): next routing is always evaluated.

  • BB (or ButBusy): next routing is evaluated for any reason except BUSY.

  • 'my_causes' the name of ICAUSE/RU/MR list.

T301

Alerting time-out [Dft, 5..180 sec.].When the time-out expires, administrator may choose to end the call or carry out a search for an alternative routing by configuring the NEXT parameter. [Dft (default): this time-out corresponds to the time-out defined by the Provider of the ISDN line or by the devices (i.e. PABX) connected to the Abilis].

LCS

Enable/disable Last Calling number Service [NO, YES]

LCST

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

TI1:..TI5

Time interval in the format "day,hh:mm-hh:mm", where 'day' can be:

  • a single day of the week [MO, TU, WE, TH, FR, SA, SU]

  • a set of days of the week (E.g.: MO+TH or TU+TH+SU)

  • a range of days of the week (E.g.: MO-WE or TH-SU)

  • a date in the format "dd/mm/yy", where

    • 'dd' can be [*, 1..31]

    • 'mm' can be [*, 1..12]

    • 'yy' can be [*, 0..99]

      (e.g. 23/12/13 or 31/12/* or 1/*/* or */8/* or 1/04/*)

  • two dates separated by '-', i.e. "d1/m1/y1-d2/m2/y2", where

    • d1' and 'd2' can be [*, 1..31]

    • 'm1' and 'm2' can be [*, 1..12]

    • 'y1' and 'y2' can be [*, 0..99]

  • "ALL"

Default values are TI1:ALL,00:00-23:59 and TI2...TI5:#: routing is valid on all days of the week (ALL) throughout the day (from 00.00 to 23.59). The value # on other TI means that the time intervals are disabled.

By specifying a priority value, the command shows the routing identified by specified priority.

[12:07:00] ABILIS_CPX:d ctir pr:2

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
2   VOICE  PBX  #        #   Abilis2   'ToAbilis2'           *                   
--------------------------------------------------------------------------------

The routings are scanned in sequence starting from the lowest priority. When a call arrives, all its parameters are compared with the rules of the table. The one which satisfies all the parameters will be matched; otherwise, the CTI Router will go on with the scan.

The command d ctire shows an extended view of the CTI routings,

[12:07:19] ABILIS_CPX:d ctire pr:2

Last change: 16/06/2015 12:23:13 CET

-------------------------------------------------------------------------------
PR:2   DESCR:
   ACT:YES  EDT:NO   BCI:VOICE                     BCO:*        EEC:NO
   NEXT:NO           POI:PBX   SR:#        GI:#    OUT:Abilis2
   LAST:ANY          CDI:'ToAbilis2'               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:#  

Meaning of the routing: if a call comes from any POTS or VPOTS (POI:PBX), the called number belongs to the list ToAbilis2 (CDI:'ToAbilis2'), routes it to the cluster Abilis2.

Viewing CTIR rules in a reduced format can be done using:

[11:19:20] ABILIS_CPX:d ctirr pr:1

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
21  VOICE  Sip  #        #   PBX       5??                  *                   
    NO           ANY         NO   Dft  *                    *                   
    64000  Sys   Sys   Sys   Sys  Sys  *                    *                   
    *      *     *     *     NO   Sys  *                    *                   
                             *         *                    *                   
    Sys    AUTO  AUTO  Sys   SYS  NO   Sys  Sys  Sys        Sys  Sys
    Sys
    G.711
--------------------------------------------------------------------------------

Meaning of the routing: if call comes from ctisip resource and the called number is made by three digits, starting with 5, the call is routed toward the special group PBX. The parameter SP is set to 64000 and the parameter CODERS is set to G.711, so only sip call using this codec will be accepted.

46.6.1.1. Display Cti Routing Table using filters

Using filters may help to search the desidered rule/s.

[15:52:50] ABILIS_CPX:_d ctire ?

D CTIR[E|R]                              Display all CTI Routings
D CTIR[E|R] filter:val [filter:val]      Display any CTI Routing matching the
                                         specified filter(s)

Allowed filters:

PR:        CTI routing priority.                                     <Optional>
           One value in the range [0..255] or a range of values 'xx-yy'
           or a list of values 'xx,yy,...' separated by ',' (comma) or
           "A" or "ALL".
DESCR:     Scan the description for the occurrence of the given      <Optional>
           substring. Case-insensitive match.
           From 0 up to 70 Alphanumeric extended characters.
           Spaces are allowed. Strings holding spaces must be written
           between quotation marks (E.g. "str1 str2").

BCI:       Bearer capability input [TR, DATA, VOICE, Speech, UDI,    <Optional>
           RDI, 3.1Khz, UDI-TA, Video]

POI:       | Input port/group [#, *, **, G*, G0..G32, PBX,           <Optional>
           | 1..600, Iax, Sip, Disa, Vo, Sl]
SR:        | Input cluster/group [#, *, G*, G0..G32, cluster name    <Optional>
           | or EC/RU/MR list name between single quote], or a string
           | preceded and/or followed by '*' (E.g.: "*mystr" or
           | "mystr*" or "*mystr*") or "*".

GI:        | Input group [#, G*, G0..G32]                            <Optional>
           | These filters are alternatives to IN.

IN:        Input group/port/cluster.                                 <Optional>
           This filter is alternative to POI, SR, GI.
           See POI, SR, GI for the range.

OUT:       Output group/port/cluster [#, G0..G32, PBX, 1..600,       <Optional>
           Iax, Sip, Disa, Vo, Vm, Mix, Sl, <AUTO-I>, <AUTO-O>,
           or a string preceded and/or followed by '*' (E.g.:
           "*mystr" or "mystr*" or "*mystr*") or "*".

CTI routing parameter(s):

DESCR:     Entry description. From 0 up to 70 Alphanumeric extended
           characters. Case is preserved. Spaces are allowed.
           Strings holding spaces must be written between quotation
           marks (E.g. "str1 str2").
           In standard format it is displayed only when not empty.
           In reduced format it is not displayed.
ACT:       Active/usable record flag [NO, YES]
           In standard/reduced format it is displayed only when equal to NO.
EDT:       Editable by HTTP users record flag [NO, YES]
           In standard/reduced format it is displayed only when equal to YES.
BCI:       Bearer capability input [TR, DATA, VOICE, Speech, 3.1Khz, UDI,
           RDI, UDI-TA, Video]
POI:       Input port/group [#, *, **, G*, G0..G32, PBX, 1..600, Sl, Iax,
           Sip, Disa, Vo], where:
           *  = Any CTI port ISDN/POTS/VPOTS/CELL;
           ** = Any CTI port, including Iax, Sip, Disa, Vo.
SR:        Input cluster/group [#, *, G*, G0..G32, cluster name or EC/RU/MR
           list name between single quote].
           The cluster name must correspond to an existing CTI cluster.
           The list name must correspond to an existing EC/RU/MR list.
GI:        Input group [#, G*, G0..G32]
OUT:       Output group/port/cluster [#, G0..G32, PBX, 1..600, Sl, Iax, Sip
           Disa, Vo, Vm, Mix, Sl, <AUTO-I>, <AUTO-O>.
           The cluster name must correspond to an existing CTI cluster.
NEXT:      Alternative routing selection [N (or NO), U (or UNLIMITED),
           L (or LIMITED), T (or TRANSFERT), BB (or BUTBUSY)] or the name
           of ICAUSE/RU/MR list between single quotes (E.g.: T or BUTBUSY
           or 'my_causes').
LAST:      Alternative routing, last failure reason for conditional match
           [ANY, BUSY, NOANS, OTHER] or the name of ICAUSE/RU/MR list between
           single quotes (E.g.: NOANS or 'my_causes').
EEC:       Extended echo canceller activation [NO, IN, OUT, BOTH]
CDI:       Input called address [0..9, *, #, ?, 'list'], optionally preceded by
           TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes,
           or [##, $].
           (E.g.: 123, 123*, 12?, 12?*, *, #, ##, $, 'listname', 123'listname')
           See HELP ISDN ATTRIBUTES for details on attributes.
           See HELP SPECIAL VALUES for details on meaning of special values.
CDO:       Output called address [0..9, *, #, 'macro'], optionally preceded by
           TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes.
           (E.g.: 123, *, #, 123'cdi', 'cdi'123'cgi.s5', 'sdi', ''listname'',
                  ''listname.cd'', ''listname.cg'.s2', ''listname'.s5')
           See HELP ISDN ATTRIBUTES for details on attributes.
           See HELP ISDN VALUES for details on meaning of special values.
CGI:       Input calling address [0..9, *, #, ?, 'list'], optionally preceded
           by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or
           PI [a, r, m, q] and/or SI [y, v, w, z, j] attributes, or [##, $].
           (E.g.: 123, 123*, 12?, 12?*, *, #, ##, $, 'listname', 123'listname')
           See HELP ISDN ATTRIBUTES for details on attributes.
           See HELP ISDN VALUES for details on meaning of special values.
CGO:       Output calling address [0..9, *, #, 'macro'], optionally preceded
           by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or
           PI [a, r, m, q] and/or SI [y, v, w, z] attributes.
           (E.g.: 123, *, #, 123'cdi', 'cdi'123'cgi.s5', 'sdi', ''listname'',
                  ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', 
                  12''listname''34)
           See HELP ISDN ATTRIBUTES for details on attributes.
           See HELP ISDN VALUES for details on meaning of special values.
SDI:       Input called sub-address [AlphaNumExt, *, ?, #, ##, $, 'list'].
           (E.g.: ho11, me1*, ho??12?, ho?12?*, *, #, 'listname', AA'listname')
           See HELP ISDN VALUES for details on meaning of special values.
SDO:       Output called sub-address [AlphaNumExt, *, #, 'macro'].
           (E.g.: home123, *, #, home123'sgi', 'sgi'home123'cdi.s5', 'sdi'
                  ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', 
                  AAA''listname.cd'', AAA'sdi'BBB''listname'.s5')
           See HELP ISDN VALUES for details on meaning of special values.
SGI:       Input calling sub-address [AlphaNumExt, *, ?, #, ##, $, 'list'].
           (E.g.: ho11, me1*, ho??12?, ho?12?*, *, #, 'listname', AA'listname')
           See HELP ISDN VALUES for details on meaning of special values.
SGO:       Output calling sub-address [AlphaNumExt, *, #, 'macro'].
           (E.g.: home123, *, #, home123'sgi', 'sgi'home123'cdi.s5', 'sdi'
                  ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', 
                  AAA''listname.cd'', AAA'sgi'BBB''listname'.s5')
           See HELP ISDN VALUES for details on meaning of special values.
RGI:       Input redirecting address [0..9, *, #, ?, 'list'], optionally
           preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p]
           and/or PI [a, r, m, q] and/or SI [y, v, w, z, j] attributes,
           or [##, $].
           (E.g.: 123, 123*, 12?, 12?*, *, #, ##, $, 'listname', 123'listname')
           See HELP ISDN ATTRIBUTES for details on attributes.
           See HELP ISDN VALUES for details on meaning of special values.
RGO:       Output redirecting address [0..9, *, #, 'macro'], optionally
           preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p]
           and/or PI [a, r, m, q] and/or SI [y, v, w, z] attributes.
           (E.g.: 123, *, #, 123'cdi', 'cdi'123'cgi.s5', 'sdi', ''listname'',
                  ''listname.cd'', ''listname.cg'.s2', ''listname'.s5', 
                  12''listname''34)
           See HELP ISDN ATTRIBUTES for details on attributes.
           See HELP ISDN VALUES for details on meaning of special values.
BCO:       Bearer capability output [*, Speech, 3.1Khz, UDI, RDI, UDI-TA,
           Video]
T301:      Alerting time-out [Dft, 5..180 sec.]
UDT:       Unconditional disconnect timer [NO, 1..9999 sec.]
LCS:       Enable/disable Last Calling number Service [NO, YES]
LCST:      Last Calling number Service records timeout [Sys, NONE, 1..999 hour]
IG:        Input gain [Sys, MUTE, -31..+31 dB]
OG:        Output gain [Sys, MUTE, -31..+31 dB]
SG:        Attenuation of DTMF or Tone signals respect to their configured
           values [Sys, -31..0 dB]
DL:        Output volume of lower DTMF tone [Sys, MUTE, -31..+3 dBm]
DH:        Output volume of higher DTMF tone [Sys, MUTE, -31..+3 dBm]
FMRLY:     Fax/Data relay [NO, YES, Sys]
FAXSP:     Fax maximum speed [AUTO or 0, 2400, 4800, 7200, 9600, 12000,
           14400 bps]
MODSP:     Modem maximum speed [AUTO or 0, 2400, 4800, 7200, 9600, 12000,
           14400 bps]
FMLVL:     Output volume of Fax/Data signal [Sys, -18..-3 dBm]
FMDJ:      Fax/Data default jitter buffer size [Sys, 0..1000 ms]
FMMJ:      Fax/Data maximum jitter buffer size [Sys, 0..1000 ms]
ECM:       Enable/disable ECM (Error Correcting Mode) for fax [NO, YES, Sys]
SP:        Voice compression bit rate [5300, 6000, 6300, 6400, 7200, 8000,
           8800, 9600, 11200, 13200, 13340, 15200, 16000, 18400, 24000,24800,
           32000, 40000, 64000 bps]
SC:        Silence compression [NO, YES, Sys]
DJ:        Default jitter buffer size [*, Sys, 0..1000 ms]
           It must be minor or equal to MJ.
MJ:        Maximum jitter buffer size [*, Sys, 0..1000 ms]
           It must be major or equal to DJ.
CODERS:    Allowed coders [* or Sys or NONE or a list of one or more coder
           values (see below)].
           The available coders are [Transp, G.711, G.726, G.727, GSM6.10,
           Spirit, G.723.1, G.729A, ILBC, SPEEX, G.711A, G.711u]. Values can be
           joined using "," operator. The position in the list defines the
           preference order. The right-most value is the one with the lowest
           preference.
SPOUT:     Maximum preferred/allowed bit rate for the audio coder on output
           side of direct transcoding [*, 5300, 6000, 6300, 6400, 7200, 8000,
           8800, 9600, 11200, 13200, 13340, 15200, 16000, 18400, 24000,
           24800, 32000, 40000, 64000 bps]
SCOUT:     Silence compression output [*, Sys, NO, YES]
DJOUT:     Default jitter buffer size output [*, Sys, 0..1000 ms]
           It must be minor or equal to MJOUT.
MJOUT:     Maximum jitter buffer size output [*, Sys, 0..1000 ms]
           It must be major or equal to DJOUT.
CODERSOUT: Preferred list of coders for THIS routing offered to called side 
           [* or Sys or NONE or *,Sys or a list of one or more coder values
           (see below) or *,list]
           The available coders are [Transp, G.711, G.726, G.727, GSM6.10,
           Spirit, G.723.1, G.729A, ILBC, SPEEX, G.711A, G.711u]. Values can be
           joined using "," operator. The position in the list defines the
           preference order. The right-most value is the one with the lowest
           preference.
TI1:..TI5: Time interval in the format "day,hh:mm-hh:mm", where 'day' can be:
           - a single day of the week [MO, TU, WE, TH, FR, SA, SU] or
           - a set of days of the week (E.g.: MO+TH or TU+TH+SU) or
           - a range of days of the week (E.g.: MO-WE or TH-SU) or
           - a date in the format "dd/mm/yy", where
             - 'dd' can be [*, 1..31]
             - 'mm' can be [*, 1..12]
             - 'yy' can be [*, 0..99]
             (e.g. 23/12/13 or 31/12/* or 1/*/* or */8/* or 1/04/*) or
           - two dates separated by '-', i.e. "d1/m1/y1-d2/m2/y2", where
             - 'd1' and 'd2' can be [*, 1..31]
             - 'm1' and 'm2' can be [*, 1..12]
             - 'y1' and 'y2' can be [*, 0..99]
             (e.g. 23/12/13-07/01/14 or 23/12/*-07/01/* or 01/*/*-5/*/*) or
           - "ALL".
           Use "#" to disable the time interval (i.e. 'no match').

The below command filters all rules whose BCI is VOICE and OUT is PBX:

[15:03:40] ABILIS_CPX:d ctir bci:voice out:pbx

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
21  VOICE  Sip  #        #   PBX       5??                  *                   
    NO           ANY         NO   Dft  *                    *                   
    64000  Sys   Sys   Sys   Sys  Sys  *                    *                   
    *      *     *     *     NO   Sys  *                    *                   
                             *         *                    *                   
    Sys    AUTO  AUTO  Sys   SYS  NO   Sys  Sys  Sys        Sys  Sys
    Sys
    G.711
-----------------------------------------------------------------------------------

46.6.1.2. RGI and RGO parameters

This two parameters has been introduced to insert the right value in the CG field for transferred calls and for centrals which doesn't comply with ISDN standard.

Assuming to have a user who calls a number on which there's a call transfer and supposing that:

  • the user's phone number is 07779660

  • the called number is 08889661

  • the call is forwarded toward number 01111

the calling number received from 01111 is the user's phone number 08889661. The number 07779660 is stored in a field called RG, according to ISDN standard.

When the transferred call reaches centrals not complying to ISDN standard, a trick can be used: Abilis can store the number of the initial caller (07779660) in the CG field, while the number which trasfers calls is stored in the RG field.

A call originated by a call transfer may be identified because RG field is not empty, while a normal call has RG field empty. This is used to create special routings which are effective only for call transfers.

Use the following values to intercept normal calls:

RGI:##Missing information element
RGI:#Missing or Empty information element

Set the RGI parameter to a specific value to intercept only calls originated by call transfers.

Setting RGI:*, the rule intercepts every kind of call (tranferred or not). The following table shows the range of RGI values:

[14:43:43] ABILIS_CPX:help isdn values

Meaning of special values used in ISDN CDI/CGI/SGI/SDI/RGI fields:
-----------+-------------------------------------------------------------------
 Symbol    | Meaning
-----------+-------------------------------------------------------------------
 *         | Don't care.
 #         | Missing or Empty information element
 ##        | Missing information element
 $         | Empty or Non-empty information element
 ?*        | Non-empty information element
-----------+-------------------------------------------------------------------


Meaning of special values used in ISDN CDO/CGO/SGO/SDO/RGO fields:
-----------+-------------------------------------------------------------------
 Symbol    | Meaning
-----------+-------------------------------------------------------------------
 *         | Pass correspondent input field untouched.
 #         | Set an empty information element. An empty information element in
           | most cases is removed.
-----------+-------------------------------------------------------------------

The following are the log and cti connection shown during a normal call from 901 to 902. Please note that there RGO field is empty.

[09:58:51] ABILIS_CPX:_start ldme

Current Local Time: Wednesday 17/06/2015 14:10:29 (UTC+2.00)

Start Debug Log content real-time logging (Type CTRL+C + ENTER to stop):

Date   Time   Resource   Ses   Event          Parameters
------ ------ ---------- ----- -------------- ---------------------------------
170615 141035 CtiP-149       6 E-DialRx       CH:1 BC:Speech CG:uxq901 USER:test
170615 141035 CtiP-149       6 E-CallRx       CH:1 BC:Speech CD:ux902 CG:uxq901
170615 141035 CtiP-149       6 E-Route Match  PR:4  
170615 141035 CtiP-102       6 E-CallTx       BC:Speech TY:TR CD:ux902 
                                              CG:uxq901
170615 141035 CtiP-149       6 E-NumComplete  CDI:ux902 CDO:ux902
170615 141035 CtiP-102       6 E-AlertRx      CH:1 USER:test2
170615 141035 CtiP-149       6 E-AlertTx      CH:1 PI:81 88


PREVIOUS COMMAND(s) ABORTED

[09:59:08] ABILIS_CPX:_d ctice

-------------------------------------------------------------------------------
ID:6    TYPE:TR    ST:ALERT   PR:4            STI:07/00  STO:04/00  EEC:NO  
        START:17/06/2015 14:12:23        DURATION:0          REMAINING:-
       IN:149             BCI:Speech   OUT:102               BCO:Speech
      CDI:ux902                        CDO:ux902
      CGI:uxq901                       CGO:uxq901
      SDI:                             SDO:
      SGI:                             SGO:
      RGI:                             RGO:

The following are logs and cti connection shown during a trasferred call. User test (phone number 901) calls user:test2 (phone number 902). User test2 trasfers calls to a cellphone (phone number 333xxxxxx). Please note that RGO field is not empty, because there's a transferred call.

[12:28:00] ABILIS_CPX:_start ldme

Current Local Time: Wednesday 17/06/2015 14:20:41 (UTC+2.00)

Start Debug Log content real-time logging (Type CTRL+C + ENTER to stop):

Date   Time   Resource   Ses   Event          Parameters
------ ------ ---------- ----- -------------- ---------------------------------
170615 142045 CtiP-149      10 E-DialRx       CH:1 BC:Speech CG:uxq901 USER:test
170615 142045 CtiP-149      10 E-CallRx       CH:1 BC:Speech CD:ux902 CG:uxq901
170615 142045 CtiP-149      10 E-Route Match  PR:4  
170615 142045 CtiP-102      10 E-CallTx       BC:Speech TY:TR CD:ux902 
                                              CG:uxq901
170615 142045 CtiP-102       0 E-CallForward  RULE:ALWAYS USER:test2
170615 142045 CtiP-149      10 E-NumComplete  CDI:ux902 CDO:ux902
170615 142045 CtiP-102      11 E-CallRx       CH:0 BC:Speech CD:ux8333xxxxxx 
                                              CG:uxq901 RG:uxay902 USER:test2
170615 142045 CtiP-102      11 E-Route Match  PR:10 
170615 142045 CtiCl-1       11 E-CallTx       BC:Speech TY:VtoC CD:ux8333xxxxxx 
                                              CG:uxq901 RG:uxay902 
                                              CODERS:Spirit
170615 142045 CtiP-102      11 E-NumComplete  CDI:ux8333xxxxxx CDO:ux333xxxxxx
170615 142045 CtiP-102      12 E-CallTransfer SES/ID-IN:11 SES/ID-OUT:10 
                                              T301:179
170615 142046 CtiCl-1       12 E-ProgressRx   CODERS:Spirit
170615 142046 CtiCl-1       12 E-ProgressRx   CODERS:Spirit
170615 142046 CtiCl-1       12 E-AlertRx      CH:34 CODERS:Spirit
170615 142046 CtiP-149      12 E-AlertTx      CH:1 PI:81 88


PREVIOUS COMMAND(s) ABORTED


[12:28:35] ABILIS_CPX:_d ctice

-------------------------------------------------------------------------------
ID:15   TYPE:VtoC  ST:ACTIVE  PR:TRS[4/10]    STI:10/00  STO:10/00  EEC:NO  
        START:17/06/2015 14:24:14        DURATION:2          REMAINING:-
       IN:149             BCI:Speech   OUT:Clus1             BCO:Speech
      CDI:ux902                        CDO:ux333xxxxxx
      CGI:uxq901                       CGO:uxq901
      SDI:                             SDO:
      SGI:                             SGO:
      RGI:                             RGO:uxay902
      CODER:Spirit   SP:6400   FMRLY:YES    FAXSP:7200   DJ:50      FMDJ:200
         CTIAC:2     BW:8800   SC:NO        MODSP:7200   MJ:250     FMMJ:400
         MODE:-      CurJ:0    TopJ:0       AvgJ:0       FaxPg:0    ECM:YES
                     UND:0                  OVR:0

The cti routing pr:5 is used to call the cellphone. This rule intercept normal calls and trasferred calls, because RGI:*.

[12:37:26] ABILIS_CPX:_d ctire pr:5

Last change: 17/06/2015 10:01:34 CET

-------------------------------------------------------------------------------
PR:5  DESCR:
   ACT:YES  EDT:NO   BCI:VOICE                     BCO:*        EEC:NO
   NEXT:NO           POI:PBX   SR:#        GI:#    OUT:Clus1
   LAST:ANY          CDI:8?*                       CDO:'CDI.S2'
   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:#  

Example: administrator can configure Abilis so that users cannot trasfer calls to cellphones. Rule pr:5 must be modified setting RGI:## and rule pr:6 must be created.

[12:40:26] ABILIS_CPX:_s ctir pr:5 rgi:##

COMMAND EXECUTED

[12:40:34] ABILIS_CPX:_d ctire pr:5

Last change: 17/06/2015 10:01:34 CET

-------------------------------------------------------------------------------
PR:5  DESCR:
   ACT:YES  EDT:NO   BCI:VOICE                     BCO:*        EEC:NO
   NEXT:NO           POI:PBX   SR:#        GI:#    OUT:Clus1
   LAST:ANY          CDI:8?*                       CDO:'CDI.S2'
   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:# 

[12:44:49] ABILIS_CPX:_a ctir pr:6 poi:pbx out:none cdi:8* cdo:'cdi.s2' rgi:?* sp:64000 coders:g.711

COMMAND EXECUTED

[12:44:57] ABILIS_CPX:_d ctire pr:6

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 17/06/2015 10:01:34 CET

-------------------------------------------------------------------------------
PR:6  DESCR:
   ACT:YES  EDT:NO   BCI:VOICE                     BCO:*        EEC:NO
   NEXT:NO           POI:PBX   SR:#        GI:#    OUT:#
   LAST:ANY          CDI:8*                        CDO:'CDI.S2'
   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:64000     SC:Sys      DJ:Sys      MJ:Sys                  ECM:SYS
   CODERS:G.711
   SPOUT:*      SCOUT:*     DJOUT:*     MJOUT:*     
   CODERSOUT:*
   TI1:ALL,00:00-23:59                TI2:#  TI3:#  TI4:#  TI5:#  

The following is the log of a transferred call to a cellphone: the call fails.

[12:46:17] ABILIS_CPX:_start ldme

Current Local Time: Wednesday 17/06/2015 14:40:03 (UTC+2.00)

Start Debug Log content real-time logging (Type CTRL+C + ENTER to stop):

Date   Time   Resource   Ses   Event          Parameters
------ ------ ---------- ----- -------------- ---------------------------------
170615 144009 CtiP-149      16 E-DialRx       CH:1 BC:Speech CG:uxq901 USER:test
170615 144009 CtiP-149      16 E-CallRx       CH:1 BC:Speech CD:ux902 CG:uxq901
170615 144009 CtiP-149      16 E-Route Match  PR:4  
170615 144009 CtiP-102      16 E-CallTx       BC:Speech TY:TR CD:ux902 
                                              CG:uxq901
170615 144009 CtiP-102       0 E-CallForward  RULE:ALWAYS USER:test2
170615 144009 CtiP-149      16 E-NumComplete  CDI:ux902 CDO:ux902
170615 144009 CtiP-102      17 E-CallRx       CH:0 BC:Speech CD:ux8333xxxxxx 
                                              CG:uxq901 RG:uxay902 USER:test
170615 144009 CtiP-102      17 E-Route Match  PR:6 
170615 144009 CtiP-102      17 E-InternalFail PR:6  CAUSE:FF A8 (CPX, No port 
                                              available (NO_PORT))
170615 144009 CtiP-102      17 E-Route Fail   PR:11  CAUSE:FF A8 (CPX, No port 
                                              available (NO_PORT))
170615 144009 CtiP-102      17 E-CallFailTx   CH:0 CAUSE:81 83 (LPN, No route 
                                              to destination)
170615 144009 CtiP-149      16 E-DiscTx       CH:1 CAUSE:80 80 (U, Description 
                                              not available) USER:test

46.6.2. Add CTI Routing Table (A CTIR)

It adds a new CTI routing with PR:xx priority setting the indicated parameters to the specified values. Unspecified parameters are set to default values. The CTI routings table can store up to 256 routing definitions, so the priority value must be in the interval [0 - 255].

If a routing with “PR:xx” is already present in the table, it will get “PR:xx+1” priority.

Example: how to configure a routing which routes every call (CDI:*) coming from the CTI Ports Group G1 (connected to the PABX) to CTI Ports Group G2 (connected to the ISDN lines), without any alternative routings.

[15:30:01] ABILIS_CPX:a ctir pr:3 poi:g1 out:g2 cdi:*

COMMAND EXECUTED

[15:30:50] ABILIS_CPX:d ctire pr:3

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 16/06/2015 12:23:13 CET

-------------------------------------------------------------------------------
PR:3   DESCR:
   ACT:YES  EDT:NO   BCI:VOICE                     BCO:*        EEC:NO
   NEXT:NO           POI:G1    SR:#        GI:#    OUT:G2
   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:#  
[Warning]Warning

Changes made on the CTI routings table are not immediately active. To activate them, execute the initialization command init ctir

46.6.3. Clear CTI Routing Table (C CTIR)

It deletes a CTI routing from the routing table. Priority of remaining routings (if higher than the removed one) are decreased because of table continuity. The syntax of the command is c ctir pr:xx.

[12:28:06] ABILIS_CPX:d ctir

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  G1   #        #   G2        *                    *                   
--------------------------------------------------------------------------------

[12:31:19] ABILIS_CPX:c ctir pr:2

COMMAND EXECUTED

[12:31:51] ABILIS_CPX:d ctir

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
[Warning]Warning

Changes made on the CTI routings table are not immediately active. To activate them, execute the initialization command init ctir

46.6.4. Set CTI Routing Table (S CTIR)

Sets the parameters of CTI routing identified by “PR:xx” to their new values. The syntax of the command is:

s ctir pr:xxx type:<type> [par:value]

[Note]Note

Parameters may change according to the TYPE of the routing selected!

[12:37:09] ABILIS_CPX:d ctir

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  G1   #        #   G2        *                    *                   
--------------------------------------------------------------------------------

[12:37:32] ABILIS_CPX:s ctir pr:2 out:g3 cdi:528

COMMAND EXECUTED

[12:37:36] ABILIS_CPX:d ctir

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  G1   #        #   G3        528                  *                   
--------------------------------------------------------------------------------
[Warning]Warning

Changes made on the CTI routings table are not immediately active. To activate them, execute the initialization command init ctir

The routing which has been modified routes the calls coming from G1 to the group G3 if the called number is 528.

Other interesting parameters available on CTI Routing tables are T301, TIx, NEXT, and DS:<AUTO-I>/<AUTO-O>.

Example: enable a CTI routing just on Tuesday and Wednesday from 18:00 to 20:30.

[12:37:40] ABILIS_CPX:s ctir pr:3 ti1:tu-we,18:00-20:30

COMMAND EXECUTED

[15:35:00] ABILIS_CPX:d ctire pr:3

Last change: 16/06/2015 12:23:13 CET

-------------------------------------------------------------------------------
PR:3   DESCR:
   ACT:YES  EDT:NO   BCI:VOICE                     BCO:*        EEC:NO
   NEXT:NO           POI:G1    SR:#        GI:#    OUT:G3
   LAST:ANY          CDI:528                       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:TU-WE,18:00-20:30              TI2:#  TI3:#  TI4:#  TI5:#  

Example: how to combine the use of T301 and NEXT. Calls must be forwarded to the next routing if there is no answer after 15 seconds .

[13:50:10] ABILIS_CPX:d ctir

Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  G1   #        #   G2        *                    *                   
--------------------------------------------------------------------------------
3   VOICE  G2   #        #   G1        *                    *                   
--------------------------------------------------------------------------------

[13:50:12] ABILIS_CPX:s ctir pr:3 t301:15 next:t

COMMAND EXECUTED

[13:50:43] ABILIS_CPX:a ctir pr:4 poi:g2 out:abilis2 cdi:*

COMMAND EXECUTED

[13:50:54] ABILIS_CPX:d ctir

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  G1   #        #   G2        *                    *                   
--------------------------------------------------------------------------------
3   VOICE  G2   #        #   G1        *                    *                   
    TRANSFERT    ANY         NO   15   *                    *                   
--------------------------------------------------------------------------------
4   VOICE  G2   #        #   Abilis2   *                    *                   
--------------------------------------------------------------------------------
[Warning]Warning

Changes made on the CTI routings table are not immediately active. To activate them, execute the initialization command init ctir

When routing PR:3 is matched, the call will alert for 15 seconds on G1 ports group and if no answer occurs, it will be transferred to the next routing and compressed to “Abilis2”.

46.6.5. Move CTI Routing Table (M CTIR)

Moves the CTI routing priority from the value “PR:xx” to the new value “PR:yy”. Other definitions present in the table are re-sorted because of table continuity.

[13:50:54] ABILIS_CPX:d ctir

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  G1   #        #   G2        *                    *                   
--------------------------------------------------------------------------------
3   VOICE  G2   #        #   G1        *                    *                   
    TRANSFERT    ANY         NO   15   *                    *                   
--------------------------------------------------------------------------------
4   VOICE  G2   #        #   AADM      *                    *                   
--------------------------------------------------------------------------------

[15:38:34] ABILIS_CPX:m ctir pr:3 pr:4

COMMAND EXECUTED

[15:38:40] ABILIS_CPX:d ctir

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 16/06/2015 12:23:13 CET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   DATA   *    #        #   Sl        *                    *                   
--------------------------------------------------------------------------------
1   TR     PBX  #        #   PBX       1?                   *                   
--------------------------------------------------------------------------------
2   VOICE  G1   #        #   G2        *                    *                   
--------------------------------------------------------------------------------
3   VOICE  G2   #        #   AADM      *                    *                   
--------------------------------------------------------------------------------
4   VOICE  G2   #        #   G1        *                    *                   
    TRANSFERT    ANY         NO   15   *                    *                   
--------------------------------------------------------------------------------
[Warning]Warning

Changes made on the CTI routings table are not immediately active. To activate them, execute the initialization command init ctir

46.6.6. Macro functions

A macro-instruction can only contain:

  • decimal digits '0' - '9';

  • names of input caller's address and sub-address fields: 'CGI' and 'SGI';

  • names of input called's address fields and sub-address fields: 'CDI' and 'SDI';

  • the '.' (dot) character, which is used as a separator;

  • the sequences ".3xx", ".Lxx" and ".Rxx".

Table 46.4. Table Lxx, Rxx, 3xx macros

SequenceOperative meaning
yy.SxxIt takes the characters of field "yyy" starting from position "xx".
yyy.LxxIt takes up to "xx" characters of field "yyy", starting from the leftmost.
yyy.RxxIt takes up to "xx" characters of field "yyy", staring from the rightmost.

Examples:

  • CDO:'SGI': the called address field of the outgoing call will contain the same value as is contained in the field for the called sub-address of the incoming call.

  • CDO:1023'SGI': the called address field of the outgoing call will contain the numerical sequence "1023" followed by the content of the called sub-address of the incoming call.

  • CDO:1023'SGI.S02': the called address field of the outgoing call will contain the numerical sequence "1023" followed by the content of the called sub-address of the incoming call, starting from the 2nd character (.S02).

  • CDO:1023'SGI.R02': the called address field of the outgoing call will contain the numerical sequence "1023" followed by at most two characters taken from the content of the called sub-address of the incoming call, starting from the right most (.R02).

Type the following command to display info about macro functions:

[07:32:16] ABILIS_CPX:help isdn macro

ISDN macros permit the manipulation of ISDN numbers and subaddresses in the
call being processed.

Macro must be written between single quotes and can be present only in
output fields CDO/CGO/SDO/SGO (xxO).
A macro may refer a INR list and it's fields, in this case a sort of sub-macro
occurs and a couple of single quotes is required.

In following explanation xx is used to indicate any of CD/CG/SD/SG.

--- Simple macros in CDO/CGO/SDO/SGO (xxO) ------------------------------------
xxO: 'xxI'       Copy xxI in xxO
xxO: 'xxI.Sy'    Copy xxI in xxO starting from left position y
xxO: 'xxI.Ly'    Copy xxI in xxO leftmost y characters
xxO: 'xxI.Ry'    Copy xxI in xxO rightmost y characters

--- Macros with INR list sub-macro in CDO/CGO/SDO/SGO (xxO) -------------------
The INR list fields are: Number, CHK, CD, CG.
When a INR list is used in xxO fields macros it works as follow:
if a match is found between Number and field indicated by CHK (CGI or CDI),
the CD or CG field will be used in the preparation of the xxO field,
as specified by the sub-macro.

CDO: ''listname''         Copy list CD field into CDO
CGO: ''listname''         Copy list CG field into CGO
xxO: ''listname.CD''      Copy list CD field into xxO
xxO: ''listname.CD'.Sy'   Copy list CD field from position y into xxO
xxO: ''listname.CD'.Ly'   Copy list CD field leftmost y characters into xxO
xxO: ''listname.CD'.Ry'   Copy list CD field rightmost y characters into xxO
xxO: ''listname.CG''      Copy list CG field into xxO
xxO: ''listname.CG'.Sy'   Copy list CG field from position y into xxO
xxO: ''listname.CG'.Ly'   Copy list CG field leftmost y characters into xxO
xxO: ''listname.CG'.Ry'   Copy list CG field rightmost y characters into xxO

--- Examples ------------------------------------------------------------------
More macros can be written at the same time, the limit is only the 24
characters available in the xxO fields
Here is an example of possible combinations.
If in some circumstance a combination is not allowed you will get an
appropriate message.

'cdi'
123'cdi'
'cdi'123'cgi.s5'
''listname''
''listname.cd''
''listname'.s5'
''listname.cg'.s2'
123''listname.cg'.s2'
'cdi'123''listname.cg'.s2'