The pre-search transform function allows you to modify the alias in an incoming search request.
The transformation is applied by the VCS before any searches take place, either locally or
to external zones. It applies to all incoming search requests received from locally registered
endpoints, neighbor, traversal client and traversal server zones, and endpoints on the public
internet. It does not apply to requests received from peers (which are configured identically and
therefore will have already applied the same transform).
Each pre-search transform defines a string against which an alias is compared, and the changes to
make to the alias if it matches that string.
After the alias has been transformed, it remains changed and all further call processing is applied
to the new alias.

Pre-search transforms are not applied to GRQ or RRQ messages received from endpoints
registering with the VCS; endpoints will be registered with the alias(es) as presented in
these messages.

Pre-search transforms are applied prior to any possible CPL modification and Zone
transforms.

All peers in a cluster should be configured identically, including any pre-search transforms. A
VCS in a cluster treats search requests from any of its peers as having come from its own
Local Zone, and does not re-apply any pre-search transforms on receipt of the request.

Pre-search transform process

Up to 100 pre-search transforms can be configured. Each transform must have a unique priority
number between 1 and 65534.
Every incoming alias is compared with each transform in order of priority, starting with that closest
to 1. If and when a match is made, the transform is applied to the alias and no further pre-search
checks and transformations of the new alias will take place. The new alias is then used for the
remainder of the

search process

Further transforms of the alias may take place during the remainder of the search process.
This may be as a result of

Call Policy

(also known as Administrator Policy) or User Policy (if

FindMe

is enabled). If this is the case, the pre-search transforms are re-applied to the new

alias. Refer to the

search process

diagram for more information.

If you add a new pre-search transform that has the same priority as an existing transform,
all transforms with a lower priority (those with a larger numerical value) will have their
priority incremented by one, and the new transform will be added with the specified priority.
However, if there are not enough “slots” left to move all the priorities down, you will get an
error message.

Pre-search transforms