59.3. CTIDISA tables

59.3.1. CTIDISA Service table

The CtiDisa Service Table can be managed with these commands:

  • d ctidisa service: displays the complete table;

  • d ctidisa service:<name>: displays the parameters of the specified service;

  • a ctidisa service:<name> [par:val]: adds a new service in the table;

  • c ctidisa service:<name>: clears the specified service in the table;

  • s ctidisa service:<name> [par:val]: sets the configuration of the specified service.

The d ctidisa service ? command shows the meaning of parameters.

[12:02:51] ABILIS_CPX:d ctidisa service

Total number of services:1

-------------------------------------------------------------------------------
SERVICE:Default           DESCR:System_default_service
  MODE:        DISA                   |INTRO-STATE:   CREQ  |INTRO:    
  ROUTING:     PREFIX                 |CONN-DELAY:    6     |WELCOME:  
  MAX-CALLS:   NOMAX                  |PC-OFFER:      *     |INITDIAL: 
  BC:          Speech                 |TRANSFER:      NO    |AFTERPIN: #
  CB:          NO                     |                     |LOOPDIAL: 
  CB-DELAY:    5                      |DIAL-TOUT:     30    |IDENFAIL: 
  CB-NRTY:     1                      |PIN-TOUT:      15    |CALLNA:   
  CB-UNK-CDO:  'CGI'                  |NUM-TOUT:      15    |ALERT:    
  CB-NAT-CDO:  0'CGI'                 |BUSYDISC:      4     |BUSY:     
  CB-INT-CDO:  00'CGI'                |LOOP-BUSY:     YES   |NOANSWER: 
  CB-CGO:      #                      |LOOP-NOANSWER: YES   |DISC:     
  CTIP-TYPE-O: *                      |LOOP-DENIED:   YES   |HOLD:     
  AUTO-CDO:    #                      |LOOP-OTHER:    YES   |BYE:      #
  TOUT-CDO:    #                      |MAX-LOOPS:     0     
  END-CDO:     #  
  PERMIT:      *                      
  CDI:         -                      
  CGI:         -
  SUB-SERVICE: #
-------------------------------------------------------------------------------
[Note]Note

The Default service is automatically created by the system. It's assigned to the calls which doesn't match with other configured services; default values can be edited, except CDI and CGI fields.

Meaning of the most important parameters:

MODE

Operational mode [DISA: the behaviour is the standard DISA behaviour; ACD: the Automatic Call Distribution is enabled; INTRO: the behaviour is that of a “responder” for not-paid messages; DATA-CB: the behaviour is that of ordering a CALL request to the specified resource and reject the call; APP: the behaviour is that the service is interfaced with an application. At this moment only SCRIPT resource can use this mode for applications written in LUA.].

ROUTING

Routing type for outgoing calls [PREFIX; EN-BLOC].

MAX-CALLS

Maximum number of simultaneous calls allowed to this service.

BC

Bearer Capability in outgoing calls [AUTO, Speech, 3.1Khz].

Refer to B-CHANNEL to have more information,

CB

Enables/disables the Call Back.

CB-DELAY

Time between the end of the incoming call and the Call Back call by the DISA.

CB-NRTY

Maximum number of Call Back attempts.

CB-UNK-CDO

Call Back number for UNKNOWN type.

CB-NAT-CDO

Call Back number for NATIONAL type.

CB-INT-CDO

Call Back number for INTERNATIONAL type.

CTIP-TYPE

CTIP type for outgoing calls.

AUTO-CDO

Automatic Called Number; if service matches and this field isn't null, the number configured here is automatically dialled (any other digit entered by the user is discarded).

TOUT-CDO

Predefined number called after INITDIAL/LOOPDIAL timeout. "#" 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 or 'macro' (see CTI Routings). (E.g. 123 or ie356 or # or ne# or 'CGI' or 'CGI.S2' or u0'CGI.S3'). Only for MODE:DISA/ACD.

In this parameter it is possible to configure a number that DISA calls if the DIAL-TOUT expires. This allows a sort of “default” number which is called when the caller does not enter any digits. Typical application is an IVR like “Please enter the desired extension, or wait to be connected to the operator”. This feature is useful when the caller can't deliver DTMF, for example if he is using old telephones with pulse dialling.

END-CDO

Number called after the outgoing call terminates and BYE message has been played. "#" 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 or 'macro' (see CTI Routings). (E.g. 123 or ie356 or # or ne# or 'CGI' or 'CGI.S2' or u0'CGI.S3'). See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values. Only for MODE:DISA/ACD.

PERMIT

Permitted called number/prefixes.

CDI

Incoming Called number that can be used at pre-identification. If it's set to DISABLED [#], the pre-identification is performed using calling number.

CGI

List of calling numbers that can be used at pre-identification to find the user. Use - prefix to delete from the list a calling number previously inserted (e.g. “-123456”): several calling numbers can be set joining values by the character , (e.g. “CGI:1234,5555,-77777”). This field isn't allowed for the Anonymous user and it's possible to set up to 2000 numbers.

SUB-SERVICE

Sub-service assigned on the base of called number of the "out" call.

Sequence of two values separated by ':' (colon) e.g.: 'num:name', where:

- 'num' is the number i.e. a sequence of max. 20 characters in the range [0..9, *] optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or the name of an IN/RU/MR list between single quotes. The '*' is allowed only alone or as the last character.

- 'name' is the sub-service name, i.e. string of max. 16 characters. Spaces, '&', ':' and ',' are not allowed. Case is preserved. (E.g.: "555:Support" or "ux376*:Responder" or "'list':Tools")

Use '-' prefix to delete a sub-service (E.g. "-123:SubServ"). Several sub-services can be set joining values by ','. (E.g. "111:SubServ1,-222:SubServ2,-'sublist':SubServ3"). Setting SUB-SERVICE to "#" will delete all sub-services defined for the service.

Among all services it's possible to configure up to 128 sub-services. See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values. <Only for MODE:DISA/ACD>

CONN-DELAY

Sets the duration of ALERTING state for incoming calls to DISA (i.e. the time between the reception of the call and the response by the DISA).

PC-OFFER

Precedence Call Priority Level used when making the "out" call [*, 0..4], where:

- "*", same precedence as "in" call.

- 0..4, with precedence set according to the parameter (Value 0 means highest priority).

<Only for MODE:DISA/ACD>

TRANSFER

Enables/disables call transfer after outgoing call is established; this function is inhibited when in the service ACD is active.

ACD

Enables/disables the Automatic Call Distribution.

ACD-INTERVAL

Time interval in which a call in a queue tries to verify if the currently ACTIVE call gets disconnected.

DIAL-TOUT

Maximum time to wait for the insertion of the first digit in post-selection (during INITDIAL).

PIN-TOUT

Maximum time to wait for the insertion of the first digit of the PIN.

NUM-TOUT

Maximum time to wait to complete the insertion of the number in post-selection.

BUSYDISC

Duration of the played BUSY and DISC CtiSys tone.

MAX-LOOPS

Maximum number of loop enabled [0-99: when the ACD is set to YES, this value is automatically set to 99 and it isn't editable].

LOOP-BUSY

Enables/disables the loop when the reason of a call failure is “user busy” (cause 0x91).

LOOP-NOANSWER

Enables/disables the loop when the reason of a call failure is “user not responding, user alerted” (cause 0x93).

LOOP-DENIED

Enables/disables the loop when the reason of a call failure is “selection not allowed for the user” (in this kind of error the call was not sent to CTIR).

LOOP-OTHER

Enables/disables the loop for reasons other than those precisely recognised (e.g. non-existent routing).

DISC-CAUSE

Used to set the disconnect cause after the INTRO message has been played. This is useful for setting up alternative routings. (Only for MODE:INTRO).

INTRO...BYE

Refer to Section 59.8.1, “File audio format” to have more inforamations about these parameters.

59.3.2. CTIDISA User table

The CTIDISA User Table can be managed with these commands:

  • d ctidisa user: displays the complete table;

  • d ctidisa user:<name>: displays the parameters of the specified user;

  • a ctidisa user:<name> [par:val]: adds a new user in the table;

  • c ctidisa user:<name>: clears the specified user in the table;

  • s ctidisa user:<name> [par:val]: sets the configuration of the specified user.

The d ctidisa user ? command shows the meaning of parameters.

[10:47:14] ABILIS_CPX:d ctidisa user

Total number of users:1

-------------------------------------------------------------------------------
USER:Anonymous
  PIN:     #                |MAX-CALLS: NOMAX |PERMIT: SERVICE
  SERVICE: AUTO             |CB:        NO    |DENY:   *
  CGI:   -
-------------------------------------------------------------------------------
[Note]Note

The Anonymous user is automatically created by the system; it identifies all the callers not configured in others users.

Meaning of the most important parameters:

PIN

Personal Identification Number code assigned to the user; if it's set to #, the user is identified only by its calling number.

SERVICE

Service name assigned to the user; if it's set to AUTO, the service discovered at the pre-identification phase is used.

MAX-CALLS

Maximum number of simultaneous calls allowed to the user.

CB

Enable/disable Call Back [NO, YES].

PERMIT

Permitted called numbers/prefixes. From 1 up to 20 characters in the range ['0'..'9', '*'] or "#" optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or "SERVICE" or the name of an IN list between single quotes. The '*' is allowed only alone or as the last character. (E.g. # or ne# or 1234567 or 4567* or * or 'my_list')

DENY

Denied called numbers/prefixes. From 1 up to 20 characters in the range ['0'..'9', '*'] or "#" optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or the name of an IN list between single quotes. The '*' is allowed only alone or as the last character. (E.g. # or ne# or 1234567 or 4567* or * or 'my_list') See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

CGI

List of calling numbers that can be used at pre-identification to find the user. Use - prefix to delete from the list a calling number previously inserted (e.g. “-123456”): several calling numbers can be set joining values by the character , (e.g. “CGI:1234,5555,-77777”). Setting CGI to "#" will delete all incoming calling numbers defined for the user. This field isn't allowed for the Anonymous user and it's possible to set up to 2000 numbers.