Table of Contents
List of Examples
start parameterend parametercall_obj_get usagecall_obj_free usagecall_obj.free usagecall_obj.stats usagecall_obj.free_all usagecall_obj.list usageTable of Contents
This module provides a way to identify calls using an increasing sequence of integers.
It starts assigning an integer to a call. Next call gets next free integer in a ring. When a call finishes its assigned number shall be freed.
First number to assign when no number has been assigned yet.
This parameter has no default value. Not setting it raises an error.
Its value shall be greater than zero.
Get next free number. reply_number parameter is a variable where function will store result in string format.
Example 1.3. call_obj_get usage
...
if (call_obj_get("$dlg_var(x)")) {
xlog("Object: $dlg_var(x)\n");
}
...
Mark an object_number as free, so it can be assigned again. This number will not be readily assigned until a loop in the ring has completed. object_number shall be provided in string format.
Example 1.4. call_obj_free usage
...
$dlg_var(y) = "27";
if (call_obj_free("$dlg_var(y)")) {
xlog("object $dlg_var(y) freed OK\n");
}
...
Free an object.
Parameter is a number represented in string format.
Name: call_obj.free
Parameters: object_number
Return some statistics about call_obj module.
It currently returns:
Start: Number of first object
End: Number of last object in range
Total: Total assignable objects
Assigned: Number of currently assigned objects
Name: call_obj.stats
Parameters: none
Make all objects free at once.
Name: call_obj.free_all
Parameters: none
List all active calls which duration is longer than a value in seconds.
Name: call_obj.list
Parameters: duration limit
limit parameter is optional
Example 1.8. call_obj.list usage
... Show every call which duration is less than or equal to 24 seconds: kamcmd call_obj.list 24 Same but limit output to at most 5 calls: kamcmd call_obj.list 24 5 Same but show again all calls (0 means no limit): kamcmd call_obj.list 24 0 ...