181
D14049.05
February 2009
Grey Headline
(continued)
TANDBERG
VIDEO COMMUNICATIONS SERVER
ADMINISTRATOR GUIDE
Introduction
Getting started
Overview and
status
System
configuration
VCS
configuration
Zones and
neighbors
Call
processing
Bandwidth
control
Firewall
traversal
Appendices
Applications
Maintenance
CPL reference
Redirecting failed calls based on status code
The output from a
proxy
node allow actions to be taken based on the result of the proxy operation.
In base CPL a single failure output is allowed which will be invoked if the call attempt fails for any
reason (see section 6.1 of
RFC 3880 [5]
for details).
The VCS supports an extension to the base CPL specification that allows a status code to be
specified so that the failure action is only invoked if the call attempt fails for the specified reason.
In addition the VCS allows multiple failure outputs to be specified within a single
proxy
node. This
allows a script to redirect the call to different locations (e.g. different recorded messages) based on
the exact reason for call failure.
For example:
<?xml version="1.0" encoding="UTF-8" ?>
<cpl xmlns="urn:ietf:params:xml:ns:cpl"
xmlns:taa="http://www.tandberg.net/cpl-extensions"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:ietf:params:xml:ns:cpl cpl.xsd">
<taa:routed>
<!-- Proxy the call normally, but redirect to different recorded
messages based on -->
<!-- the particular error response we get -->
<proxy>
<failure status="403">
<!-- Call attempt failed with 403 (Forbidden) -->
<location url="[email protected]" clear="yes">
<proxy/>
</location>
</failure>
<failure status="404">
<!-- Call attempt failed with 404 (Not Found) -->
<location url="[email protected]" clear="yes">
<proxy/>
</location>
</failure>
<failure>
<!-- General catch-all failure handler for all other error
responses -->
<location url="[email protected]" clear="yes">
<proxy/>
</location>
</failure>
</proxy>
</taa:routed>
</cpl>
CPL examples
