%docentities; ]>

This modules provides transaction storage for the &kamailioname;. It stores in an internal table transactions for an user and add branches to them if new contacts are added. For each message, the modules stores Request-URI (R-URI), &uri; and the internal transaction index and label. When the transaction is destroyed (by the TM module, the transaction is removed from the module table.

The following modules must be loaded before this module: REGISTRAR--registrar module-- used to lookup for new contacts and update the dset for the r-uri. TM--transaction module-- used to send &sip; requests.

The following libraries or applications must be installed before running &kamailio; with this module: none.

The size of the hash table internally used to keep the transaction. A larger table is much faster but consumes more memory. The hash size must be a power of two, otherwise it will be rounded down to the nearest power of two. Default value is 2048. ... modparam("tsilo", "hash_size", 1024) ...

The method stores r-uri, tindex and tlabel of the current transaction. This function can be used from REQUEST_ROUTE, FAILURE_ROUTE. ... if (is_method("INVITE")) { if (t_newtran()) { ts_store(); } } ...

The method add branches to all the stored transactions for the &sip; ruri passed as parameter, performing a contact lookup on the table specified by the domain parameter. The method should be called when a REGISTER request is received. Meaning of the parameters is as follows: domain - Name of table that should be used for looking up new contacts for r-uri. ruri - The r-uri for which we want to check existing transactions and add them new branches. Can be a static string value or a dynamic string with pseudo-variables. This function can be used from REQUEST_ROUTE, FAILURE_ROUTE. ... if (is_method("REGISTER")) { ts_append("location", "$tu"); } ...

The method add branches to the transaction identified by tindex and tlabel, performing a contacts lookup on the table specified by the domain parameter. The method should be called when a REGISTER request is received. Meaning of the parameters is as follows: tindex - internal index of transaction. Can be an integer or a pseudo-variable. tlabel - internal label of transaction. Can be an integer or a pseudo-variable. domain - Name of table that should be used for looking up new contacts for r-uri. This function can be used from REQUEST_ROUTE, FAILURE_ROUTE. ... if (is_method("REGISTER")) { $var(tindex) = ... $var(tlabel) = ... ts_append_to("$var(tindex)", "$var(tlabel", "location"); } ...