46.3. CTI Ports Group

46.3. CTI Ports Group
	Chapter 46. CTI System

CTI ports can be grouped to simplify the routing management; groups created can be used in CTI Routings Table as if they were an unique logical port.

Use the following commands to manage the CTI Groups:

a ctig id:xx [par:value] : adds a new CTI Group
s ctig id:xx [par:value] : sets a CTI Group
c ctig id:xx : clears a CTI Group
d ctig : displays the CTI Group table

The d ctig ? command shows all available parameters.

Here is an example: the G1 group contains the BRI ports (ctip:31 and ctip:32) towards PBX, the G2 group contains the BRI ports towards ISDN lines (ctip:33 and ctip:34).

[12:38:19] ABILIS_CPX:a ctig id:1 p1:31 p2:32 descr:to_PBX

COMMAND EXECUTED

[12:38:19] ABILIS_CPX:a ctig id:2 p1:33 p2:34 descr:to_ISDN_line

COMMAND EXECUTED

[12:38:19] ABILIS_CPX:d ctig

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
------------------------------+------------------------------------------------
ID: [DESCR:]
    P:  S: R:                 |P1       P2       P3       P4       P5       ...
                              |...      P62      P63      P64
    [Px:         CDO:  CGO:  SDO:  SGO:  RGO:  SP:  CODERS:  DJ:  MJ:  T301:  ]
------------------------------+------------------------------------------------
0   [Iax/Sip/Disa/Vo group (Read Only)]
    NO  R  ST                 |Iax      Sip      Disa     Vo       .        
------------------------------+------------------------------------------------
1   [to_PBX]
    NO  R  ST                 |31       32       .        .        .        
------------------------------+------------------------------------------------
2   [to_ISDN_line]
    NO  R  ST                 |33       34       .        .        .        
------------------------------+------------------------------------------------

Meaning of the most important parameters:

S

It establishes the algorithm with which the ports listed in the group are scanned. The available values are:

R: stands for “Round-Robin” algorithm and it indicates that the scanning of the ports occurs in a circular manner, ensuring that all of them are evenly utilized;
P: stands for “Priority” algorithm and it is used to indicate that the ports are scanned starting from the first to the last;
M: stands for “Multicasting” algorithm and it is used to indicate that all the port are alerted simultaneously.

R

It establishes the rule with which the CTI router will try the connection on the next port listed in the group, in the case that the connection on the previous port fails. The available values are:

ST: the next port is used only for following codes: “internal causes” (i.e. those with location=0xFF), “0x92 no user responding”, “all causes in classes 02, 05, 06” (0xA2-0xAF, 0xC1-0xCF, 0xD1-0xDF);
IN: the next port is used only for internal causes (i.e. those with location=0xFF);
UN: the next port is always evaluated if the previous one fails;
EU: at this moment it works like UN.
The name of an ICAUSE/RU/MR list between single quotes (E.g.: EU or 'my_list').

P

Enables/disables the group for call pickup; generally used for POTS ports.

P1:..P64

Input/output port/group/cluster [# or NONE, 1..600, Iax, Sip, Disa, Vo, Vm, Mix, G0..G32, PBX, cluster name or EC/RU/MR list name between single quotes] The cluster name must correspond to an existing CTI cluster. The list name must correspond to an existing EC/RU/MR list.

For every resource in the group it is possible to rewrite a series of call related parameters that actually REPLACE the correspondent fields in the routing: CDO: CGO: SDO: SGO: RGO: SP: CODERS: DJ: MJ: T301:

Special consideration for SP: CODERS: DJ: MJ:

when the group is used in POI: SR: GI: they replace SP: CODERS: DJ: MJ:
when the group is used in OUT: they replace SPOUT: CODERSOUT: DJOUT: MJOUT:

Each resource has a set of parameters that CAN replace correspondent fields of the routing:

If the parameter is <blank> the routing parameter is used.
If the parameter is not <blank> the group parameter REPLACES the routing one.

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

46.3.1. POTS and CTI Group

A special group, called PBX, exists for POTS cards . See the relative section in the paragraphs below to understand how to use it.

The most important features which the CTI Group allows on CTI POTS ports are:

MULTICASTING: allows simultaneously alert to more CTI POTS ports;
PICK-UP: allows answering an incoming call on a phone, from another one connected to the same POTS card.

The configuration of these two features is made on CTI Group (as shown above).

[12:16:29] ABILIS_CPX:d ctig

------------------------------+------------------------------------------------
ID: [DESCR:]
    P:  S: R:                 |P1       P2       P3       P4       P5       ...
                              |...      P62      P63      P64
    [Px:         CDO:  CGO:  SDO:  SGO:  RGO:  SP:  CODERS:  DJ:  MJ:  T301:  ]
------------------------------+------------------------------------------------
0   [Iax/Sip/Disa/Vo group (Read Only)]
    NO  R  ST                 |Iax      Sip      Disa     Vo       .        
------------------------------+------------------------------------------------
1   YES M  ST                 |101      102      103      104      .        
------------------------------+------------------------------------------------

In a CTI Group, add the ports which must be alerted simultaneously and set the scanning method parameter SCAN:M, to activate Multicasting.

In a CTI Group add the ports which must support this service and set the Pick-Up parameter P:YES to activate Pick-up.

There are two methods for using the Pick-Up:

Generic call Pick-Up: allows the Pick-Up of the incoming call on all phones connected to the CTI ports that belong to the CTI group; if more than one call is coming in, the oldest one will be picked-up. The operation is:
- pick-up the telephone handset;
- dial “* 0” (asterisk than zero).
Specific call Pick-Up: allows the pick-up of a specific incoming call on a specific phone connected to the CTI ports that belong to the CTI group. The operation is:
- pick up the telephone handset;
- dial “* 1+NUM” (asterisk, than one, then the value of the parameter NUM assigned to the correspondent CTI POTS port, i.e.*104 )

46.3.2. Heterogeneous group

CTIG now permits to use heterogeneous resources inside the group and another group too (group of groups allowed).

Any of ISDN, CTIP, VPOTS, CELL, Sip, Iax, Disa, Vo, Vm, Mix, Cluster, Cluster list (EC/RU/MR), another group (Gx), can be configured inside a group.

Below are shown examples of heterogeneous group.

[12:16:29] ABILIS_CPX:d ctig

------------------------------+------------------------------------------------
ID: [DESCR:]
    P:  S: R:                 |P1       P2       P3       P4       P5       ...
                              |...      P62      P63      P64              
    [Details  Px:  CDO:  CGO:  SDO:  SGO:  RGO:  SP:  CODERS:  DJ:  MJ:  T301:]
------------------------------+------------------------------------------------
(0) NO  R  ST                 |Iax      Sip      Disa     Vo       .         
------------------------------+------------------------------------------------
1   YES R  'listname'         |101      103      Antek    102      Iax      
                              |Disa     Vo 
------------------------------+------------------------------------------------
2   [Etherogeneous group]
    YES M  ST                 |101      103      Antek    102      Iax      
                              |Disa     Vo       130      Tk8      Sip
                              |Vm       Mix      
    - Details -----------------------------------------------------------------
    P2:103       CDO:* 
    ---------------------------------------------------------------------------
    P3:Antek     CDO:ux12345678901234567890  SDO:abcdefghijklmnopqrst  SP:64000
                 CODERS:G.711,Spirit,G.729,G.723.1  DJ:100  MJ:250 
    ---------------------------------------------------------------------------
    P4:102       CDO:'CDI.S2'  SDO:leo  SP:64000 CODERS:G.711  
    ---------------------------------------------------------------------------
    P9:Tk8       SDO:Tom  SP:6400  T301:30 
------------------------------+------------------------------------------------
3   [Etherogeneous group]
    YES M  ST                 |101      103      Antek    102      Iax      
                              |Disa     Vo       130      Tk8      Sip 
                              |Vm       105      106      110
------------------------------+------------------------------------------------
4   [Group of Groups]
    YES R  'listname'         |G1       G2       G3       PBX      .        
------------------------------+------------------------------------------------
5   YES R  ST                 |101      103      Antek    102      Iax      
    - Details -----------------------------------------------------------------
    P2:103       CDO:ux123456789 
    ---------------------------------------------------------------------------
    P3:Antek     CDO:ux12345678901234567890  SDO:abcdefghijklmnopqrst SP:64000
                 CODERS:G.711,Spirit,G.729,G.723.1  DJ:100  MJ:250  T301:60  
-------------------------------------------------------------------------------

Special consideration for SP: CODERS: DJ: MJ:

when the group is used in POI: SR: GI: they replace SP: CODERS: DJ: MJ:
when the group is used in OUT: they replace SPOUT: CODERSOUT: DJOUT: MJOUT:

Each resource has a set of parameters that CAN replace correspondent fields of the routing:

If the parameter is <blank> the routing parameter is used.
If the parameter is not <blank> the group parameter REPLACES the routing one.