<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!-- Include general documentation entities -->
<!ENTITY % docentities SYSTEM "../../../../doc/docbook/entities.xml">
%docentities;
]>
<!-- Module User's Guide -->
<chapter>
  <title>&adminguide;</title>

  <section>
    <title>Overview</title>
	<para>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.</para>
  </section>
  <section>
    <title>Dependencies</title>
    <section>
      <title>&kamailio; Modules</title>
      <para>The following modules must be loaded before this module:
      <itemizedlist>
          <listitem>
            <para><emphasis>TM</emphasis></para>
          </listitem>
          <listitem>
            <para><emphasis>Presence</emphasis></para>
          </listitem>
          <listitem>
            <para><emphasis>IMS dialog</emphasis></para>
          </listitem>
        </itemizedlist>
      </para>
    </section>
  </section>
  <section>
    <title>Parameters</title>
    <section id="ims_usrloc_scscf.p.db_url">
      <title><varname>db_url</varname> (string)</title>
      <para>database <acronym>URL</acronym> for storing impu/contacts records</para>
      <example>
        <title>Set <varname>db_url</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "db_url", "mysql//username:password@localhost/scscf")
...
</programlisting>
      </example>
    </section>

    <section id="ims_usrloc_scscf.p.db_mode">
      <title><varname>db_mode</varname> (string)</title>
	  <para>This is the database mode to be used for the SCSCF usrloc data persistent
	  storage. Currently this module supports the Write-Back scheme only.</para>
      <itemizedlist>
  		<listitem>
  			<para>
  			0 - This disables database completely. Only memory will be used.
  			Contacts will not survive restart.
  			</para>
  		</listitem>
  		<listitem>
  			<para>
				1 - Write-Backend scheme. All changes are made to memory and database
				synchronization is done in the timer
  			</para>
  		</listitem>
  		</itemizedlist>
      <para><emphasis> Default value is 0. </emphasis></para>
      <example>
        <title>Set <varname>db_mode</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "db_mode", 1)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.maxcontact">
      <title>maxcontact (int)</title>
      <para>The parameter can be used to limit the number of contact for each impu</para>
      <para><emphasis>Default value is 0(max)</emphasis></para>
      <example>
        <title>Set <varname>maxcontact</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "maxcontact", 10)
...
</programlisting>
       </example>
    </section>
    <section id="ims_usrloc_scscf.p.maxcontact_3gpp">
      <title>maxcontact_3gpp (int)</title>
      <para>The parameter can be used to limit the number of 3GPP contact for each impu</para>
      <para><emphasis> Default value is 0.(max) </emphasis></para>
      <example>
        <title>Set <varname>maxcontact_3gpp</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "maxcontact_3gpp", 0)
...
</programlisting>
       </example>
    </section>
    <section id="ims_usrloc_scscf.p.maxcontact_behaviour">
      <title>maxcontact_behaviour (int)</title>
      <para>Behaviour of usrloc , after impu reach max contacts limit.</para>
      <itemizedlist>
  		<listitem>
  			<para>
  			0 - Disabled
  			</para>
  		</listitem>
  		<listitem>
  			<para>
  			1 - Reject after reaching limit.
  			</para>
  		</listitem>
      <listitem>
  			<para>
  			2 - Overwrite
  			</para>
  		</listitem>
  		</itemizedlist>
      <para><emphasis> Default value is 0. </emphasis></para>
      <example>
        <title>Set <varname>maxcontact_behaviour</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "maxcontact_behaviour", 2)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.max_subscribes">
      <title>max_subscribes(int)</title>
      <para>Max number of subscribes allowed per watcher for each IMPU </para>
      <para><emphasis> Default value is 0. </emphasis></para>
      <example>
        <title>Set <varname>max_subscribes</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "max_subscribes", 2)
...
</programlisting>
      </example>
     </section>
    <section id="ims_usrloc_scscf.p.sub_dialog_hash_size">
      <title>sub_dialog_hash_size(int)</title>
      <para>Subscriber dialog hash table size</para>
      <para><emphasis> Default value is 10. </emphasis></para>
      <example>
        <title>Set <varname>sub_dialog_hash_size</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "sub_dialog_hash_size", 512)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.timer_procs">
      <title>timer_procs(int)</title>
      <para>process number of handling registeration </para>
      <para><emphasis> Default value is 0 </emphasis></para>
      <example>
        <title>Set <varname>timer_procs</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "timer_procs", 5)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.timer_interval">
      <title>timer_interval (int)</title>
      <para>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</para>
      <para><emphasis> Default value is 90  </emphasis></para>
      <example>
        <title>Set <varname>timer_interval</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "timer_interval", 120)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.desc_time_order">
      <title>desc_time_order (int)</title>
	  <para>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.</para>
      <para><emphasis> Default value is timestamp ordering not enabled  </emphasis></para>
      <example>
        <title>Set <varname>desc_time_order</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "desc_time_order", 1)
...
        </programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.matching_mode">
      <title>matching_mode (int)</title>
      <para>What contact matching algorithm to be used.</para>
      <itemizedlist>
  		<listitem>
  			<para>
  			0 - Contact Only matching
  			</para>
  		</listitem>
  		<listitem>
  			<para>
  			1 - Contact and Callid Matching
  			</para>
  		</listitem>
      <listitem>
  			<para>
  			2 - Contact and Path header matching
  			</para>
  		</listitem>
      <listitem>
        <para>
        3 - Only contact IP and Port Matching
        </para>
      </listitem>
  		</itemizedlist>
      <para><emphasis> Default value is 0. </emphasis></para>
      <example>
        <title>Set <varname>matching_mode</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "matching_mode", 0)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.cseq_delay">
      <title>cseq_delay (int)</title>
      <para>Delay (in seconds) for accepting as retransmissions register requests with same Call-ID and Cseq.</para>
      <para><emphasis> Default value is 20. </emphasis></para>
      <example>
        <title>Set <varname>cseq_delay</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "cseq_delay", 20)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.fetch_rows">
      <title>fetch_rows(int)</title>
      <para>The number of the rows to be fetched at once from database when loading the location records.</para>
      <para><emphasis> Default value is 2000. </emphasis></para>
      <example>
        <title>Set <varname>fetch_rows</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "fetch_rows", 3000)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.hash_size">
      <title>hash_size (int)</title>
      <para>The number of entries of the hash table used by usrloc </para>
      <para><emphasis> Default value 512</emphasis></para>
      <example>
        <title>Set <varname>hash_size</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "hash_size", 512)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.subs_hash_size">
      <title>subs_hash_size (int)</title>
      <para>The number of entries of the hash table used by usrloc to store the ims subscribe records</para>
      <para><emphasis> Default value 512</emphasis></para>
      <example>
        <title>Set <varname>subs_hash_size</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "subs_hash_size", 512)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.contacts_hash_size">
      <title>contacts_hash_size (integer)</title>
      <para>The number of entries of the hash table used by usrloc to store the contact records</para>
      <para><emphasis> Default value is 512</emphasis></para>
      <example>
        <title>Set <varname>contacts_hash_size</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "contacts_hash_size", 512)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.nat_bflag">
      <title>nat_bflag (integer)</title>
      <para>NAT marker to handle natted registration</para>
      <para><emphasis> Default value is 0 </emphasis></para>
      <example>
        <title>Set <varname>nat_bflag</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "nat_bflag", 3)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.contact_delete_delay">
      <title>contact_delete_delay (int)</title>
      <para>If contact is put into delay delete state, this is how long we delay before deleting </para>
      <para><emphasis> Default value is 30</emphasis></para>
      <example>
        <title>Set <varname>contact_delete_delay</varname>parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "contact_delete_delay", 32)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.support_wildcardPSI">
      <title>support_wildcardPSI (int)</title>
      <para>Wildcard Public-Service-Identity (RFC5002). it will be actived by setting  1  </para>
      <para><emphasis> Default value is 0.(disabled) </emphasis></para>
      <example>
        <title>Set <varname>support_wildcardPSI</varname> parameter</title>
        <programlisting format="linespecific">
        modparam("ims_usrloc_scscf", "support_wildcardPSI", 0)
        </programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.unreg_validity">
      <title>unreg_validity (int)</title>
      <para>Default validity time in seconds for unregister assignment to SCSCF </para>
      <para><emphasis> Default value is 1800 </emphasis></para>
      <example>
        <title>Set <varname>unreg_validity</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "unreg_validity", 0)
...
</programlisting>
      </example>
    </section>
    <section id="ims_usrloc_scscf.p.user_data_xsd">
      <title>user_data_xsd (string)</title>
      <para> </para>
      <para><emphasis> Default value is 1800 </emphasis></para>
      <example>
        <title>Set <varname>unreg_validity</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "user_data_xsd", "/usr/local/etc/kamailio/CxDataType_Rel6.xsd")
...
</programlisting>
      </example>
    </section>

    <section id="ims_usrloc_scscf.p.realm">
      <title>realm (string)</title>
      <para> </para>
      <para><emphasis> Default value is NULL </emphasis></para>
      <example>
        <title>Set <varname>realm</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "realm", "kamailio-ims.org")
...
</programlisting>
      </example>
    </section>

    <section id="ims_usrloc_scscf.p.skip_realm">
      <title>skip_realm (int)</title>
      <para>Skipping defined network name in the <varname>realm</varname> for NOTIFY's Message body reginfo tag. </para>
      <para><emphasis> Default value is 0 </emphasis></para>
      <example>
        <title>Set <varname>skip_realm</varname> parameter</title>
        <programlisting format="linespecific">
...
        modparam("ims_usrloc_scscf", "skip_realm", 1)
...
</programlisting>
      </example>
    </section>
  </section>

  <section>
    <title>RPC Commands</title>
    <para>Exported RPC commands.</para>
    <section id="ims_usrloc_scscf.r.status">
      <title>ulscscf.status</title>
      <para></para>
    </section>
    <section id="ims_usrloc_scscf.r.showimpu">
      <title>ulscscf.showimpu</title>
      <para></para>
    </section>
    <section id="ims_usrloc_scscf.r.snapshot">
      <title>ulscscf.snapshot</title>
      <para></para>
    </section>
  </section>
</chapter>
