46.2. CTI Ports configuration

When an ISDN or POTS device (QPRIX, BRI8, BRI4, POTS,…) is added in the configuration also its related CTI ports are activated (for further informations refer to Section 5.5, “Devices”).

The following command modifies the parameters of a CTI port:

s p ctip:<port_number> <parameter>:<value>

The commands d p ctip ? or d p ctipe ? shows available parameters.

Here is an example of configuration of a BRI card.

[12:38:14] ABILIS_CPX:s p ctip:31 side:NT line:PP descr:to_PBX

COMMAND EXECUTED

[12:38:14] ABILIS_CPX:s p ctip:32 side:NT line:PP descr:to_PBX

COMMAND EXECUTED

[12:38:14] ABILIS_CPX:s p ctip:33 side:TE line:PP descr:to_ISDN_line

COMMAND EXECUTED

[12:38:14] ABILIS_CPX:s p ctip:34 side:TE line:PP descr:to_ISDN_line

COMMAND EXECUTED

[12:38:14] ABILIS_CPX:d p ctip

CTIP:31  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_PBX
Run     card:BRI4-1<1>
        OPSTATE:UP        LOG:DS        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:YES     CT:NO     SS:NO 
        mode:Bri                        BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID

CTIP:32  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_PBX
Run     card:BRI4-1<2>
        OPSTATE:UP        LOG:DS        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:YES     CT:NO     SS:NO 
        mode:Bri                        BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID

CTIP:33  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<3>
        OPSTATE:UP        LOG:DS        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO                SS:NO 
        mode:Bri          L12-ACT:UP    BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID

CTIP:34  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<4>
        OPSTATE:UP        LOG:DS        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO                SS:NO 
        mode:Bri          L12-ACT:UP    BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID

[16:24:15] ABILIS_CPX:d p ctipe:31

CTIP:31  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_PBX
Run     card:BRI4-1<1>    
        OPSTATE:UP        LOG:DS        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:YES     CT:NO     SS:NO 
        mode:Bri                        BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID
        X25:NO   (XTEI:10)   XK:7      XN200:3   xn201:260  XN202:3
                 XT200:1     XT202:2   XT203:10
        Q931:YES (QTEI:0)    QK:1      QN200:3   qn201:260  QN202:3   QT200:1
                 QT202:2     QT203:10  TDISC:90  QT301:180  QT302:15  QT303:4
                 QT304:30    QT305:30  QT308:4   QT310:30   QT313:6   QT316:15
                 DIALT:5     scrst:YES ORCD:0    ICT-T1:500  ICT-T2:500
        SQNRTY1:15           SQDELAY1:30         SQDELAY2:5    
        LCS-GROUP:NONE       BUSY-NOCHAN:NO      OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS               SS-PRES-CG:YES       NPOO-CT:SYS
        SS-CF-DND:YES                  SS-VM:YES            CLIP-RULE:PRIVATE
[16:24:19] ABILIS_CPX:d p ctipe:32

CTIP:32  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_PBX
Run     card:BRI4-1<2>    
        OPSTATE:UP        LOG:DS        side:NT      line:PP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:YES     CT:NO     SS:NO 
        mode:Bri                        BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID
        X25:NO   (XTEI:10)   XK:7      XN200:3   xn201:260  XN202:3
                 XT200:1     XT202:2   XT203:10
        Q931:YES (QTEI:0)    QK:1      QN200:3   qn201:260  QN202:3   QT200:1
                 QT202:2     QT203:10  TDISC:90  QT301:180  QT302:15  QT303:4
                 QT304:30    QT305:30  QT308:4   QT310:30   QT313:6   QT316:15
                 DIALT:5     scrst:YES ORCD:0    ICT-T1:500  ICT-T2:500
        SQNRTY1:15           SQDELAY1:30         SQDELAY2:5    
        LCS-GROUP:NONE       BUSY-NOCHAN:NO      OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS               SS-PRES-CG:YES       NPOO-CT:SYS
        SS-CF-DND:YES                  SS-VM:YES            CLIP-RULE:PRIVATE      

[16:24:24] ABILIS_CPX:d p ctipe:33

CTIP:33  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<3>    
        OPSTATE:UP        LOG:DS        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO                SS:NO 
        mode:Bri          L12-ACT:UP    BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID
        X25:NO   (XTEI:10)   XK:7      XN200:3   xn201:260  XN202:3
                 XT200:1     XT202:2   XT203:10
        Q931:YES (QTEI:0)    QK:1      QN200:3   qn201:260  QN202:3   QT200:1
                 QT202:2     QT203:10  TDISC:90  QT301:180  QT302:15  QT303:4
                 QT304:30    QT305:30  QT308:4   QT310:30   QT313:6   QT316:15
                 DIALT:5     scrst:YES ORCD:0    ICT-T1:500  ICT-T2:500
        SQNRTY1:15           SQDELAY1:30         SQDELAY2:5    
        LCS-GROUP:NONE       BUSY-NOCHAN:NO      OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS               SS-PRES-CG:YES       NPOO-CT:SYS
        SS-CF-DND:YES                  SS-VM:YES            CLIP-RULE:PRIVATE
       

[16:24:25] ABILIS_CPX:d p ctipe:34

CTIP:34  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:to_ISDN_line
Run     card:BRI4-1<4>    
        OPSTATE:UP        LOG:DS        side:TE      LINE:PP   TYPE:NET-PUBLIC
        signalling:DSS1   TEI:STANDARD  HOLD:NO                SS:NO 
        mode:Bri          L12-ACT:UP    BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID
        X25:NO   (XTEI:10)   XK:7      XN200:3   xn201:260  XN202:3
                 XT200:1     XT202:2   XT203:10
        Q931:YES (QTEI:0)    QK:1      QN200:3   qn201:260  QN202:3   QT200:1
                 QT202:2     QT203:10  TDISC:90  QT301:180  QT302:15  QT303:4
                 QT304:30    QT305:30  QT308:4   QT310:30   QT313:6   QT316:15
                 DIALT:5     scrst:YES ORCD:0    ICT-T1:500  ICT-T2:500
        SQNRTY1:15           SQDELAY1:30         SQDELAY2:5    
        LCS-GROUP:NONE       BUSY-NOCHAN:NO      OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS               SS-PRES-CG:YES       NPOO-CT:SYS
        SS-CF-DND:YES                  SS-VM:YES            CLIP-RULE:PRIVATE

Meaning of the most important parameters:

LOG

State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes)

side

Port behaviour [TE: if the port is connected to an ISDN line; NT: if the port is connected to a PBX].

LINE

Line type [MP if the line is Multi-Point; PP if the line is Point-to-Point].

TYPE

Assigned role [USER, NET-PRIVATE, NET-PUBLIC]

NUM

Phone number assigned to CTI port. The available values are:

  • *: the Calling Number offered by CTIR is passed transparently to the device;

  • #: the Calling Number is not passed to the device;

  • ##: enforces the presentation restricted: the Calling Number is not passed to the device;

  • nnnn: exactly this number is passed as Calling Number to the device;

  • nnnn*: the Calling Number received from CTIR is modified by replacing first four digits with nnnn;

  • nnnn??: similar to nnnn* with the difference that only an exact number of digits as many ? is passed after nnnn;

  • ????: only an exact number of digits as many ? is passed after the nnnn.

SS

Enable/disable supplementary services accessible through "*" as first digit in called number [NO, YES]

SS-PICKUP

Supplementary service. Pickup permissions [NO, GROUP, ANY]

SS-CF-DND

Supplementary service. Call forwarding and Do-Not-Disturb [NO, YES]

SS-PRES-CG

Supplementary service. Calling present [NO, YES]

OUT-DIAL-TONE

Enable/disable the outside dial tone generation [SYS, NO, YES] <Only for mode: equal to E1-ISDN, Bri or Pots>.

LCS-GROUP

Last Calling number Service group identifier [NONE, 1..32] <Only for mode: not equal to Pots>

Here is an example of configuration of a POTS port.

[20:47:01] ABILIS_CPX:s p ctip:101 num:11 descr:phone_1

COMMAND EXECUTED

[20:47:01] ABILIS_CPX:d p ctip:101

CTIP:101  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:phone_1
Run     card:POTS-1<1>                  USER:11
        OPSTATE:UP        LOG:NO                               TYPE:USER
        signalling:POTS                 HOLD:YES     CT:ICT    SS:YES
        DEVICE:PHONE                                           AC:NO
        NUM:11                          ADDRBOOK-NUM:NUM


[20:47:59] ABILIS_CPX:d p ctipe:101

CTIP:101 - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:phone_1
Run     card:BSE-1<9>                   USER:11
        OPSTATE:UP        LOG:NO                               TYPE:USER
        signalling:POTS                 HOLD:YES     CT:ICT    SS:YES
        DEVICE:PHONE                                           AC:NO
        NUM:11                          ADDRBOOK-NUM:NUM
        AC-CDO:#                        AC-DLY:60
        LOOP:NO         TEST:NO           
        CLIP:SYS        CLIP-STD:SYS      CLIP-TAS:SYS    CLIP-LEVEL:SYS
        SENSING:SYS     ABF:SYS  HPF:SYS  DEBOUNCE:SYS    MIN-FLASH:SYS   
        COUNTRY:SYS                                       MAX-FLASH:SYS   
        DIALT:5         IN-GAIN-ADJ:SYS                   OUT-GAIN-ADJ:SYS
        AT:SYS          AT-CODE:SYS     AT-DURATION:SYS   BC:SYS
        DT:SYS          DT-CODE:SYS     DT-DURATION:SYS   OUTDIAL-TONE:SYS
        SS-PICKUP:GROUPS                SS-PRES-CG:YES    NPOO-CT:SYS
        SS-CF-DND:YES                   SS-VM:YES

Meaning of the most important parameters:

LOG

State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes)

USER

Name of the user assigned to this port. From 1 up to 32 ASCII characters or "#". The user must be present and it must not be already assigned to another port.

NUM

Phone number assigned to CTI port. The available values are:

  • *: the Calling Number offered by CTIR is passed transparently to the device;

  • #: the Calling Number is not passed to the device;

  • ##: enforces the presentation restricted: the Calling Number is not passed to the device;

  • nnnn: exactly this number is passed as Calling Number to the device;

  • nnnn*: the Calling Number received from CTIR is modified by replacing first four digits with nnnn;

  • nnnn??: similar to nnnn* with the difference that only an exact number of digits as many ? is passed after nnnn;

  • ????: only an exact number of digits as many ? is passed after the nnnn.

SS

Enable/disable supplementary services accessible through "*" as first digit in called number [NO, YES]

SS-PICKUP

Supplementary service. Pickup permissions [NO, GROUP, ANY]

SS-CF-DND

Supplementary service. Call forwarding and Do-Not-Disturb [NO, YES]

SS-PRES-CG

Supplementary service. Calling present [NO, YES]

OUT-DIAL-TONE

Enable/disable the outside dial tone generation [SYS, NO, YES] <Only for mode: equal to E1-ISDN, Bri or Pots>.

CLIP

Caller Identification Presentation [NO, YES, EXT, SYS]

MIN-FLASH

Minimal duration of the on-hook transition to detect a FLASH [SYS, 50..1000 ms]

MAX-FLASH

Maximal duration of the on-hook transition to detect a FLASH [SYS, 50..1000 ms]

IN-GAIN-ADJ

Input (Receive) gain adjustment respect to the gain present in the country coefficient file [SYS, MUTE, COUNTRY, -12..+12 dB]

OUT-GAIN-ADJ

Output (Transmit) gain adjustment respect to the gain present in the country coefficient file [SYS, MUTE, COUNTRY, -12..+12 dB]

[Caution]Caution

To activate the changes made on the upper case parameters, execute the initialization command init ctisys; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. with warm start command).