197
D14049.04
JULY 2008
Grey Headline (continued)
TANDBERG VIDEO COMMUNICATIONS SERVER
ADMINISTRATOR GUIDE
Introduction Getting Started
Overview and
Status
System
Conguration
VCS
Conguration
Zones and
Neighbors
Call
Processing
Bandwidth
Control
Firewall
Traversal
Appendices
Applications Maintenance
CPL Reference
The VCS does not currently support some elements that are
described in the CPL RFC. If an attempt is made to upload a
script containing any of the following elements an error message
will be generated and the VCS will continue to use its existing
policy.
The following elements are not currently supported:
time-switch
•
string-switch
•
language-switch
•
priority-switch
•
redirect
•
mail
•
log
•
subaction
•
lookup
•
remove-location
•
As the CPL script is evaluated it maintains a list of addresses (H.323 IDs, URLs and E.164 numbers) which will be used as the
destination of the call if a proxy node is executed. The location node allows the location set to be modied so that calls can be
redirected to different destinations.
At the start of script execution the location set is initialized to empty for incoming calls and to the original destination for outgoing
calls.
The following attributes are supported on location nodes. It supports the use of Regular Expressions (see the Regular Expression
Reference for further information).
Clear = "yes" | "no"
Species whether to clear the current location set before adding
the new location. The default is to append this location to the
end of the set.
url=string
The new location to be added to the location set. The given
string can specify a URL (e.g. user@domain.com), H.323 ID or an
E.164 number.
priority=<0.0..1.0> | "random"
Specied either as a oating point number in the range 0.0 to
1.0, or random, which assigns a random number within the
same range. 1.0 is the highest priority. Locations with the
same priority are searched in parallel.
regex="<regular expression>" replace="<string>"
Species the way in which a location matching the regular
expression is to be changed.
location
On executing a proxy node the VCS will attempt to forward the
call to the locations specied in the current location set. If
multiple entries are in the location set then this results in a
forked call. If the current location set is empty the call will be
forwarded to its original destination.
proxy
reject
If a reject node is executed the VCS stops any further script
processing and rejects the current call. The custom reject
strings status=string and reason=string options are
supported here.
rule-switch
This extension to CPL is provided to simplify administrator policy scripts that need to make decisions based on both the source and
destination of the call. A rule-switch may contain any number of rules that are tested in sequence; as soon as a match is found the
CPL within that rule element is executed. Each rule must take one of the following forms:
<rule origin="<regular expression>" destination="<regular expression">
<rule authenticated-origin="<regular expression>" destination="<regular expression">
<rule unauthenticated-origin="<regular expression>" destination="<regular expression">
<rule registered-origin="<regular expression>" destination="<regular expression">
<rule originating-user="<regular expression>" destination="<regular expression">
<rule originating-zone="<regular expression>" destination="<regular expression">
The meaning of the various origin selectors is as described in the Field section.
Unsupported CPL Elements