IMS Usrloc SCSCF Module

Jason Penton

Smile Communications

Edited by

Richard Good

Smile Communications

Yasin Caner

Table of Contents

1. Admin Guide
1. Overview
2. Dependencies
2.1. Kamailio Modules
3. Parameters
3.1. db_url (string)
3.2. db_mode (string)
3.3. maxcontact (int)
3.4. maxcontact_3gpp (int)
3.5. maxcontact_behaviour (int)
3.6. max_subscribes(int)
3.7. sub_dialog_hash_size(int)
3.8. timer_procs(int)
3.9. timer_interval (int)
3.10. desc_time_order (int)
3.11. matching_mode (int)
3.12. cseq_delay (int)
3.13. fetch_rows(int)
3.14. hash_size (string)
3.15. subs_hash_size (int)
3.16. contacts_hash_size (integer)
3.17. nat_bflag (integer)
3.18. contact_delete_delay (int)
3.19. support_wildcardPSI (int)
3.20. unreg_validity (int)
3.21. user_data_xsd (string)
4. RPC Commands
4.1. ulscscf.status
4.2. ulscscf.showimpu
4.3. ulscscf.snapshot
2. Frequently Asked Questions

List of Examples

1.1. Set db_url parameter
1.2. Set db_mode parameter
1.3. Set maxcontact parameter
1.4. Set maxcontact_3gpp parameter
1.5. Set maxcontact_behaviour parameter
1.6. Set subscription_expires_range parameter
1.7. Set sub_dialog_hash_size parameter
1.8. Set timer_procs parameter
1.9. Set timer_interval parameter
1.10. Set desc_time_order parameter
1.11. Set matching_mode parameter
1.12. Set cseq_delay parameter
1.13. Set fetch_rows parameter
1.14. Set hash_size parameter
1.15. Set subs_hash_size parameter
1.16. Set contacts_hash_size parameter
1.17. Set nat_bflag parameter
1.18. Set contact_delete_delay parameter
1.19. Set support_wildcardPSI parameter
1.20. Set unreg_validity parameter
1.21. Set unreg_validity parameter

Chapter 1. Admin Guide

1. Overview

This module serves as a storage engine for SCSCF contacts, much like the standard Kamailio module that is usrloc, is a storage engine for standard SIP contacts.

2. Dependencies

2.1. Kamailio Modules

The following modules must be loaded before this module:

  • TM

  • Presence

  • IMS dialog

3. Parameters

3.1. db_url (string)

database URL for storing impu/contacts records

Example 1.1. Set db_url parameter

        modparam("ims_usrloc_scscf", "db_url", "mysql//username:password@localhost/scscf")

3.2. db_mode (string)

This is the database mode to be used for the SCSCF usrloc data persistent storage. Currently this module supports the Write-Back scheme only.

  • 0 - This disables database completely. Only memory will be used. Contacts will not survive restart.

  • 1 - Write-Backend scheme. All changes are made to memory and database synchronization is done in the timer

Default value is 0.

Example 1.2. Set db_mode parameter

        modparam("ims_usrloc_scscf", "db_mode", 1)

3.3. maxcontact (int)

The parameter can be used to limit the number of contact for each impu

Default value is 0(max)

Example 1.3. Set maxcontact parameter

        modparam("ims_usrloc_scscf", "maxcontact", 10)

3.4. maxcontact_3gpp (int)

The parameter can be used to limit the number of 3GPP contact for each impu

Default value is 0.(max)

Example 1.4. Set maxcontact_3gpp parameter

        modparam("ims_usrloc_scscf", "maxcontact_3gpp", 0)

3.5. maxcontact_behaviour (int)

Behaviour of usrloc , after impu reach max contacts limit.

  • 0 - Disabled

  • 1 - Reject after reaching limit.

  • 2 - Overwrite

Default value is 0.

Example 1.5. Set maxcontact_behaviour parameter

        modparam("ims_usrloc_scscf", "maxcontact_behaviour", 2)

3.6. max_subscribes(int)

Max number of subscribes allowed per watcher for each IMPU

Default value is 0.

Example 1.6. Set subscription_expires_range parameter

        modparam("ims_usrloc_scscf", "max_subscribes", 2)

3.7. sub_dialog_hash_size(int)

Subscriber dialog hash table size

Default value is 10.

Example 1.7. Set sub_dialog_hash_size parameter

        modparam("ims_usrloc_scscf", "sub_dialog_hash_size", 512)

3.8. timer_procs(int)

process number of handling registeration

Default value is 0

Example 1.8. Set timer_procs parameter

        modparam("ims_usrloc_scscf", "timer_procs", 5)

3.9. timer_interval (int)

Number of seconds between two timer runs. The module uses a timer to delete expired contacts, synchronize with database and other tasks, that need to be run periodically

Default value is 90

Example 1.9. Set timer_interval parameter

        modparam("ims_usrloc_scscf", "timer_interval", 120)

3.10. desc_time_order (int)

If the user's contacts should be kept timestamp ordered; otherwise the contact will be ordered based on q value. Non 0 value means true.

Default value is timestamp ordering not enabled

Example 1.10. Set desc_time_order parameter

        modparam("ims_usrloc_scscf", "desc_time_order", 1)

3.11. matching_mode (int)

What contact matching algorithm to be used.

  • 0 - Contact Only matching

  • 1 - Contact and Callid Matching

  • 2 - Contact and Path header matching

  • 3 - Only contact IP and Port Matching

Default value is 0.

Example 1.11. Set matching_mode parameter

        modparam("ims_usrloc_scscf", "matching_mode", 0)

3.12. cseq_delay (int)

Delay (in seconds) for accepting as retransmissions register requests with same Call-ID and Cseq.

Default value is 20.

Example 1.12. Set cseq_delay parameter

        modparam("ims_usrloc_scscf", "cseq_delay", 20)

3.13. fetch_rows(int)

The number of the rows to be fetched at once from database when loading the location records.

Default value is 2000.

Example 1.13. Set fetch_rows parameter

        modparam("ims_usrloc_scscf", "fetch_rows", 3000)

3.14. hash_size (string)

The number of entries of the hash table used by usrloc

Default value 512

Example 1.14. Set hash_size parameter

        modparam("ims_usrloc_scscf", "hash_size", 512)

3.15. subs_hash_size (int)

The number of entries of the hash table used by usrloc to store the ims subscribe records

Default value 512

Example 1.15. Set subs_hash_size parameter

        modparam("ims_usrloc_scscf", "subs_hash_size", 512)

3.16. contacts_hash_size (integer)

The number of entries of the hash table used by usrloc to store the contact records

Default value is 512

Example 1.16. Set contacts_hash_size parameter

        modparam("ims_usrloc_scscf", "contacts_hash_size", 512)

3.17. nat_bflag (integer)

NAT marker to handle natted registration

Default value is 0

Example 1.17. Set nat_bflag parameter

        modparam("ims_usrloc_scscf", "nat_bflag", 3)

3.18. contact_delete_delay (int)

If contact is put into delay delete state ,this is how long we delay before deleting

Default value is 30

Example 1.18. Set contact_delete_delay parameter

        modparam("ims_usrloc_scscf", "contact_delete_delay", 32)

3.19. support_wildcardPSI (int)

Wildcard Public-Service-Identity (RFC5002). it will be actived by setting 1

Default value is 0.(disabled)

Example 1.19. Set support_wildcardPSI parameter

        modparam("ims_usrloc_scscf", "support_wildcardPSI", 0)

3.20. unreg_validity (int)

Default validity time in seconds for unregister assignment to SCSCF

Default value is 1800

Example 1.20. Set unreg_validity parameter

        modparam("ims_usrloc_scscf", "unreg_validity", 0)

3.21. user_data_xsd (string)

Default value is 1800

Example 1.21. Set unreg_validity parameter

        modparam("ims_usrloc_scscf", "user_data_xsd", "/usr/local/etc/kamailio/CxDataType_Rel6.xsd")

4. RPC Commands

Exported RPC commands.

4.1. ulscscf.status

4.2. ulscscf.showimpu

4.3. ulscscf.snapshot

Chapter 2. Frequently Asked Questions

2.1. Where can I find more about Kamailio?
2.2. Where can I post a question about this module?
2.3. How can I report a bug?


Where can I find more about Kamailio?

Take a look at


Where can I post a question about this module?

First at all check if your question was already answered on one of our mailing lists:

E-mails regarding any stable Kamailio release should be sent to and e-mails regarding development versions should be sent to .


How can I report a bug?

Please follow the guidelines provided at: