49.8. LCS - Last Calling number Service

49.8. LCS - Last Calling number Service
	Chapter 49. CTI System

When a person receives a call which comes from UMTSBOX, the calling number is that of the SIM inserted, and there is nothing we can do to change the situation. If the called person does not answer, he will later see a call coming from that number, he can try to call it back, but when the call enters the UMTSBOX it is routed to some "default" recipient, e.g. the operator, but the operator does not know what person in the company made the call. This can also be seen when as a gateway for calls is using a CTI cluster or a trunk: SIP or IAX. In order not to meet such situations, it was developed the LCS - Last Calling number Service.

	Important
	Last Calling number Service requires a separate licence.

Suppose to have this situation:

CTIP 101 (for example number 200) makes a call to a cell phone (number 320123456);
The call is routed through the UMTS BOX using port #501 (which corresponds to a SIM whose number is 320654321);
The LCS saves calling and called numbers in the LCS table;
A call is received by UMTS BOX: the called number is 320654321, the calling number is 320123456;

The basic principle of LCS:

When we make an outgoing call the LCS saves the CALLED number and the CALLING number.
When later we will receive an incoming call from the same port where the CALLING is the previously CALLED number, we put in the CALLED number the previously CALLING number.

Requirements for LCS configuration:

Add the LCSG - Last Calling number Service Group;
Configure the LCS and LCST (Last Calling number Service records Timeout) parameters of CTIR routing;
Note
The value Sys of the LCST parameter of CTI routing means the default value and will be the one setup by the CTISYS resource.
Configure the reference to a Last Calling number Service Group for:
- CTI ports (except POTS and VPOTS): the LCS-GROUP parameter;
- CTI clusters: the LCS-GROUP parameter;
- SIP users: the SIP-LCS-GROUP parameter;
- IAX users: the IAX-LCS-GROUP parameter.

	Note
The value `Sys` of the LCST parameter of CTI routing means the default value and will be the one setup by the CTISYS resource.

The CALLED and CALLING numbers are stored in the LCST - Last Calling number Service Table.

The operating principle of LCS:

When we make an outgoing call the CTI Router verifies the LCS parameter:
- If the LCS parameter is disabled the LCS is ignored.
- If the LCS parameter is enabled, then the CTI router verifies if for Destination resource (OUT parameter) is configured the LCSG (Last Calling number Service Group) parameter. The checked parameter is dependent on the type of resource:
  - LCS-GROUP parameter for CTI ports (except POTS and VPOTS);
  - LCS-GROUP parameter for CTI clusters;
  - SIP-LCS-GROUP parameter for SIP users;
  - IAX-LCS-GROUP parameter for IAX users.
The LCS verify on the specified LCSG if there aren't any restrictions for the CALLED number (the CB-PERMIT-CD parameter) and save the CALLED number and the CALLING number in the LCST - Last Calling number Service Table.
The numbers are stored in the LCS table for a specified time (The TOUT parameter). This time can be specified in the LCST (Last Calling number Service records Timeout) parameters of CTIR routing.
Note
The value Sys of the LCST parameter of CTI routing means the default value and will be the one setup by the CTISYS resource.
When later we will receive an incoming call from the same port, where is configured the LCSG, the LCS verify if the CALLING number is present on the LCS table and put in the CALLED number the previously CALLING number.
The CTI router forward the call to the new CALLED number.

	Note
The value `Sys` of the LCST parameter of CTI routing means the default value and will be the one setup by the CTISYS resource.

	Tip
Interesting chapters: Section 75.18, “How to configure Last Calling Service”; Section 15.3, “Last Calling Service for UMTSBOX”; Section 52.5.6, “Last Calling Service for a SIP user”.

Tip

Interesting chapters:

Section 75.18, “How to configure Last Calling Service”;

Section 15.3, “Last Calling Service for UMTSBOX”;

Section 52.5.6, “Last Calling Service for a SIP user”.

49.8.1. LCSG - Last Calling number Service Group

LCSG is useful to manage LCS groups. The managing is made following the classic Abilis sintax: a/c/s/d lcsg <parameter:parameter>.

LCSG configuration holds all the rules required to manipulate the TON for CD and CG.

[08:14:51] ABILIS_CPX:a lcsg id:1 descr:GSM_LCS 

COMMAND EXECUTED 

[08:15:28] ABILIS_CPX:d lcsg                 

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
----+--------------------------------------------------------------------------
ID: |[DESCR:]
    |CPS-LIST:              NAT-PREFIX:            INT-PREFIX:    COUNTRY-CODE:
    |CB-PERMIT-CD:
    |CB-UNK-CDO:            CB-NAT-CDO:            CB-INT-CDO:
    |CB-SDO:                CB-SGO:                CB-CDO-DFT:
    |[CTI Ports, CTI Clusters, IAX users, SIP users]
----+--------------------------------------------------------------------------
 1   [GSM_LCS]
     #                      SYS                    SYS            SYS   
     *
     ux'CALLING'            ux0'CALLING'           ux00'CALLING'          
     *                      *                      *                      
----+--------------------------------------------------------------------------

	Warning
	To activate the changes made on the LCSG, execute the initialization command init ctisys. Remember to save the configuration (save conf).

	Important
	Remember to set the LCS parameter to YES in the CTI routing (the one which routes calls to UMTSBOX).

	Tip
Interesting chapters: Section 75.18, “How to configure Last Calling Service”; Section 15.3, “Last Calling Service for UMTSBOX”; Section 52.5.6, “Last Calling Service for a SIP user”.

Tip

Interesting chapters:

Section 75.18, “How to configure Last Calling Service”;

Section 15.3, “Last Calling Service for UMTSBOX”;

Section 52.5.6, “Last Calling Service for a SIP user”.

Meaning of the most important parameters:

ID: Last Calling Number Service group identifier [1..32].
CPS-LIST: Name of an IN list holding Carrier Preselection prefixes or "#".
NAT-PREFIX: National prefix. From 1 up to 6 digits (E.g. 0) or "SYS".
INT-PREFIX: International prefix. From 1 up to 6 digits (E.g. 00) or "SYS".
COUNTRY-CODE: Country code. From 1 up to 6 digits (E.g. 39) or "SYS".
CB-PERMIT-CD: Permitted called numbers/prefixes for the back call. From 1 up to 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 a list between single quotes. The '*' is allowed only alone or as the last character. (E.g. ne1234567 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.
CB-UNK-CDO: Call Back number for UNKNOWN type CALLING. "#" 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'. (E.g. CALLING or ne1234567 or ux'CALLING' or ux11'CALLING.S2') See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.
CB-NAT-CDO: Call Back number for NATIONAL type CALLING. "#" 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'. (E.g. CALLING or ne1234567 or ux'CALLING' or ux11'CALLING.S2') See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.
CB-INT-CDO: Call Back number for INTERNATIONAL type CALLING. "#" 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'. (E.g. CALLING or ne1234567 or ux'CALLING' or ux11'CALLING.S2') See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.
CB-SDO: Call Back called sub-address [AlphaNumExt, #, *] (E.g.: *, A123, #) See HELP ISDN VALUES for details on meaning of special values.
CB-SGO: Call Back calling sub-address [AlphaNumExt, #, *] (E.g.: *, A123, #) See HELP ISDN VALUES for details on meaning of special values.
CB-CDO-DFT: Default call back number. "*" 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. See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

49.8.2. LCST - Last Calling number Service Table

LCS automatically stores the pair of calling and called numbers in the LCST. The table can be also manipulated with the d/a/c lcst commands.

[10:40:02] ABILIS_CPX:d lcst

-----+----------------------+----------------------+---------------------+-----
Group|        Called        |       Calling        |   Updated on (UTC)  |Tout
     |                      |                      |  [Expiry on (UTC)]  |
-----+----------------------+----------------------+---------------------+-----
1     ux12345678             ux01                   16/05/2015 16:02:59   6
                                                    16/05/2015 22:02:59
-----+----------------------+----------------------+---------------------+-----
1     ux99999999             ux02                   16/05/2015 16:03:20   NONE
-----+----------------------+----------------------+---------------------+-----

	Tip
Interesting chapters: Section 75.18, “How to configure Last Calling Service”; Section 15.3, “Last Calling Service for UMTSBOX”; Section 52.5.6, “Last Calling Service for a SIP user”.

Tip

Interesting chapters:

Section 75.18, “How to configure Last Calling Service”;

Section 15.3, “Last Calling Service for UMTSBOX”;

Section 52.5.6, “Last Calling Service for a SIP user”.

Meaning of the most important parameters:

GROUP

Last Calling number service group identifier [1..32].

CD

Called number.

CG

Calling number

Updated on

Addition/update UTC date and time.

Expiry on

Expiration UTC date and time.

	Caution
	Only for `TOUT` not equal to `NONE`.

TOUT

Entry expiration timeout [NONE, 1..999 hour].


49.7. Redirecting		49.9. CPO - Call path optimization