Altering release cause - Revision history

Monica at 16:09, 31 October 2013

2013-10-31T16:09:49Z

Monica: /* Example */

2013-10-25T12:15:35Z

‎Example

Paulc: /* Example */

2013-09-09T15:37:49Z

‎Example

Paulc: Created page with "Yate provides a default mapping from the call release cause of the call leg that initiated the release. You may want to alter the release cause or to enforce specific mapping..."

2013-09-09T15:36:59Z

Created page with "Yate provides a default mapping from the call release cause of the call leg that initiated the release. You may want to alter the release cause or to enforce specific mapping..."

New page

Yate provides a default mapping from the call release cause of the call leg that initiated the release.

You may want to alter the release cause or to enforce specific mappings per protocol.

== Concept ==

When a call leg is released a cause code is received over the protocol or is generated locally in case of an error.

The peer of the hung up call leg gets disconnected. At this stage it sends a [[chan.disconnected]] message that can be used to prevent the call release or to alter the propagated release cause.

== Example ==

The following [[Javascript]] is an example of altering the release cause. The script can be placed in the share/scripts directory and be configured in javascript.conf
alter_cause=alter_release_cause.js

Content of a very simple script:
function onDisconnected(msg) {
if (msg.reason == "congestion")
msg.reason = "busy";
return false;
}

Message.install(onDisconnected,"chan.disconnected",80);

A more complex script:
function onDisconnected(msg) {
var newreason = false;
switch (msg.id) {
case /^sip\//:
// Cause propagated to SIP
switch (msg.lastpeerid) {
case /^sip\//:
// SIP to SIP
switch (msg.reason) {
case "noroute":
newreason = "congestion";
break;
case "rejected":
newreason = "forbidden";
break;
}
break;
}
break;
case /^h323/:
// Cause propagated to H.323
switch (msg.reason) {
case "congestion":
newreason = "busy";
break;
}
break;
}
if (newreason) {
Engine.debug(Engine.DebugInfo,"Changing end reason '" + msg.reason + "' to '" + newreason + "'");
msg.reason = newreason;
}
return false;
}

Message.install(onDisconnected,"chan.disconnected",80);

← Older revision		Revision as of 16:09, 31 October 2013
Line 64:		Line 64:

	Message.install(onDisconnected,"chan.disconnected",80);		Message.install(onDisconnected,"chan.disconnected",80);
		+
		+	[[Category:Javascript]] [[Category:Change reason]]

← Older revision		Revision as of 12:15, 25 October 2013
Line 12:		Line 12:

	The following [[Javascript]] is an example of altering the release cause. The script can be placed in the share/scripts directory and be configured in javascript.conf		The following [[Javascript]] is an example of altering the release cause. The script can be placed in the share/scripts directory and be configured in javascript.conf
		+
		+	In javascript.conf
		+
		+	[scripts]
	alter_cause=alter_release_cause.js		alter_cause=alter_release_cause.js

@@ Line 43: / Line 43: @@
+              }
               break;
-          case /^h323/:
+          case /^h323\//:
               // Cause propagated to H.323
               switch (msg.reason) {