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) ---------------------------------
--------------------------------------+--------------------+-------------------
 [DESCR:]
 ID: PICKUP: SCAN: RULE:              |P1  P2  P3  P4  P5  |P6  P7  P8  P9  ...
                                      |... P62 P63 P64
--------------------------------------+--------------------+-------------------
 to_PBX
 1   NO      R     ST                 |31  32  .   .   .   |.   .   .   .   .
--------------------------------------+--------------------+-------------------
 to_ISDN_line
 2   NO      R     ST                 |33  34  .   .   .   |.   .   .   .   .
--------------------------------------+--------------------+-------------------

Meaning of the most important parameters:

SCAN

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.

RULE

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.

PICKUP

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

	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

 [DESCR:]
 ID: PICKUP: SCAN: RULE:              |P1  P2  P3  P4  P5  |P6  P7  P8  P9  ...
                                      |... P62 P63 P64
--------------------------------------+--------------------+-------------------
 1   NO      R     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 PICKUP:Y 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 )