15.3. Last Calling Service for UMTSBOX

15.3. Last Calling Service for UMTSBOX
	Chapter 15. UMTS BOX

The Last Calling Service is useful to route a call received by a SIM inserted in UMTS BOX, toward the last number which called the calling number.

	Warning
	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 CTIP: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 call is automatically routed toward CTIP 101 (number 200).

Suppose we have a UMTSBOX with port CTIP:501 with the following configuration:

[13:25:57] ABILIS_CPX:d p ctipe:501

CTIP:501 DESCR:SIM_320654321
Act     card:CELL32-1<1>                USER:#
Run     OPSTATE:UP        LOG:DS                               TYPE:NET-PUBLIC
        signalling:CELL                 HOLD:NO      
        VOICE-ROAMING:DISABLED     
        NUM:*                           ADDRBOOK-NUM:NUM
        CDO:#                           
        NET-MODE:AUTO     NET-SEL:AUTO       NET:
        PDN-MODE:AUTO     PDN-ROAMING:DISABLED
        PDN-APN:#
        HOLD-ENABLE-LIST:#                   DIAL-IN-LIST:#
        LOOP:NO           PIN:2112      GAIN-IN:SYS      CODEC-GAIN-IN:SYS
        DIALT:5           PIN2:#        GAIN-OUT:SYS     CODEC-GAIN-OUT:SYS
        LCS-GROUP:NONE    BUSY-NOCHAN:NO

It's necessary to create a LCSG (Last Calling number Service Group):

[13:26:47] ABILIS_CPX:a lcsg id:1 descr:UMTS_LCS

COMMAND EXECUTED 

[13:27:03] 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   [UMTS_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).

For the CTIP:501 is necessary to configure the LCS-GROUP parameter, where "1" is the ID:1 of LCSG.

[13:30:27] ABILIS_CPX:s p ctip:501 lcs-group:1

COMMAND EXECUTED

[13:30:44] ABILIS_CPX:d p ctipe:501

CTIP:501 - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:SIM_320654321
Run     card:CELL32-1<1>                USER:#
        OPSTATE:UP        LOG:DS                               TYPE:NET-PUBLIC
        signalling:CELL                 HOLD:NO      
        VOICE-ROAMING:DISABLED     
        NUM:*                           ADDRBOOK-NUM:NUM
        CDO:#                           
        NET-MODE:AUTO     NET-SEL:AUTO       NET:
        PDN-MODE:AUTO     PDN-ROAMING:DISABLED
        PDN-APN:unite.internet.md
        HOLD-ENABLE-LIST:#                   DIAL-IN-LIST:#
        LOOP:NO           PIN:2112      GAIN-IN:SYS      CODEC-GAIN-IN:SYS
        DIALT:5           PIN2:#        GAIN-OUT:SYS     CODEC-GAIN-OUT:SYS
        LCS-GROUP:1       BUSY-NOCHAN:NO

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

After configuration of the CTIP:501 the LCSG group will be shown in the following way:

[13:31:07] ABILIS_CPX:d lcsg

----+--------------------------------------------------------------------------
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   [UMTS_LCS]
     #                      SYS                    SYS            SYS   
     *
     ux'CALLING'            ux0'CALLING'           ux00'CALLING'          
     *                      *                      *                      
     - CTI Ports --------------------------------------------------------------
     501                      
----+--------------------------------------------------------------------------

Purpose of example: calls arriving from the PBX are routed to UMTSBOX (CTIP:501), and calls arriving from UMTSBOX are sent to the PBX.

[13:32:28] ABILIS_CPX:a ctir pr:0 poi:pbx out:501 cdi:?* sp:64000 lcs:yes lcst:6 descr:From_PBX_to_UMTSBOX

COMMAND EXECUTED

[13:32:53] ABILIS_CPX:a ctir pr:1 poi:501 out:pbx cdi:* sp:64000 descr:From_UMTSBOX_to_PBX

COMMAND EXECUTED

[13:33:00] ABILIS_CPX:d ctir

- Not Saved (SAVE CONF), Not Refreshed (INIT) ---------------------------------
Last change: 16/12/2015 09:05:16 EET

---+------+-----------------+---------+--------------------+--------------------
PR |[DESCR]
   |BCI   |POI |SR      |GI |OUT      |CDI                 |CDO
ACT|NEXT        |LAST       |EEC |T301|CGI                 |CGO
EDT|SP    |SC   |DJ   |MJ   |FMDJ|FMMJ|SDI                 |SDO
   |SPOUT |SCOUT|DJOUT|MJOUT|LCS |LCST|SGI                 |SGO
   |                        |BCO      |RGI                 |RGO
   |FMRLY |FAXSP|MODSP|FMLVL|ECM |UDT |IG  |OG  |SG        |DL  |DH
   |CODERS
   |CODERSOUT
   |TI1 .. TI5
--------------------------------------------------------------------------------
0   [From_PBX_to_UMTSBOX]
    VOICE  PBX  #        #   501       ?*                   *                   
    NO           ANY         NO   Dft  *                    *                   
    64000  Sys   Sys   Sys   Sys  Sys  *                    *                   
    *      *     *     *     YES  6    *                    *                   
--------------------------------------------------------------------------------
1   [From_UMTSBOX_to_PBX]
    VOICE  501  #        #   PBX       *                    *                   
    NO           ANY         NO   Dft  *                    *                   
    64000  Sys   Sys   Sys   Sys  Sys  *                    *                   
--------------------------------------------------------------------------------

	Important
	For routes towards SIP user is necessary to set the `LCS` parameter to `YES`, to activate the Last Calling Service. Another important parameter of CTIR routing is the LCST: Last Calling number Service records Timeout. The value `Sys` means the default value and will be the one setup by the CTISYS resource.

	Warning
	Changes made on the CTI routing table aren't immediately active. To activate them, execute the initialization command init ctir.

Type the following command to show the LCST entries.

[13:45:54] ABILIS_CPX:d lcst

-----+----------------------+----------------------+---------------------+-----
GROUP|          CD          |         CG           |   Updated on (UTC)  |TOUT
     |                      |                      |  [Expiry on (UTC)]  |
-----+----------------------+----------------------+---------------------+-----
                      *** NO LCS TABLE ENTRY DEFINED ***

The user 200 from CTIP:101 (number 200) make a call to 320123456. The PR:0 of CTIR router sends this call to UMTSBOX. The following is the log of call.

[15:51:30] ABILIS_CPX:start ldme

Current Local Time: Wednesday 22/12/2015 12:20:35 (UTC+2.00)

Start Debug Log content real-time logging (Type CTRL+C + ENTER to stop):

Date   Time   Resource   Ses   Id   Event          Parameters
------ ------ ---------- ----- ---- -------------- --------------------------------------
221215 121139 CtiP-101    1218 1218 E-DialRx       CH:1 BC:Speech CG:uxq200 USER:200
221215 121139 CtiP-101    1218 1218 E-CallRx       CH:1 BC:Speech CD:ux320123456 
                                                   CG:uxq200 USER:200
221215 121139 CtiP-101    1218 1218 E-Route Match  PR:1 
221215 121139 CtiP-501    1218 1218 E-CallTx       BC:Speech TY:TR CD:ux320123456 
                                                   CG:uxq200
221215 121139 CtiP-101    1218 1218 E-NumComplete  CDI:ux320123456 CDO:ux320123456
221215 121139 CtiP-501    1218 1218 E-ProgressRx   PI:81 88 
221215 121139 CtiP-101    1218 1218 E-ProgressTx   PI:81 88
221215 121146 CtiP-501    1218 1218 E-AlertRx      CH:1 PI: 81 88
221215 121146 CtiP-101    1218 1218 E-AlertTx      CH:1 PI: 81 88
221215 121155 CtiP-501    1218 1218 E-ConnRx       CH:1
221215 121155 CtiP-101    1218 1218 E-ConnTx       CH:1
221215 122125 CtiP-101    1218 1218 E-DiscRx       CH:1 CAUSE:80 90 (U, Normal call 
                                                   clearing) USER:200
221215 122125 CtiP-101    1218 1218 E-DiscConfTx   CH:0
221215 122125 CtiP-501    1218 1218 E-DiscTx       CH:1 CAUSE:80 90 (U, Normal call 
                                                   clearing)

After this call, type again the command to show the LCST entries. Now the LCST table contains entries.

[15:52:28] ABILIS_CPX:d lcst

-----+----------------------+----------------------+---------------------+-----
GROUP|          CD          |         CG           |   Updated on (UTC)  |TOUT
     |                      |                      |  [Expiry on (UTC)]  |
-----+----------------------+----------------------+---------------------+-----
1     ux320123456            ux200                  22/12/2015 11:21:25   6   
                                                    22/12/2015 17:21:25

	Note
	The LCST table entries expire after 6 hours (`TOUT` is equal with 6), because the LCST: Last Calling number Service records Timeout is equal to 6.

The phone 320123456 has received a call from 320654321. If the phone 320123456 makes a call to 320654321 the call is routed to number 200 (CTIP:101). The following is the log of call.

[15:54:20] ABILIS_CPX:start ldme

Current Local Time: Wednesday 22/12/2015 15:56:08 (UTC+2.00)

Start Debug Log content real-time logging (Type CTRL+C + ENTER to stop):

Date   Time   Resource   Ses   Id   Event          Parameters
------ ------ ---------- ----- ---- -------------- --------------------------------------
221215 155615 CtiP-501      95   95 E-CallRx       CH:85 BC:Speech CD:ue320654321 
                                                   CG:uxq320123456
221215 155615 CtiP-501      95   95 E-LCS          CD:ue320654321 CG:uxq320123456 
                                                   LCS-CD:ux200
221215 155615 CtiP-501      95   95 E-Route Match  PR:1  
221215 155615 CtiP-101      95   95 E-CallTx       BC:Speech TY:TR CD:ux200 
                                                   CG:uxq320123456
221215 155615 CtiP-501      95   95 E-NumComplete  CDI:ux200 CDO:ux200
221215 155615 CtiP-101      95   95 E-AlertRx      CH:1 USER:200
221215 155615 CtiP-501      95   95 E-AlertTx      CH:85 
221215 155630 CtiP-501      95   95 E-DiscRx       CH:85 CAUSE:80 90 (U, Normal call 
                                                   clearing)
221215 155630 CtiP-501      95   95 E-DiscConfTx   CH:85
221215 155630 CtiP-101      95   95 E-DiscTx       CH:1 CAUSE:80 90 (U, Normal call 
                                                   clearing) USER:200

	Tip
Interesting chapters: Section 49.8, “LCS - Last Calling number Service”; Section 75.18, “How to configure Last Calling Service”; Section 52.5.6, “Last Calling Service for a SIP user”; Section 49.10.5, “CTI Debug Log (START LDME)”.

Tip

Interesting chapters:

Section 49.8, “LCS - Last Calling number Service”;

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

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

Section 49.10.5, “CTI Debug Log (START LDME)”.


15.2. CTI Routing configuration		15.4. CTI GSM/UMTS/LTE ports diagnostics and statistics