TANDBERG D14049.04 manual 197, Location, Rule-switch, Reject, Unsupported CPL Elements

Grey Headline (continued)

CPL Reference

TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE

location proxy

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 modified 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"	Specifies 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"	Specified either as a floating 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>"	Specifies the way in which a location matching the regular
	expression is to be changed.

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-switchmay 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.

On executing a proxy node the VCS will attempt to forward the call to the locations specified 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.

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.

Unsupported CPL Elements

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

Introduction	Getting Started	Overview and	System	VCS	Zones and	Call	Bandwidth	Firewall	Applications	Maintenance	Appendices
		Status	Configuration	Configuration	Neighbors	Processing	Control	Traversal
D14049.04					197
JULY 2008